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

package/dist/index.cjs.js

@@ -21,6 +21,38 @@ var HttpAgent__default = /*#__PURE__*/_interopDefaultLegacy(HttpAgent);
 var io__default = /*#__PURE__*/_interopDefaultLegacy(io);
 var nativeIdGenerator__default = /*#__PURE__*/_interopDefaultLegacy(nativeIdGenerator);
 
+const ContentFeedType = Object.freeze({
+    STORY: 'story',
+    CHIP: 'clip',
+    CHAT: 'chat',
+    POST: 'post',
+});
+
+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 = 
@@ -368,7 +400,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
  *
@@ -654,8 +686,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',
@@ -20155,6 +20188,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'
@@ -20165,20 +20221,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}`,
@@ -20189,11 +20249,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;
@@ -20262,6 +20323,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
  *
@@ -20362,58 +20475,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
@@ -20981,17 +21042,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' };
@@ -23765,7 +23830,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
@@ -23967,6 +24033,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'
@@ -23990,16 +24073,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',
@@ -24049,9 +24133,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 });
@@ -24110,7 +24195,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 });
@@ -24171,10 +24257,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,
@@ -24199,7 +24286,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 });
@@ -24250,7 +24338,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;
@@ -24274,7 +24363,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;
@@ -24299,16 +24389,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);
@@ -24351,13 +24442,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');
 };
@@ -24380,13 +24469,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');
 };
@@ -24410,7 +24497,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;
@@ -24436,7 +24524,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;
@@ -24460,13 +24549,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,
@@ -24490,19 +24580,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'
@@ -24521,8 +24637,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);
 };
@@ -24545,8 +24662,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);
 };
@@ -24569,8 +24687,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);
 };
@@ -24593,8 +24712,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);
 };
@@ -24617,8 +24737,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);
 };
@@ -24641,8 +24762,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);
 };
@@ -24688,6 +24810,40 @@ 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 { onMessageCreated } from '@amityco/ts-sdk'
@@ -24820,7 +24976,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
@@ -24848,6 +25003,98 @@ 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) => {
@@ -25335,9 +25582,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 });
     }
@@ -25352,7 +25599,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;
@@ -25898,6 +26149,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) {
+            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) {
+            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'
@@ -26006,7 +26437,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`);
@@ -26845,7 +27276,12 @@ const createUserToken = async (apiKey, apiRegion, params) => {
 };
 
 exports.API_REGIONS = API_REGIONS;
+exports.ContentFeedType = ContentFeedType;
+exports.FileType = FileType;
 exports.VERSION = VERSION$1;
+exports.VideoResolution = VideoResolution;
+exports.VideoSize = VideoSize;
+exports.VideoTranscodingStatus = VideoTranscodingStatus;
 exports.acceptFollower = acceptFollower;
 exports.addChannelMembers = addChannelMembers;
 exports.addChannelMembersRole = addChannelMembersRole;
@@ -26900,6 +27336,7 @@ exports.getComments = getComments;
 exports.getCommunities = getCommunities;
 exports.getCommunity = getCommunity;
 exports.getCommunityTopic = getCommunityTopic;
+exports.getFeedSettings = getFeedSettings;
 exports.getFile = getFile;
 exports.getFollowInfo = getFollowInfo;
 exports.getMessage = getMessage;
@@ -26935,10 +27372,14 @@ exports.joinCommunity = joinCommunity;
 exports.leaveChannel = leaveChannel;
 exports.leaveCommunity = leaveCommunity;
 exports.liveComments = liveComments;
+exports.liveFollowers = liveFollowers;
+exports.liveFollowings = liveFollowings;
+exports.liveMessages = liveMessages;
 exports.livePosts = livePosts;
 exports.liveReactions = liveReactions;
 exports.mergeInCache = mergeInCache;
 exports.observeChannel = observeChannel;
+exports.observeChannels = observeChannels;
 exports.observeComment = observeComment;
 exports.observeComments = observeComments;
 exports.observeCommunity = observeCommunity;
@@ -26952,6 +27393,7 @@ exports.observePoll = observePoll;
 exports.observePost = observePost;
 exports.observePosts = observePosts;
 exports.observeUser = observeUser;
+exports.onChannelCreated = onChannelCreated;
 exports.onChannelDeleted = onChannelDeleted;
 exports.onChannelJoined = onChannelJoined;
 exports.onChannelLeft = onChannelLeft;