@amityco/ts-sdk 0.0.1-beta.27 → 0.0.1-beta.29

package/dist/index.esm.js

@@ -7,6 +7,60 @@ import HttpAgent, { HttpsAgent } from 'agentkeepalive';
 import io from 'socket.io-client';
 import nativeIdGenerator from 'react-native-uuid';
 
+const CommunityPostSettings = Object.freeze({
+    ONLY_ADMIN_CAN_POST: 'ONLY_ADMIN_CAN_POST',
+    ADMIN_REVIEW_POST_REQUIRED: 'ADMIN_REVIEW_POST_REQUIRED',
+    ANYONE_CAN_POST: 'ANYONE_CAN_POST',
+});
+const CommunityPostSettingMaps = Object.freeze({
+    ONLY_ADMIN_CAN_POST: {
+        needApprovalOnPostCreation: false,
+        onlyAdminCanPost: true,
+    },
+    ADMIN_REVIEW_POST_REQUIRED: {
+        needApprovalOnPostCreation: true,
+        onlyAdminCanPost: false,
+    },
+    ANYONE_CAN_POST: {
+        needApprovalOnPostCreation: false,
+        onlyAdminCanPost: false,
+    },
+});
+const DefaultCommunityPostSetting = 'ONLY_ADMIN_CAN_POST';
+
+const ContentFeedType = Object.freeze({
+    STORY: 'story',
+    CLIP: 'clip',
+    CHAT: 'chat',
+    POST: 'post',
+    MESSAGE: 'message',
+});
+
+const FileType = Object.freeze({
+    FILE: 'file',
+    IMAGE: 'image',
+    VIDEO: 'video',
+});
+const VideoResolution = Object.freeze({
+    '1080P': '1080p',
+    '720P': '720p',
+    '480P': '480p',
+    '360P': '360p',
+    ORIGINAL: 'original',
+});
+const VideoTranscodingStatus = Object.freeze({
+    UPLOADED: 'uploaded',
+    TRANSCODING: 'transcoding',
+    TRANSCODED: 'transcoded',
+    TRANSCODE_FAILED: 'transcodeFailed',
+});
+const VideoSize = Object.freeze({
+    LOW: 'low',
+    MEDIUM: 'medium',
+    HIGH: 'high',
+    ORIGINAL: 'original',
+});
+
 var _a$1;
 /* eslint-disable no-undef */
 const theGlobal = 
@@ -211,7 +265,7 @@ const CRITERIAS = {
     channel: ['channelId', 'rateLimit'],
     channelUsers: ['channelId', 'userId', 'membership'],
     message: ['messageId'],
-    community: ['communityId', 'onlyAdminCanPost'],
+    community: ['communityId', 'postSetting'],
     category: ['categoryId'],
     communityUsers: ['userId', 'communityId', 'communityMembership'],
     post: ['postId', 'feedId'],
@@ -354,7 +408,7 @@ const isFresh = (model, lifeSpan = 0) => {
  * This wrapper is necessary to create for optimistically calls
  *
  *
- * @param fn A compatible API function from the ts sdk
+ * @param func A compatible API function from the ts sdk
  * @param args The arguments to pass to the function passed as `fn`
  * @returns A wrapper containing both the function and its future arguments
  *
@@ -640,8 +694,9 @@ const WS_EVENTS = [
     'connect_error',
     'reconnect_error',
     'reconnect_failed',
+    'v3.channel.didCreate',
     'v3.channel.didUpdate',
-    'v3.channel.didUpdate',
+    'v3.channel.didDelete',
     'v3.channel.didJoin',
     'v3.channel.didLeave',
     'v3.channel.didAddUsers',
@@ -20141,6 +20196,29 @@ const createMqttTransport = (endpoint) => {
     };
 };
 
+/**
+ * ```js
+ * import { getFeedSettings } from '@amityco/ts-sdk'
+ * const feedSettings = await getFeedSettings()
+ * const postFeedSetting = feedSettings.post
+ * ```
+ *
+ * Fetches a {@link Amity.FeedSettings} object
+ *
+ * @returns A Promise of {@link Amity.FeedSettings} object
+ *
+ * @category Client API
+ * @async
+ */
+const getFeedSettings = async () => {
+    const client = getActiveClient();
+    const { data } = await client.http.get(`/api/v3/network-settings/feed-setting`);
+    return Object.fromEntries(data.feedSettings.map(({ feedType, contentSettings }) => {
+        return [feedType, contentSettings];
+    }));
+};
+
+const DEFAULT_DEBUG_SESSION = 'amity';
 /**
  * ```js
  * import { createClient } from '@amityco/ts-sdk'
@@ -20151,20 +20229,24 @@ const createMqttTransport = (endpoint) => {
  *
  * @param apiKey for the {@link Amity.Client} instance
  * @param apiRegion endpoint to connect to
+ * @param apiEndpoint custom endpoint in case you don't want to use a preset endpoint
  * @param debugSession session's identifier for the client's logger instance
  * @returns A {@link Amity.Client} instance
  *
  * @category Client API
  * */
-const createClient = (apiKey, apiRegion = API_REGIONS.SG, debugSession = 'amity') => {
+const createClient = (apiKey, apiRegion = API_REGIONS.SG, { debugSession = DEFAULT_DEBUG_SESSION, apiEndpoint, } = {}) => {
+    var _a, _b;
     const log = createLogger(debugSession);
     log('client/api/createClient', {
         apiKey: apiKey.replace(/.{5}$/g, 'xxxxx'),
         apiRegion,
     });
-    const http = createHttpTransport(computeUrl('http', apiRegion));
-    const ws = createWebsocketTransport(computeUrl('http', apiRegion));
-    const mqtt = createMqttTransport(computeUrl('mqtt', apiRegion));
+    const httpEndpoint = (_a = apiEndpoint === null || apiEndpoint === void 0 ? void 0 : apiEndpoint.http) !== null && _a !== void 0 ? _a : computeUrl('http', apiRegion);
+    const mqttEndpoint = (_b = apiEndpoint === null || apiEndpoint === void 0 ? void 0 : apiEndpoint.mqtt) !== null && _b !== void 0 ? _b : computeUrl('mqtt', apiRegion);
+    const http = createHttpTransport(httpEndpoint);
+    const ws = createWebsocketTransport(httpEndpoint);
+    const mqtt = createMqttTransport(mqttEndpoint);
     const emitter = createEventEmitter();
     const client = {
         version: `${VERSION$1}`,
@@ -20175,11 +20257,12 @@ const createClient = (apiKey, apiRegion = API_REGIONS.SG, debugSession = 'amity'
         mqtt,
         emitter,
         use: () => setActiveClient(client),
+        getFeedSettings,
     };
     try {
         getActiveClient();
     }
-    catch (_a) {
+    catch (_c) {
         setActiveClient(client);
     }
     return client;
@@ -20248,6 +20331,58 @@ const getDeviceInfo = () => {
     };
 };
 
+/**
+ * Ingest a payload (v3) into the cache
+ *
+ * @param payload a "backend v3" payload object
+ * @param order the order of the keys to process (in case of need)
+ *
+ * @category Cache
+ * @hidden
+ */
+const ingestInCache = (payload = {}, options) => {
+    Object.entries(payload).forEach(([key, models]) => {
+        const type = PAYLOAD2MODEL[key];
+        if (!type)
+            return;
+        const resolver = getResolver(type);
+        models.forEach(model => {
+            upsertInCache(
+            // eslint-disable @typescript-eslint no-explicit-any
+            [type, 'get', resolver(model)], // this 'any' cannot be avoided, sorry.
+            model, options);
+        });
+    });
+};
+
+const createUserEventSubscriber = (event, callback) => {
+    const client = getActiveClient();
+    const filter = (payload) => {
+        if (client.cache) {
+            ingestInCache(payload);
+        }
+        callback(payload.users[0]);
+    };
+    return createEventSubscriber(client, event, event, filter);
+};
+
+/**
+ * ```js
+ * import { onUserDeleted } from '@amityco/ts-sdk'
+ * const dispose = onUserDeleted(user => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when a {@link Amity.User} has been deleted
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category User Events
+ */
+const onUserDeleted = (callback) => createUserEventSubscriber('user.deleted', callback);
+
 /**
  * Retrieves a pair of {@link Amity.Tokens} necessary for connection
  *
@@ -20348,58 +20483,6 @@ const onClientBanned = (callback) => {
     });
 };
 
-/**
- * Ingest a payload (v3) into the cache
- *
- * @param payload a "backend v3" payload object
- * @param order the order of the keys to process (in case of need)
- *
- * @category Cache
- * @hidden
- */
-const ingestInCache = (payload = {}, options) => {
-    Object.entries(payload).forEach(([key, models]) => {
-        const type = PAYLOAD2MODEL[key];
-        if (!type)
-            return;
-        const resolver = getResolver(type);
-        models.forEach(model => {
-            upsertInCache(
-            // eslint-disable @typescript-eslint no-explicit-any
-            [type, 'get', resolver(model)], // this 'any' cannot be avoided, sorry.
-            model, options);
-        });
-    });
-};
-
-const createUserEventSubscriber = (event, callback) => {
-    const client = getActiveClient();
-    const filter = (payload) => {
-        if (client.cache) {
-            ingestInCache(payload);
-        }
-        callback(payload.users[0]);
-    };
-    return createEventSubscriber(client, event, event, filter);
-};
-
-/**
- * ```js
- * import { onUserDeleted } from '@amityco/ts-sdk'
- * const dispose = onUserDeleted(user => {
- *   // ...
- * })
- * ```
- *
- * Fired when a {@link Amity.User} has been deleted
- *
- * @param callback The function to call when the event was fired
- * @returns an {@link Amity.Unsubscriber} function to stop listening
- *
- * @category User Events
- */
-const onUserDeleted = (callback) => createUserEventSubscriber('user.deleted', callback);
-
 /* eslint-disable no-param-reassign */
 /**
  * ```js
@@ -20967,17 +21050,21 @@ const fileUrlWithSize = (fileUrl, size) => {
  * Creates an {@link Amity.File<'video'>}
  *
  * @param formData The data necessary to create a new {@link Amity.File<'video'>}
+ * @param feedType The {@link Amity.File<'video'>} feed type
  * @param onProgress The callback to track the upload progress
  * @returns The newly created {@link Amity.File<'video'>}
  *
  * @category File API
  * @async
  */
-const createVideo = async (formData, onProgress) => {
+const createVideo = async (formData, feedType, onProgress) => {
     const client = getActiveClient();
     client.log('file/createVideo', formData);
     if (!formData.getAll('files').length)
         throw new Error('The formData object must have a `files` key.');
+    if (feedType) {
+        formData.append('feedType', feedType);
+    }
     const headers = 'getHeaders' in formData
         ? formData.getHeaders()
         : { 'content-type': 'multipart/form-data' };
@@ -21860,6 +21947,33 @@ const updatePost = async (postId, patch) => {
     };
 };
 
+const getMatchPostSetting = (value) => {
+    var _a;
+    return (_a = Object.keys(CommunityPostSettingMaps).find(key => value.needApprovalOnPostCreation ===
+        CommunityPostSettingMaps[key].needApprovalOnPostCreation &&
+        value.onlyAdminCanPost === CommunityPostSettingMaps[key].onlyAdminCanPost)) !== null && _a !== void 0 ? _a : DefaultCommunityPostSetting;
+};
+/*
+ * Unpack community payload by mapping payload field to postSetting value.
+ */
+const unpackCommunityPayload = (_a) => {
+    var { communities } = _a, restPayload = __rest(_a, ["communities"]);
+    return (Object.assign({ communities: communities.map((_a) => {
+            var { needApprovalOnPostCreation, onlyAdminCanPost } = _a, restCommunityPayload = __rest(_a, ["needApprovalOnPostCreation", "onlyAdminCanPost"]);
+            return (Object.assign({ postSetting: getMatchPostSetting({
+                    needApprovalOnPostCreation,
+                    onlyAdminCanPost,
+                }) }, restCommunityPayload));
+        }) }, restPayload));
+};
+/*
+ * Repack community payload by mapping postSetting to the actual value.
+ */
+const packCommunityPayload = (_a) => {
+    var { postSetting = undefined } = _a, restParam = __rest(_a, ["postSetting"]);
+    return (Object.assign(Object.assign({}, restParam), (postSetting ? CommunityPostSettingMaps[postSetting] : undefined)));
+};
+
 /**
  * ```js
  * import { queryCommunities } from '@amityco/ts-sdk'
@@ -21889,10 +22003,11 @@ const queryCommunities = async (query) => {
             } }),
     });
     const { paging } = data, payload = __rest(data, ["paging"]);
-    const { communities } = payload;
+    const unpackedPayload = unpackCommunityPayload(payload);
+    const { communities } = unpackedPayload;
     const cachedAt = client.cache && Date.now();
     if (client.cache) {
-        ingestInCache(payload, { cachedAt });
+        ingestInCache(unpackedPayload, { cachedAt });
         const cacheKey = [
             'community',
             'query',
@@ -21941,9 +22056,10 @@ const getCommunities = async (communityIds) => {
     const client = getActiveClient();
     client.log('community/getCommunities', communityIds);
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/communities/list`, {
+    const { data: payload } = await client.http.get(`/api/v3/communities/list`, {
         params: { communityIds },
     });
+    const data = unpackCommunityPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -22002,7 +22118,8 @@ const getCommunity = async (communityId) => {
     const client = getActiveClient();
     client.log('community/getCommunity', communityId);
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/communities/${communityId}`);
+    const { data: payload } = await client.http.get(`/api/v3/communities/${communityId}`);
+    const data = unpackCommunityPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -22056,7 +22173,8 @@ getCommunity.locally = (communityId) => {
 const createCommunity = async (bundle) => {
     const client = getActiveClient();
     client.log('user/createCommunity', bundle);
-    const { data } = await client.http.post('/api/v3/communities/', bundle);
+    const { data: payload } = await client.http.post('/api/v3/communities/', packCommunityPayload(bundle));
+    const data = unpackCommunityPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -22086,7 +22204,8 @@ const createCommunity = async (bundle) => {
 const updateCommunity = async (communityId, patch) => {
     const client = getActiveClient();
     client.log('community/updateCommunity', communityId, patch);
-    const { data } = await client.http.put(`/api/v3/communities/${communityId}`, patch);
+    const { data: payload } = await client.http.put(`/api/v3/communities/${communityId}`, packCommunityPayload(patch));
+    const data = unpackCommunityPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -22352,7 +22471,8 @@ const getTopTrendingCommunities = async (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 { data: payload } = await client.http.get(`/api/v3/communities/top-trending`, { params: { options: { limit } } });
+    const data = unpackCommunityPayload(payload);
     const { communities } = data;
     const cachedAt = client.cache && Date.now();
     if (client.cache) {
@@ -22414,8 +22534,9 @@ const getRecommendedCommunities = async (query) => {
     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 { data: payload } = await client.http.get<Amity.Response<CommunityPayload>>(
+    const { data: payload } = await client.http.get(`/api/v3/communities/recommended`, { params: { options: { limit } } });
+    const data = unpackCommunityPayload(payload);
     const { communities } = data;
     const cachedAt = client.cache && Date.now();
     if (client.cache) {
@@ -23751,7 +23872,8 @@ const onReactorRemoved = (referenceType, referenceId, callback) => {
 };
 
 const COLLECTION_DEFAULT_PAGINATION_LIMIT = 5;
-const COLLECTION_DEFAULT_CACHING_POLICY = 'cache_then_server';
+const COLLECTION_DEFAULT_CACHING_POLICY = 'cache_then_server';
+const ENABLE_CACHE_MESSAGE = 'For using Live Collection feature you need to enable Cache!';
 
 /**
  * ```js
@@ -23953,6 +24075,23 @@ const isReportedByMe = async (referenceType, referenceId) => {
     return (_b = result !== null && result !== void 0 ? result : isFlagByMe) !== null && _b !== void 0 ? _b : false;
 };
 
+/** @hidden */
+const prepareChannelPayload = (payload) => {
+    const client = getActiveClient();
+    const channels = 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 Object.assign(Object.assign({}, channel), { hasMention,
+            unreadCount });
+    });
+    return Object.assign(Object.assign({}, payload), { channels });
+};
+
 /**
  * ```js
  * import { queryChannels } from '@amityco/ts-sdk'
@@ -23976,16 +24115,17 @@ const queryChannels = async (query) => {
     // API-FIX: parameters should be querystring.
     // API-FIX: backend doesnt answer Amity.Response
     // const { data } = await client.http.get<Amity.Response<Amity.Paged<ChannelPayload>>>(
-    const { data } = await client.http.get(`/api/v3/channels`, {
+    const { data: queryPayload } = await client.http.get(`/api/v3/channels`, {
         params: Object.assign(Object.assign({}, params), { keyword: displayName, filter: membership, options: {
                 token: toToken(page, 'skiplimit'),
             } }),
     });
-    const { paging } = data, payload = __rest(data, ["paging"]);
-    const { channels } = payload;
+    const { paging } = queryPayload, payload = __rest(queryPayload, ["paging"]);
+    const data = prepareChannelPayload(payload);
+    const { channels } = data;
     const cachedAt = client.cache && Date.now();
     if (client.cache) {
-        ingestInCache(payload, { cachedAt });
+        ingestInCache(data, { cachedAt });
         const cacheKey = [
             'channel',
             'query',
@@ -24035,9 +24175,10 @@ const getChannels = async (channelIds) => {
     client.log('channel/getChannels', channelIds);
     const encodedChannelIds = channelIds.map(channelId => encodeURIComponent(channelId));
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/channels/list`, {
+    const { data: payload } = await client.http.get(`/api/v3/channels/list`, {
         params: { channelIds: encodedChannelIds },
     });
+    const data = prepareChannelPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -24096,7 +24237,8 @@ const getChannel = async (channelId) => {
     const client = getActiveClient();
     client.log('channel/getChannel', channelId);
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/channels/${encodeURIComponent(channelId)}`);
+    const { data: payload } = await client.http.get(`/api/v3/channels/${encodeURIComponent(channelId)}`);
+    const data = prepareChannelPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -24157,10 +24299,11 @@ const createChannel = async (bundle) => {
     else {
         payload = await client.http.post('/api/v3/channels', bundle);
     }
+    const data = prepareChannelPayload(payload.data);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
-        ingestInCache(payload.data, { cachedAt });
-    const { channels } = payload.data;
+        ingestInCache(data, { cachedAt });
+    const { channels } = data;
     return {
         data: channels[0],
         cachedAt,
@@ -24185,7 +24328,8 @@ const createChannel = async (bundle) => {
 const updateChannel = async (channelId, patch) => {
     const client = getActiveClient();
     client.log('channel/updateChannel', channelId, patch);
-    const { data } = await client.http.put(`/api/v3/channels/${encodeURIComponent(channelId)}`, patch);
+    const { data: payload } = await client.http.put(`/api/v3/channels/${encodeURIComponent(channelId)}`, patch);
+    const data = prepareChannelPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -24236,7 +24380,8 @@ const deleteChannel = async (channelId) => {
 const joinChannel = async (channelId) => {
     const client = getActiveClient();
     client.log('channel/joinChannel', channelId);
-    const { data } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/join`);
+    const { data: payload } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/join`);
+    const data = prepareChannelPayload(payload);
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -24260,7 +24405,8 @@ const joinChannel = async (channelId) => {
 const leaveChannel = async (channelId) => {
     const client = getActiveClient();
     client.log('channel/leaveChannel', channelId);
-    const { data } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/leave`);
+    const { data: payload } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/leave`);
+    const data = prepareChannelPayload(payload);
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -24285,16 +24431,17 @@ const queryChannelMembers = async (query) => {
     const client = getActiveClient();
     client.log('channel/queryChannelMembers', query);
     const _a = query !== null && query !== void 0 ? query : {}, { page, channelId } = _a, params = __rest(_a, ["page", "channelId"]);
-    const { data } = await client.http.get(`/api/v4/channels/${encodeURIComponent(channelId)}/users`, {
+    const { data: queryPayload } = await client.http.get(`/api/v4/channels/${encodeURIComponent(channelId)}/users`, {
         params: Object.assign(Object.assign({}, params), { options: {
                 token: toToken(page, 'skiplimit'),
             } }),
     });
-    const { paging } = data, payload = __rest(data, ["paging"]);
-    const { channelUsers } = payload;
+    const { paging } = queryPayload, payload = __rest(queryPayload, ["paging"]);
+    const data = prepareChannelPayload(payload);
+    const { channelUsers } = data;
     const cachedAt = client.cache && Date.now();
     if (client.cache) {
-        ingestInCache(payload);
+        ingestInCache(data);
     }
     const nextPage = toPage(paging.next);
     const prevPage = toPage(paging.previous);
@@ -24337,13 +24484,11 @@ queryChannelMembers.locally = (query) => {
 const addChannelMembers = async (channelId, userIds) => {
     const client = getActiveClient();
     client.log('channel/addChannelMembers', channelId, userIds);
-    const { data } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/users`, { channelId, userIds });
+    const { data: payload } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/users`, { channelId, userIds });
+    const data = prepareChannelPayload(payload);
     if (client.cache)
         ingestInCache(data);
-    fireEvent('v3.channel.didAddUsers', {
-        channels: data.channels,
-        channelUsers: data.channelUsers,
-    });
+    fireEvent('v3.channel.didAddUsers', data);
     const { channelUsers } = data;
     return !!channelUsers.find(channelUser => channelUser.channelId === channelId && channelUser.membership === 'member');
 };
@@ -24366,13 +24511,11 @@ const addChannelMembers = async (channelId, userIds) => {
 const removeChannelMembers = async (channelId, userIds) => {
     const client = getActiveClient();
     client.log('channel/removeChannelMembers', channelId, userIds);
-    const { data } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/users`, { data: { channelId, userIds } });
+    const { data: payload } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/users`, { data: { channelId, userIds } });
+    const data = prepareChannelPayload(payload);
     if (client.cache)
         ingestInCache(data);
-    fireEvent('v3.channel.didRemoveUsers', {
-        channels: data.channels,
-        channelUsers: data.channelUsers,
-    });
+    fireEvent('v3.channel.didRemoveUsers', data);
     const { channelUsers } = data;
     return !!channelUsers.find(channelUser => channelUser.channelId === channelId && channelUser.membership !== 'member');
 };
@@ -24396,7 +24539,8 @@ const removeChannelMembers = async (channelId, userIds) => {
 const addChannelMembersRole = async (channelId, roleId, userIds) => {
     const client = getActiveClient();
     client.log('channel/addChannelMembersRole', channelId, roleId, userIds);
-    const { data } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/users/roles`, { channelId, role: roleId, userIds });
+    const { data: payload } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/users/roles`, { channelId, role: roleId, userIds });
+    const data = prepareChannelPayload(payload);
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -24422,7 +24566,8 @@ const addChannelMembersRole = async (channelId, roleId, userIds) => {
 const removeChannelMembersRole = async (channelId, roleId, userIds) => {
     const client = getActiveClient();
     client.log('channel/removeChannelMembersRole', channelId, roleId, userIds);
-    const { data } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/users/roles`, { data: { channelId, role: roleId, userIds } });
+    const { data: payload } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/users/roles`, { data: { channelId, role: roleId, userIds } });
+    const data = prepareChannelPayload(payload);
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -24446,13 +24591,14 @@ const removeChannelMembersRole = async (channelId, roleId, userIds) => {
 const banChannelMembers = async (channelId, userIds) => {
     const client = getActiveClient();
     client.log('channel/banChannelMembers', { userIds, channelId });
-    const payload = await client.http.put(`/api/v3/channels/${channelId}/users/ban`, {
+    const { data: payload } = await client.http.put(`/api/v3/channels/${channelId}/users/ban`, {
         userIds,
     });
+    const data = prepareChannelPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
-        ingestInCache(payload.data, { cachedAt });
-    const { channelUsers } = payload.data;
+        ingestInCache(data, { cachedAt });
+    const { channelUsers } = data;
     return {
         data: channelUsers === null || channelUsers === void 0 ? void 0 : channelUsers.filter(user => user.membership === 'banned'),
         cachedAt,
@@ -24476,19 +24622,45 @@ const banChannelMembers = async (channelId, userIds) => {
 const unbanChannelMembers = async (channelId, userIds) => {
     const client = getActiveClient();
     client.log('channel/unbanChannelMembers', { userIds, channelId });
-    const payload = await client.http.put(`/api/v3/channels/${encodeURIComponent(channelId)}/users/unban`, {
+    const { data: payload } = await client.http.put(`/api/v3/channels/${encodeURIComponent(channelId)}/users/unban`, {
         userIds,
     });
+    const data = prepareChannelPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
-        ingestInCache(payload.data, { cachedAt });
-    const { channelUsers } = payload.data;
+        ingestInCache(data, { cachedAt });
+    const { channelUsers } = data;
     return {
         data: channelUsers === null || channelUsers === void 0 ? void 0 : channelUsers.filter(user => user.membership === 'member'),
         cachedAt,
     };
 };
 
+/**
+ * ```js
+ * import { onChannelCreated } from '@amityco/ts-sdk'
+ * const dispose = onChannelCreated(channel => {
+ *   // ...
+ * })
+ * ```
+ *
+ * Fired when any {@link Amity.Channel} have been created
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category Channel Events
+ */
+const onChannelCreated = (callback) => {
+    const client = getActiveClient();
+    const filter = (payload) => {
+        const data = prepareChannelPayload(payload);
+        ingestInCache(data);
+        callback(data.channels[0]);
+    };
+    return createEventSubscriber(client, 'onChannelCreated', 'v3.channel.didCreate', filter);
+};
+
 /**
  * ```js
  * import { onChannelUpdated } from '@amityco/ts-sdk'
@@ -24507,8 +24679,9 @@ const unbanChannelMembers = async (channelId, userIds) => {
 const onChannelUpdated = (callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
-        ingestInCache(payload);
-        callback(payload.channels[0]);
+        const data = prepareChannelPayload(payload);
+        ingestInCache(data);
+        callback(data.channels[0]);
     };
     return createEventSubscriber(client, 'onChannelUpdated', 'v3.channel.didUpdate', filter);
 };
@@ -24531,8 +24704,9 @@ const onChannelUpdated = (callback) => {
 const onChannelDeleted = (callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
-        ingestInCache(payload);
-        callback(payload.channels[0]);
+        const data = prepareChannelPayload(payload);
+        ingestInCache(data);
+        callback(data.channels[0]);
     };
     return createEventSubscriber(client, 'onChannelDeleted', 'v3.channel.didDelete', filter);
 };
@@ -24555,8 +24729,9 @@ const onChannelDeleted = (callback) => {
 const onChannelJoined = (callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
-        ingestInCache(payload);
-        callback(payload.channels[0]);
+        const data = prepareChannelPayload(payload);
+        ingestInCache(data);
+        callback(data.channels[0]);
     };
     return createEventSubscriber(client, 'onChannelJoined', 'v3.channel.didJoin', filter);
 };
@@ -24579,8 +24754,9 @@ const onChannelJoined = (callback) => {
 const onChannelLeft = (callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
-        ingestInCache(payload);
-        callback(payload.channels[0]);
+        const data = prepareChannelPayload(payload);
+        ingestInCache(data);
+        callback(data.channels[0]);
     };
     return createEventSubscriber(client, 'onChannelLeft', 'v3.channel.didLeave', filter);
 };
@@ -24603,8 +24779,9 @@ const onChannelLeft = (callback) => {
 const onChannelMemberAdded = (callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
-        ingestInCache(payload);
-        callback(payload.channels[0], payload.channelUsers[0]);
+        const data = prepareChannelPayload(payload);
+        ingestInCache(data);
+        callback(data.channels[0], data.channelUsers[0]);
     };
     return createEventSubscriber(client, 'onChannelMemberAdded', 'v3.channel.didAddUsers', filter);
 };
@@ -24627,8 +24804,9 @@ const onChannelMemberAdded = (callback) => {
 const onChannelMemberRemoved = (callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
-        ingestInCache(payload);
-        callback(payload.channels[0], payload.channelUsers[0]);
+        const data = prepareChannelPayload(payload);
+        ingestInCache(data);
+        callback(data.channels[0], data.channelUsers[0]);
     };
     return createEventSubscriber(client, 'onChannelMemberRemoved', 'v3.channel.didRemoveUsers', filter);
 };
@@ -24674,6 +24852,159 @@ const observeChannel = (channelId, callback) => {
     };
 };
 
+/**
+ * ```js
+ * import { observeChannels } from '@amityco/ts-sdk'
+ *
+ * let channels = []
+ * const unsub = observeChannels(channel => merge(channels, channel))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Channel} for a current 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 channels
+ *
+ * @category Channel Observer
+ */
+const observeChannels = (callback) => {
+    const { log } = getActiveClient();
+    const timestamp = Date.now();
+    log(`observeChannels(tmpid: ${timestamp}) > listen`);
+    const disposers = [];
+    const router = (channel, action) => {
+        var _a, _b;
+        if (callback instanceof Function)
+            return callback(channel);
+        (_a = callback.onEvent) === null || _a === void 0 ? void 0 : _a.call(callback, action, channel);
+        (_b = callback[action]) === null || _b === void 0 ? void 0 : _b.call(callback, channel);
+    };
+    disposers.push(onChannelCreated(data => router(data, 'onCreate')), onChannelUpdated(data => router(data, 'onUpdate')), onChannelDeleted(data => router(data, 'onDelete')), onChannelJoined(data => router(data, 'onJoin')), onChannelLeft(data => router(data, 'onLeft')), onChannelMemberAdded(data => router(data, 'onMemberAdded')), onChannelMemberRemoved(data => router(data, 'onMemberRemoved')));
+    return () => {
+        log(`observeChannels(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
+/**
+ * ```js
+ * import { liveChannels } from '@amityco/ts-sdk'
+ *
+ * let channels = []
+ * const unsub = liveChannels({
+ *   displayName: Amity.Channel['displayName'],
+ * }, response => merge(channels, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Channel}s
+ *
+ * @param params for querying channels
+ * @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 channels
+ *
+ * @category Channel Live Collection
+ */
+const liveChannels = (params, callback, config) => {
+    const { log, cache } = getActiveClient();
+    if (!cache) {
+        console.log(ENABLE_CACHE_MESSAGE);
+    }
+    const timestamp = Date.now();
+    log(`liveChannels(tmpid: ${timestamp}) > listen`);
+    const { limit: queryLimit } = params, queryParams = __rest(params, ["limit"]);
+    const limit = queryLimit !== null && queryLimit !== void 0 ? queryLimit : COLLECTION_DEFAULT_PAGINATION_LIMIT;
+    const { policy = COLLECTION_DEFAULT_CACHING_POLICY } = config !== null && config !== void 0 ? config : {};
+    const disposers = [];
+    const cacheKey = ['channel', 'collection', {}];
+    const responder = (data) => {
+        var _a, _b;
+        let channels = (_a = data.data
+            .map(channelId => pullFromCache(['channel', 'get', channelId]))
+            .filter(Boolean)
+            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+        channels = filterByPropEquality(channels, 'isDeleted', params.isDeleted);
+        channels = filterByPropEquality(channels, 'displayName', params.displayName);
+        if (params.types) {
+            channels = channels.filter(c => { var _a; return (_a = params.types) === null || _a === void 0 ? void 0 : _a.includes(c.type); });
+        }
+        if (params.tags) {
+            channels = channels.filter(c => { var _a; return (_a = c.tags) === null || _a === void 0 ? void 0 : _a.some(t => { var _a; return (_a = params.tags) === null || _a === void 0 ? void 0 : _a.includes(t); }); });
+        }
+        if (params.excludeTags) {
+            channels = channels.filter(c => { var _a; return !((_a = c.tags) === null || _a === void 0 ? void 0 : _a.some(t => { var _a; return (_a = params.excludeTags) === null || _a === void 0 ? void 0 : _a.includes(t); })); });
+        }
+        const sortBy = params.sortBy || 'lastCreated';
+        if (sortBy === 'lastCreated' || sortBy === 'firstCreated') {
+            channels = channels.sort(sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
+        }
+        /*
+         * The server returns channels with empty | null displayName's first before
+         * returning sorted list of channels with displayNames
+         *
+         * This section needs to be updated as displayNames can be null as well
+         */
+        if (sortBy === 'displayName') {
+            channels = channels
+                // this needs to be aligned with the backend data type
+                .map(c => (c.displayName ? c : Object.assign(Object.assign({}, c), { displayName: '' })))
+                // @ts-ignore
+                .sort(sortByDisplayName);
+        }
+        callback({
+            onNextPage: onFetch,
+            data: channels,
+            hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
+            loading: data.loading,
+            error: data.error,
+        });
+    };
+    const realtimeRouter = (channel, action) => {
+        var _a;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (!collection)
+            return;
+        if (action === 'onCreate') {
+            collection.data = [...new Set([channel.channelId, ...collection.data])];
+            /*
+             * if the filter isDeleted is set, only collection item must be updated and not
+             * the collection
+             */
+        }
+        else if (action === 'onDelete' && !params.isDeleted) {
+            collection.data = collection.data.filter(c => c !== channel.channelId);
+        }
+        pushToCache(cacheKey, collection);
+        responder(collection);
+    };
+    const onFetch = () => {
+        var _a, _b, _c;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        const channels = (_b = collection === null || collection === void 0 ? void 0 : collection.data) !== null && _b !== void 0 ? _b : [];
+        if (channels.length > 0 && !(collection === null || collection === void 0 ? void 0 : collection.params.page))
+            return;
+        const query = createQuery(queryChannels, Object.assign(Object.assign({}, queryParams), { page: (_c = collection === null || collection === void 0 ? void 0 : collection.params.page) !== null && _c !== void 0 ? _c : { limit } }));
+        runQuery(query, ({ data: result, error, loading, nextPage: page }) => {
+            const data = {
+                loading,
+                error,
+                params: { page },
+                data: channels,
+            };
+            if (result) {
+                data.data = [...new Set([...channels, ...result.map(getResolver('channel'))])];
+            }
+            pushToCache(cacheKey, data);
+            responder(data);
+        }, queryOptions(policy));
+    };
+    disposers.push(onChannelCreated(channel => realtimeRouter(channel, 'onCreate')), onChannelDeleted(channel => realtimeRouter(channel, 'onDelete')), onChannelUpdated(channel => realtimeRouter(channel, 'onUpdate')));
+    onFetch();
+    return () => {
+        log(`liveChannels(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
 /**
  * ```js
  * import { onMessageCreated } from '@amityco/ts-sdk'
@@ -24806,7 +25137,6 @@ const observeMessage = (messageId, callback, policy = 'cache_then_server') => {
  *
  * Observe all mutations on a list of {@link Amity.Message} for a given {@link Amity.Channel} object
  *
- * @param client the client to observe the message with
  * @param channelId the ID of the channel where to observe the messages
  * @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
@@ -24834,19 +25164,112 @@ const observeMessages = (channelId, callback) => {
     };
 };
 
+/**
+ * ```js
+ * import { liveMessages } from '@amityco/ts-sdk'
+ *
+ * let messages = []
+ * const unsub = liveMessages({
+ *   channelId: Amity.Channel['channelId'];
+ * }, response => merge(messages, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Message} for a given target object
+ *
+ * @param params for querying memssages from a channel
+ * @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 Messages Live Collection
+ */
+const liveMessages = (params, callback, config) => {
+    const { log, cache } = getActiveClient();
+    if (!cache) {
+        console.log(ENABLE_CACHE_MESSAGE);
+    }
+    const timestamp = Date.now();
+    log(`liveMessages(tmpid: ${timestamp}) > listen`);
+    const { limit: queryLimit } = params, queryParams = __rest(params, ["limit"]);
+    const limit = queryLimit !== null && queryLimit !== void 0 ? queryLimit : COLLECTION_DEFAULT_PAGINATION_LIMIT;
+    const { policy = COLLECTION_DEFAULT_CACHING_POLICY } = config !== null && config !== void 0 ? config : {};
+    const disposers = [];
+    const cacheKey = ['message', 'collection', { channelId: params.channelId }];
+    const responder = (data) => {
+        var _a, _b;
+        let messages = (_a = data.data
+            .map(messageId => pullFromCache(['message', 'get', messageId]))
+            .filter(Boolean)
+            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+        /*
+         * for cases when message is deleted via RTE, this flag is used to get
+         * items fro cache that are deleted | !deleted
+         */
+        messages = filterByPropEquality(messages, 'isDeleted', params.isDeleted);
+        callback({
+            onNextPage: onFetch,
+            data: messages,
+            hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
+            loading: data.loading,
+            error: data.error,
+        });
+    };
+    const realtimeRouter = (message, action) => {
+        var _a;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (params.channelId !== message.channelId || !collection)
+            return;
+        if (action === 'onCreate') {
+            collection.data = [...new Set([message.messageId, ...collection.data])];
+        }
+        else if (['onDelete'].includes(action)) {
+            collection.data = collection.data.filter(m => m !== message.messageId);
+        }
+        pushToCache(cacheKey, collection);
+        responder(collection);
+    };
+    const onFetch = () => {
+        var _a, _b, _c, _d, _e;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        const messages = (_b = collection === null || collection === void 0 ? void 0 : collection.data) !== null && _b !== void 0 ? _b : [];
+        if (messages.length > 0 && !((_c = collection === null || collection === void 0 ? void 0 : collection.params) === null || _c === void 0 ? void 0 : _c.page))
+            return;
+        const query = createQuery(queryMessages, Object.assign(Object.assign({}, queryParams), { page: (_e = (_d = collection === null || collection === void 0 ? void 0 : collection.params) === null || _d === void 0 ? void 0 : _d.page) !== null && _e !== void 0 ? _e : { limit } }));
+        runQuery(query, ({ data: result, error, loading, prevPage: page }) => {
+            const data = {
+                loading,
+                error,
+                params: { page },
+                data: messages,
+            };
+            if (result) {
+                data.data = [...new Set([...messages, ...result.map(getResolver('message'))])];
+            }
+            pushToCache(cacheKey, data);
+            responder(data);
+        }, queryOptions(policy));
+    };
+    disposers.push(onMessageCreated(message => realtimeRouter(message, 'onCreate')), onMessageDeleted(message => realtimeRouter(message, 'onDelete')), onMessageUpdated(message => realtimeRouter(message, 'onUpdate')));
+    onFetch();
+    return () => {
+        log(`liveMessages(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
 const createCommunityEventSubscriber = (event, callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
+        const unpackedPayload = unpackCommunityPayload(payload);
         if (!client.cache) {
             // TODO: here we are missing specific properties here!
-            callback(payload.communities[0]);
+            callback(unpackedPayload.communities[0]);
         }
         else {
-            ingestInCache(payload);
+            ingestInCache(unpackedPayload);
             const community = pullFromCache([
                 'community',
                 'get',
-                payload.communities[0].communityId,
+                unpackedPayload.communities[0].communityId,
             ]);
             callback(community.data);
         }
@@ -24882,21 +25305,22 @@ function getEventRelatedMember(event, payload) {
 const createCommunityMemberEventSubscriber = (event, callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
+        const unpackedPayload = unpackCommunityPayload(payload);
         if (!client.cache) {
             // TODO: here we are missing specific properties here!
-            callback(payload.communities[0], getEventRelatedMember(event, payload));
+            callback(unpackedPayload.communities[0], getEventRelatedMember(event, unpackedPayload));
         }
         else {
-            ingestInCache(payload);
+            ingestInCache(unpackedPayload);
             const community = pullFromCache([
                 'community',
                 'get',
-                payload.communities[0].communityId,
+                unpackedPayload.communities[0].communityId,
             ]);
             const member = pullFromCache([
                 'communityUsers',
                 'get',
-                getResolver('communityUsers')(getEventRelatedMember(event, payload)),
+                getResolver('communityUsers')(getEventRelatedMember(event, unpackedPayload)),
             ]);
             callback(community.data, member.data);
         }
@@ -25321,9 +25745,9 @@ const queryFollows = async (key, query) => {
     if (client.cache) {
         ingestInCache(payload, { cachedAt });
         const cacheKey = [
-            key,
+            'follow',
             'query',
-            Object.assign(Object.assign({}, params), { userId, options: Object.assign({}, page) }),
+            Object.assign(Object.assign({}, params), { userId, options: Object.assign({}, page), type: key }),
         ];
         pushToCache(cacheKey, { follows: follows.map(getResolver('follow')), paging });
     }
@@ -25338,7 +25762,11 @@ queryFollows.locally = (key, 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 queryKey = [
+        'follow',
+        'query',
+        Object.assign(Object.assign({}, params), { options: Object.assign({}, page), type: key }),
+    ];
     const { data, cachedAt } = (_a = pullFromCache(queryKey)) !== null && _a !== void 0 ? _a : {};
     if (!(data === null || data === void 0 ? void 0 : data.follows.length)) {
         return;
@@ -25884,6 +26312,186 @@ const observeFollowings = (userId, callback) => {
     };
 };
 
+/**
+ * ```js
+ * import { liveFollowers } from '@amityco/ts-sdk'
+ *
+ * let followers = []
+ * const unsub = liveFollowers({
+ *   userId: Amity.User['userId'];
+ * }, response => merge(followers, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.FollowStatus} followers for a given userId
+ *
+ * @param userId the 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 Followers Live Collection
+ */
+const liveFollowers = (params, callback, config) => {
+    const { log, cache } = getActiveClient();
+    if (!cache) {
+        console.log('For using Live Collection feature you need to enable Cache!');
+    }
+    const timestamp = Date.now();
+    log(`liveFollowers(tmpid: ${timestamp}) > listen`);
+    const { limit: queryLimit } = params, queryParams = __rest(params, ["limit"]);
+    const limit = queryLimit !== null && queryLimit !== void 0 ? queryLimit : COLLECTION_DEFAULT_PAGINATION_LIMIT;
+    const { policy = COLLECTION_DEFAULT_CACHING_POLICY } = config !== null && config !== void 0 ? config : {};
+    const disposers = [];
+    const cacheKey = ['follow', 'collection', { userId: params.userId, type: 'follower' }];
+    const responder = (data) => {
+        var _a, _b;
+        let followers = (_a = data.data
+            .map(key => pullFromCache(['follow', 'get', key]))
+            .filter(Boolean)
+            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+        if (params.status && params.status !== 'all') {
+            followers = filterByPropEquality(followers, 'status', params.status);
+        }
+        callback({
+            onNextPage: onFetch,
+            data: followers,
+            hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
+            loading: data.loading,
+            error: data.error,
+        });
+    };
+    const realtimeRouter = (followStatus, action) => {
+        var _a;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (params.userId !== followStatus.to || !collection)
+            return;
+        if (['onDeclined', 'onCanceled', 'onUnfollowed', 'onDeleted'].includes(action)) {
+            collection.data = collection.data.filter(p => p !== getResolver('follow')(followStatus));
+        }
+        else if (['onRequested', 'onAccepted', 'onFollowed'].includes(action)) {
+            collection.data = [...new Set([getResolver('follow')(followStatus), ...collection.data])];
+        }
+        pushToCache(cacheKey, collection);
+        responder(collection);
+    };
+    const onFetch = () => {
+        var _a, _b, _c, _d, _e;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        const followers = (_b = collection === null || collection === void 0 ? void 0 : collection.data) !== null && _b !== void 0 ? _b : [];
+        if (followers.length > 0 && !((_c = collection === null || collection === void 0 ? void 0 : collection.params) === null || _c === void 0 ? void 0 : _c.page))
+            return;
+        const query = createQuery(queryFollowers, Object.assign(Object.assign({}, queryParams), { page: (_e = (_d = collection === null || collection === void 0 ? void 0 : collection.params) === null || _d === void 0 ? void 0 : _d.page) !== null && _e !== void 0 ? _e : { limit } }));
+        runQuery(query, ({ data: result, error, loading, nextPage: page }) => {
+            const data = {
+                loading,
+                error,
+                params: { page },
+                data: followers,
+            };
+            if (result) {
+                data.data = [...new Set([...followers, ...result.map(getResolver('follow'))])];
+            }
+            pushToCache(cacheKey, data);
+            responder(data);
+        }, queryOptions(policy));
+    };
+    disposers.push(onFollowerRequested(followStatus => realtimeRouter(followStatus, 'onRequested')), onFollowRequestAccepted(followStatus => realtimeRouter(followStatus, 'onAccepted')), onFollowRequestDeclined(followStatus => realtimeRouter(followStatus, 'onDeclined')), onFollowRequestCanceled(followStatus => realtimeRouter(followStatus, 'onCanceled')), onUserFollowed(followStatus => realtimeRouter(followStatus, 'onFollowed')), onUserUnfollowed(followStatus => realtimeRouter(followStatus, 'onUnfollowed')), onFollowerDeleted(followStatus => realtimeRouter(followStatus, 'onDeleted')));
+    onFetch();
+    return () => {
+        log(`liveFollowers(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
+/**
+ * ```js
+ * import { liveFollowings } from '@amityco/ts-sdk'
+ *
+ * let followings = []
+ * const unsub = liveFollowings({
+ *   userId: Amity.User['userId'];
+ * }, response => merge(followings, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.FollowStatus} followings for a given userId
+ *
+ * @param userId the 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 Followings Live Collection
+ */
+const liveFollowings = (params, callback, config) => {
+    const { log, cache } = getActiveClient();
+    if (!cache) {
+        console.log('For using Live Collection feature you need to enable Cache!');
+    }
+    const timestamp = Date.now();
+    log(`liveFollowings(tmpid: ${timestamp}) > listen`);
+    const { limit: queryLimit } = params, queryParams = __rest(params, ["limit"]);
+    const limit = queryLimit !== null && queryLimit !== void 0 ? queryLimit : COLLECTION_DEFAULT_PAGINATION_LIMIT;
+    const { policy = COLLECTION_DEFAULT_CACHING_POLICY } = config !== null && config !== void 0 ? config : {};
+    const disposers = [];
+    const cacheKey = ['follow', 'collection', { userId: params.userId, type: 'following' }];
+    const responder = (data) => {
+        var _a, _b;
+        let followings = (_a = data.data
+            .map(key => pullFromCache(['follow', 'get', key]))
+            .filter(Boolean)
+            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+        if (params.status && params.status !== 'all') {
+            followings = filterByPropEquality(followings, 'status', params.status);
+        }
+        callback({
+            onNextPage: onFetch,
+            data: followings,
+            hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
+            loading: data.loading,
+            error: data.error,
+        });
+    };
+    const realtimeRouter = (followStatus, action) => {
+        var _a;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (params.userId !== followStatus.from || !collection)
+            return;
+        if (['onDeclined', 'onCanceled', 'onUnfollowed', 'onDeleted'].includes(action)) {
+            collection.data = collection.data.filter(p => p !== getResolver('follow')(followStatus));
+        }
+        else if (['onRequested', 'onAccepted', 'onFollowed'].includes(action)) {
+            collection.data = [...new Set([getResolver('follow')(followStatus), ...collection.data])];
+        }
+        pushToCache(cacheKey, collection);
+        responder(collection);
+    };
+    const onFetch = () => {
+        var _a, _b, _c, _d, _e;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        const followings = (_b = collection === null || collection === void 0 ? void 0 : collection.data) !== null && _b !== void 0 ? _b : [];
+        if (followings.length > 0 && !((_c = collection === null || collection === void 0 ? void 0 : collection.params) === null || _c === void 0 ? void 0 : _c.page))
+            return;
+        const query = createQuery(queryFollowings, Object.assign(Object.assign({}, queryParams), { page: (_e = (_d = collection === null || collection === void 0 ? void 0 : collection.params) === null || _d === void 0 ? void 0 : _d.page) !== null && _e !== void 0 ? _e : { limit } }));
+        runQuery(query, ({ data: result, error, loading, nextPage: page }) => {
+            const data = {
+                loading,
+                error,
+                params: { page },
+                data: followings,
+            };
+            if (result) {
+                data.data = [...new Set([...followings, ...result.map(getResolver('follow'))])];
+            }
+            pushToCache(cacheKey, data);
+            responder(data);
+        }, queryOptions(policy));
+    };
+    disposers.push(onFollowerRequested(followStatus => realtimeRouter(followStatus, 'onRequested')), onFollowRequestAccepted(followStatus => realtimeRouter(followStatus, 'onAccepted')), onFollowRequestDeclined(followStatus => realtimeRouter(followStatus, 'onDeclined')), onFollowRequestCanceled(followStatus => realtimeRouter(followStatus, 'onCanceled')), onUserFollowed(followStatus => realtimeRouter(followStatus, 'onFollowed')), onUserUnfollowed(followStatus => realtimeRouter(followStatus, 'onUnfollowed')), onFollowerDeleted(followStatus => realtimeRouter(followStatus, 'onDeleted')));
+    onFetch();
+    return () => {
+        log(`liveFollowings(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+
 /**
  * ```js
  * import { observePosts } from '@amityco/ts-sdk'
@@ -25992,7 +26600,7 @@ const observePost = (postId, callback, policy = 'cache_then_server') => {
 const livePosts = (params, callback, config) => {
     const { log, cache } = getActiveClient();
     if (!cache) {
-        console.log('For using Live Collection feature you need to enable Cache!');
+        console.log(ENABLE_CACHE_MESSAGE);
     }
     const timestamp = Date.now();
     log(`livePosts(tmpid: ${timestamp}) > listen`);
@@ -26830,4 +27438,4 @@ const createUserToken = async (apiKey, apiRegion, params) => {
     return { accessToken: data.accessToken };
 };
 
-export { API_REGIONS, SubscriptionLevels, VERSION$1 as VERSION, acceptFollower, addChannelMembers, addChannelMembersRole, addCommunityMembers, addCommunityMembersRoles, addReaction, approvePost, backupCache, banChannelMembers, closePoll, connectClient, createChannel, createClient, createComment, createCommunity, createFile, createImage, createMessage, createPoll, createPost, createQuery, createReport, createStream, createUserToken, createVideo, declineFollower, declinePost, deleteChannel, deleteComment, deleteCommunity, deleteFile, deleteMessage, deletePoll, deletePost, deleteReport, deleteStream, disableCache, disconnectClient, disposeStream, dropFromCache, enableCache, fileUrlWithSize, filterByPropEquality, follow, getActiveClient, getCategory, getChannel, getChannels, getComment, getCommentTopic, getComments, getCommunities, getCommunity, getCommunityTopic, getFile, getFollowInfo, getMessage, getMessages, getMyFollowersTopic, getMyFollowingsTopic, getNetworkTopic, getPoll, getPost, getPostTopic, getPosts, getRecommendedCommunities, getRole, getStream, getTopTrendingCommunities, getUser, getUserTopic, getUsers, isAfterBefore, isAfterBeforeRaw, isCachable, isConnected, isFetcher, isFresh, isLocal, isMutator, isOffline, isPaged, isReportedByMe, isSkipLimit, joinChannel, joinCommunity, leaveChannel, leaveCommunity, liveComments, livePosts, liveReactions, mergeInCache, observeChannel, observeComment, observeComments, observeCommunity, observeFile, observeFollowInfo, observeFollowers, observeFollowings, observeMessage, observeMessages, observePoll, observePost, observePosts, observeUser, onChannelDeleted, onChannelJoined, onChannelLeft, onChannelMemberAdded, onChannelMemberRemoved, onChannelUpdated, onClientBanned, onClientDisconnected, onCommentCreated, onCommentDeleted, onCommentFlagged, onCommentReactionAdded, onCommentReactionRemoved, onCommentUnflagged, onCommentUpdated, onCommunityCreated, onCommunityDeleted, onCommunityJoined, onCommunityLeft, onCommunityUpdated, onCommunityUserAdded, onCommunityUserBanned, onCommunityUserRemoved, onCommunityUserUnbanned, onConnectionError, onFollowInfoUpdated, onFollowRequestAccepted, onFollowRequestCanceled, onFollowRequestDeclined, onFollowerDeleted, onFollowerRequested, onMessageCreated, onMessageDeleted, onMessageUpdated, onPollDeleted, onPollUpdated, onPostApproved, onPostCreated, onPostDeclined, onPostDeleted, onPostFlagged, onPostReactionAdded, onPostReactionRemoved, onPostUnflagged, onPostUpdated, onReactionAdded, onReactionRemoved, onReactorAdded, onReactorRemoved, onStreamRecorded, onStreamStarted, onStreamStopped, onUserDeleted, onUserFlagCleared, onUserFlagged, onUserFollowed, onUserUnflagged, onUserUnfollowed, onUserUpdated, pullFromCache, pushToCache, queryCache, queryCategories, queryChannelMembers, queryChannels, queryComments, queryCommunities, queryCommunityMembers, queryFollowers, queryFollowings, queryGlobalFeed, queryMessages, queryOptions, queryPosts, queryReactions, queryRoles, queryStreams, queryUsers, removeChannelMembers, removeChannelMembersRole, removeCommunityMembers, removeCommunityMembersRoles, removeReaction, restoreCache, runQuery, sortByChannelSegment, sortByDisplayName, sortByFirstCreated, sortByLastActivity, sortByLastCreated, sortBySegmentNumber, subscribeTopic, toPage, toPageRaw, toToken, unbanChannelMembers, unfollow, updateChannel, updateComment, updateCommunity, updateMessage, updatePost, updateStream, updateUser, upsertInCache, votePoll, wipeCache };
+export { API_REGIONS, CommunityPostSettingMaps, CommunityPostSettings, ContentFeedType, DefaultCommunityPostSetting, FileType, SubscriptionLevels, VERSION$1 as VERSION, VideoResolution, VideoSize, VideoTranscodingStatus, acceptFollower, addChannelMembers, addChannelMembersRole, addCommunityMembers, addCommunityMembersRoles, addReaction, approvePost, backupCache, banChannelMembers, closePoll, connectClient, createChannel, createClient, createComment, createCommunity, createFile, createImage, createMessage, createPoll, createPost, createQuery, createReport, createStream, createUserToken, createVideo, declineFollower, declinePost, deleteChannel, deleteComment, deleteCommunity, deleteFile, deleteMessage, deletePoll, deletePost, deleteReport, deleteStream, disableCache, disconnectClient, disposeStream, dropFromCache, enableCache, fileUrlWithSize, filterByPropEquality, follow, getActiveClient, getCategory, getChannel, getChannels, getComment, getCommentTopic, getComments, getCommunities, getCommunity, getCommunityTopic, getFeedSettings, getFile, getFollowInfo, getMessage, getMessages, getMyFollowersTopic, getMyFollowingsTopic, getNetworkTopic, getPoll, getPost, getPostTopic, getPosts, getRecommendedCommunities, getRole, getStream, getTopTrendingCommunities, getUser, getUserTopic, getUsers, isAfterBefore, isAfterBeforeRaw, isCachable, isConnected, isFetcher, isFresh, isLocal, isMutator, isOffline, isPaged, isReportedByMe, isSkipLimit, joinChannel, joinCommunity, leaveChannel, leaveCommunity, liveChannels, liveComments, liveFollowers, liveFollowings, liveMessages, livePosts, liveReactions, mergeInCache, observeChannel, observeChannels, observeComment, observeComments, observeCommunity, observeFile, observeFollowInfo, observeFollowers, observeFollowings, observeMessage, observeMessages, observePoll, observePost, observePosts, observeUser, onChannelCreated, onChannelDeleted, onChannelJoined, onChannelLeft, onChannelMemberAdded, onChannelMemberRemoved, onChannelUpdated, onClientBanned, onClientDisconnected, onCommentCreated, onCommentDeleted, onCommentFlagged, onCommentReactionAdded, onCommentReactionRemoved, onCommentUnflagged, onCommentUpdated, onCommunityCreated, onCommunityDeleted, onCommunityJoined, onCommunityLeft, onCommunityUpdated, onCommunityUserAdded, onCommunityUserBanned, onCommunityUserRemoved, onCommunityUserUnbanned, onConnectionError, onFollowInfoUpdated, onFollowRequestAccepted, onFollowRequestCanceled, onFollowRequestDeclined, onFollowerDeleted, onFollowerRequested, onMessageCreated, onMessageDeleted, onMessageUpdated, onPollDeleted, onPollUpdated, onPostApproved, onPostCreated, onPostDeclined, onPostDeleted, onPostFlagged, onPostReactionAdded, onPostReactionRemoved, onPostUnflagged, onPostUpdated, onReactionAdded, onReactionRemoved, onReactorAdded, onReactorRemoved, onStreamRecorded, onStreamStarted, onStreamStopped, onUserDeleted, onUserFlagCleared, onUserFlagged, onUserFollowed, onUserUnflagged, onUserUnfollowed, onUserUpdated, pullFromCache, pushToCache, queryCache, queryCategories, queryChannelMembers, queryChannels, queryComments, queryCommunities, queryCommunityMembers, queryFollowers, queryFollowings, queryGlobalFeed, queryMessages, queryOptions, queryPosts, queryReactions, queryRoles, queryStreams, queryUsers, removeChannelMembers, removeChannelMembersRole, removeCommunityMembers, removeCommunityMembersRoles, removeReaction, restoreCache, runQuery, sortByChannelSegment, sortByDisplayName, sortByFirstCreated, sortByLastActivity, sortByLastCreated, sortBySegmentNumber, subscribeTopic, toPage, toPageRaw, toToken, unbanChannelMembers, unfollow, updateChannel, updateComment, updateCommunity, updateMessage, updatePost, updateStream, updateUser, upsertInCache, votePoll, wipeCache };