@amityco/ts-sdk 0.0.1-beta.10 → 0.0.1-beta.14

package/dist/index.esm.js

@@ -5,13 +5,15 @@ import HttpAgent, { HttpsAgent } from 'agentkeepalive';
 import io from 'socket.io-client';
 import mitt from 'mitt';
 import AsyncStorage from '@react-native-async-storage/async-storage';
-import isMatch from 'lodash.ismatch';
 
-var _a;
-// used in createClient
-const VERSION$1 = (_a = 'v0.0.1-beta.10-esm') !== null && _a !== void 0 ? _a : '__dev__';
+var _a$1;
+const theGlobal = globalThis || global || window;
+const { process: safeProcess = {} } = theGlobal;
+const isProduction = ((_a$1 = safeProcess.env) === null || _a$1 === void 0 ? void 0 : _a$1.NODE_ENV) === 'production';
+
+var _a, _b;
+const VERSION$1 = (_b = (_a = safeProcess.env) === null || _a === void 0 ? void 0 : _a.VERSION) !== null && _b !== void 0 ? _b : '__dev__';
 
-// @ts-ignore
 /**
  * Type guard to find if the a given decoded backend token uses "skip/limit" pagination style
  *
@@ -29,7 +31,7 @@ const isSkipLimit = (json) => (['skip', 'limit'].some(prop => prop in json));
  *
  * @hidden
  */
-const isAfterBefore = (json) => (['after', 'before', 'first', 'last'].some(prop => prop in json));
+const isAfterBefore = (json) => (['after', 'before', 'first', 'last', 'limit'].some(prop => prop in json));
 /**
  * Type guard to find if the a given decoded backend token uses v4 or newer "after/before" pagination style
  *
@@ -38,7 +40,7 @@ const isAfterBefore = (json) => (['after', 'before', 'first', 'last'].some(prop
  *
  * @hidden
  */
-const isAfterBeforeRaw = (json) => (['after', 'before'].some(prop => prop in json));
+const isAfterBeforeRaw = (json) => ('limit' in json);
 /**
  * Type guard to find if the a given object is wrapped around Amity.Paged<>
  *
@@ -73,7 +75,7 @@ const toToken = (paging, style) => {
             limit: paging.limit,
         };
     }
-    else if (style === 'afterbefore') {
+    else if (style === 'afterbefore' && isAfterBefore(paging)) {
         /*
           Caution: this testing style is only valid because
           our backend expects nothing else than a number as
@@ -159,35 +161,6 @@ const toPageRaw = (token) => {
         return json;
     }
     return null;
-};
-/**
- * Slices a collection according to its paging
- *
- * @param type the type of collection (for unique id identification with after/before)
- * @param collection the collection to slice
- * @param paging the paging object
- * @returns the sliced collection according to the paging definition
- *
- * @hidden
- */
-const sliceByPaging = (type, collection, page) => {
-    console.log('slice by paging', page);
-    if (!page)
-        return collection.slice();
-    let start = 0;
-    let end = undefined;
-    // next page behavior
-    if (page.after) {
-        start = page.after;
-        end = start + page.limit;
-        // prev page behavior
-    }
-    else if (page.before) {
-        end = page.before + 1;
-        start = end > page.limit ? end - page.limit : 0;
-    }
-    const paged = collection.slice(start, end);
-    return paged.length === page.limit ? paged : undefined;
 };
 
 /**
@@ -501,7 +474,7 @@ const setActiveClient = (client) => {
  */
 const createLogger = (session) => {
     const active = (`${session === null || session === void 0 ? void 0 : session.trim()}`.length > 0
-        && process.env.NODE_ENV !== 'production');
+        && !isProduction);
     const logger = debug(session);
     const print = (topic, ...args) => {
         active && logger(topic, args);
@@ -14728,6 +14701,22 @@ const createMqttTransport = (endpoint) => {
     };
 };
 
+let tasks = [];
+let timer;
+/**
+ * Add a function to run just before the next tick
+ *
+ * @param task function to schedule for later execution
+ */
+const scheduleTask = (task) => {
+    clearTimeout(timer);
+    tasks.push(task);
+    timer = setTimeout(() => {
+        tasks.forEach(fn => fn());
+        tasks = [];
+    }, 0);
+};
+
 // need to sync up the list
 const WS_EVENTS = [
     'disconnected',
@@ -14818,7 +14807,7 @@ const createEventSubscriber = (client, namespace, event, fn) => {
  */
 const fireEvent = (event, payload) => {
     const { emitter } = getActiveClient();
-    setTimeout(() => { emitter.emit(event, payload); }, 0);
+    scheduleTask(() => { emitter.emit(event, payload); });
 };
 
 /**
@@ -14892,13 +14881,11 @@ const disconnectClient = async () => {
     client.ws.removeAllListeners();
     client.mqtt.removeAllListeners();
     client.userId = undefined;
-    client.user = undefined;
     client.accessToken = undefined;
     return !client.ws.connected;
 };
 
 // TODO: find a way to uniquely identify the device
-// import { getStorage } from './storage'
 /** @hidden */
 const VERSION = '11.0.0';
 /** @hidden */
@@ -14913,8 +14900,8 @@ const getDeviceId = () => {
 /** @hidden */
 const getDeviceModel = () => {
     var _a, _b;
-    if ((_a = process === null || process === void 0 ? void 0 : process.versions) === null || _a === void 0 ? void 0 : _a.node)
-        return process.versions.node;
+    if ((_a = safeProcess.versions) === null || _a === void 0 ? void 0 : _a.node)
+        return safeProcess.versions.node;
     if (navigator)
         return `${navigator.product.toLowerCase()}#${(_b = navigator.userAgent) !== null && _b !== void 0 ? _b : 'unknown_agent'}`;
     return 'unknown_model';
@@ -14978,7 +14965,7 @@ const EVENTS = [
 const onConnectionError = (callback) => {
     const client = getActiveClient();
     const subscribers = EVENTS.map(event => (createEventSubscriber(client, `client/onConnectionError(${event})`, event, (response) => {
-        const error = (response && 'code' in response)
+        const error = (response === null || response === void 0 ? void 0 : response.code)
             ? new ASCError(response.message, response.code, "fatal" /* FATAL */)
             : new ASCConnectionError(event);
         callback(error);
@@ -15077,7 +15064,7 @@ const connectClient = async (params) => {
         unsubscribe();
     });
     client.userId = params.userId;
-    client.user = users[0];
+    client._internalUserId = users[0]._id;
     client.accessToken = accessToken;
     return client.ws.connected;
 };
@@ -15139,11 +15126,11 @@ const getCommentTopic = ({ path }) => {
 let mqttAccessToken;
 let mqttUserId;
 function subscribeTopic(topic, callback) {
-    const { mqtt, emitter, accessToken, user } = getActiveClient();
-    if (mqttAccessToken !== accessToken || mqttUserId !== user._id) {
+    const { mqtt, emitter, accessToken, _internalUserId } = getActiveClient();
+    if (mqttAccessToken !== accessToken || mqttUserId !== _internalUserId) {
         mqttAccessToken = accessToken;
-        mqttUserId = user._id;
-        mqtt.connect({ accessToken: accessToken, userId: user._id });
+        mqttUserId = _internalUserId;
+        mqtt.connect({ accessToken: mqttAccessToken, userId: mqttUserId });
         proxyMqttEvents(mqtt, emitter);
     }
     return mqtt.subscribe(topic, callback);
@@ -15619,7 +15606,7 @@ const getUser = async (userId) => {
     const client = getActiveClient();
     client.log('user/getUser', userId);
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/users/${userId}`);
+    const { data } = await client.http.get(`/api/v3/users/${encodeURIComponent(userId)}`);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -15665,8 +15652,9 @@ getUser.locally = (userId) => {
 const getUsers = async (userIds) => {
     const client = getActiveClient();
     client.log('user/getUsers', userIds);
+    const encodedUserIds = userIds.map(userId => encodeURIComponent(userId));
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/users/list`, { params: { userIds } });
+    const { data } = await client.http.get(`/api/v3/users/list`, { params: { userIds: encodedUserIds } });
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -16261,7 +16249,7 @@ const getMessage = async (messageId) => {
     const client = getActiveClient();
     client.log('message/getMessage', messageId);
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/messages/${messageId}`);
+    const { data } = await client.http.get(`/api/v3/messages/${encodeURIComponent(messageId)}`);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -16520,7 +16508,7 @@ createMessage.optimistically = (bundle) => {
 const updateMessage = async (messageId, patch) => {
     const client = getActiveClient();
     client.log('user/updateMessage', patch);
-    const { data } = await client.http.put(`/api/v3/messages/${messageId}`, patch);
+    const { data } = await client.http.put(`/api/v3/messages/${encodeURIComponent(messageId)}`, patch);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -16582,7 +16570,7 @@ const deleteMessage = async (messageId) => {
     const client = getActiveClient();
     client.log('message/deleteMessage', messageId);
     // API-FIX: This endpoint has not been implemented yet.
-    await client.http.delete(`/api/v3/messages/${messageId}`);
+    await client.http.delete(`/api/v3/messages/${encodeURIComponent(messageId)}`);
     const deleted = await getMessage(messageId);
     // no need for event, fired by server
     return deleted.data;
@@ -16636,11 +16624,11 @@ const queryPosts = async (query) => {
     const { page = { limit: 10 } } = query, params = __rest(query
     // API-FIX: parameters should be querystring. (1)
     // API-FIX: backend should answer Amity.Response (2)
-    // const { data } = await client.http.get<Amity.Response<Amity.PagedRawResponse<Amity.PostPayload>>>(
+    // const { data } = await client.http.get<Amity.Response<Amity.PagedResponse<Amity.PostPayload>>>(
     , ["page"]);
     // API-FIX: parameters should be querystring. (1)
     // API-FIX: backend should answer Amity.Response (2)
-    // const { data } = await client.http.get<Amity.Response<Amity.PagedRawResponse<Amity.PostPayload>>>(
+    // const { data } = await client.http.get<Amity.Response<Amity.PagedResponse<Amity.PostPayload>>>(
     const { data } = await client.http.get(`/api/v4/posts`, { params: Object.assign(Object.assign({}, params), { options: {
                 token: toToken(page, 'afterbeforeraw'),
             } }), });
@@ -16711,8 +16699,9 @@ queryPosts.locally = (query) => {
 const getPosts = async (postIds) => {
     const client = getActiveClient();
     client.log('post/getPosts', postIds);
+    const encodedPostIds = postIds.map(postId => encodeURIComponent(postId));
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/posts/list`, { params: { postIds } });
+    const { data } = await client.http.get(`/api/v3/posts/list`, { params: { postIds: encodedPostIds } });
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -16774,7 +16763,7 @@ const getPost = async (postId) => {
     let data;
     try {
         // API-FIX: endpoint should not be /list, parameters should be querystring.
-        const response = await client.http.get(`/api/v3/posts/${postId}`);
+        const response = await client.http.get(`/api/v3/posts/${encodeURIComponent(postId)}`);
         data = response.data;
     }
     catch (error) {
@@ -16841,13 +16830,12 @@ const createPost = async (bundle) => {
     const client = getActiveClient();
     client.log('post/createPost', bundle);
     // API-FIX: backend rejects that we pass the dataType manually T_T
-    if (!bundle.dataType || ['text', 'image', 'file'].includes(bundle.dataType))
+    if (!bundle.dataType || ['text', 'image', 'file', 'video'].includes(bundle.dataType))
         delete bundle.dataType;
-    const { data } = await client.http.post('/api/v3/posts', bundle);
+    const { data } = await client.http.post('/api/v4/posts', bundle);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
-    fireEvent('community.updated', { communities: data.communities });
     fireEvent('post.created', data);
     const { posts } = data;
     return {
@@ -16876,7 +16864,7 @@ const createPost = async (bundle) => {
 const updatePost = async (postId, patch) => {
     const client = getActiveClient();
     client.log('user/updatePost', patch);
-    const { data } = await client.http.put(`/api/v3/posts/${postId}`, patch);
+    const { data } = await client.http.put(`/api/v4/posts/${encodeURIComponent(postId)}`, patch);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -17163,9 +17151,7 @@ const joinCommunity = async (communityId) => {
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
-    fireEvent('community.joined', {
-        communities: data.communities
-    });
+    fireEvent('community.joined', data);
     const { communityUsers } = data;
     return !!communityUsers.find(communityUser => (communityUser.communityId === communityId
         && communityUser.communityMembership === 'member'));
@@ -17192,9 +17178,7 @@ const leaveCommunity = async (communityId) => {
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
-    fireEvent('community.left', {
-        communities: data.communities,
-    });
+    fireEvent('community.left', data);
     const { communityUsers } = data;
     return !!communityUsers.find(communityUser => (communityUser.communityId === communityId
         && communityUser.communityMembership !== 'member'));
@@ -17231,7 +17215,7 @@ const queryCommunityMembers = async (query) => {
     }
     const nextPage = toPage(paging.next);
     const prevPage = toPage(paging.previous);
-    return { data: communityUsers, nextPage, prevPage };
+    return { data: communityUsers, cachedAt, nextPage, prevPage };
 };
 /**
  * ```js
@@ -17273,9 +17257,7 @@ const addCommunityMembers = async (communityId, userIds) => {
     const { data } = await client.http.post(`/api/v3/communities/${communityId}/users`, { communityId, userIds });
     if (client.cache)
         ingestInCache(data);
-    fireEvent('community.userAdded', {
-        communities: data.communities,
-    });
+    fireEvent('community.userAdded', data);
     const { communityUsers } = data;
     return !!communityUsers.find(communityUser => communityUser.communityId === communityId &&
         communityUser.communityMembership === 'member');
@@ -17302,9 +17284,7 @@ const removeCommunityMembers = async (communityId, userIds) => {
     const { data } = await client.http.delete(`/api/v3/communities/${communityId}/users`, { data: { communityId, userIds } });
     if (client.cache)
         ingestInCache(data);
-    fireEvent('community.userRemoved', {
-        communities: data.communities,
-    });
+    fireEvent('community.userRemoved', data);
     const { communityUsers } = data;
     return !!communityUsers.find(communityUser => communityUser.communityId === communityId &&
         communityUser.communityMembership !== 'member');
@@ -17381,7 +17361,7 @@ const deletePost = async (postId, permanent = false) => {
     client.log('post/deletePost', postId);
     let post = await getPost(postId);
     // API-FIX: This endpoint has not been implemented yet.
-    await client.http.delete(`/api/v4/posts/${postId}`, {
+    await client.http.delete(`/api/v4/posts/${encodeURIComponent(postId)}`, {
         params: {
             postId,
             permanent,
@@ -17509,8 +17489,9 @@ queryComments.locally = (query) => {
 const getComments = async (commentIds) => {
     const client = getActiveClient();
     client.log('comment/getComments', commentIds);
+    const encodedCommentIds = commentIds.map(commentId => encodeURIComponent(commentId));
     // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data } = await client.http.get(`/api/v3/comments/list`, { params: { commentIds } });
+    const { data } = await client.http.get(`/api/v3/comments/list`, { params: { commentIds: encodedCommentIds } });
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -17572,7 +17553,7 @@ const getComment = async (commentId) => {
     let data;
     try {
         // API-FIX: endpoint should not be /list, parameters should be querystring.
-        const response = await client.http.get(`/api/v3/comments/${commentId}`);
+        const response = await client.http.get(`/api/v3/comments/${encodeURIComponent(commentId)}`);
         data = response.data;
     }
     catch (error) {
@@ -17668,7 +17649,7 @@ const createComment = async (bundle) => {
 const updateComment = async (commentId, patch) => {
     const client = getActiveClient();
     client.log('user/updateComment', patch);
-    const { data } = await client.http.put(`/api/v3/comments/${commentId}`, patch);
+    const { data } = await client.http.put(`/api/v3/comments/${encodeURIComponent(commentId)}`, patch);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -17699,7 +17680,7 @@ const deleteComment = async (commentId, permanent = false) => {
     client.log('comment/deleteComment', commentId);
     const comment = await getComment(commentId);
     // API-FIX: This endpoint has not been implemented yet.
-    await client.http.delete(`/api/v4/comments/${commentId}`, {
+    await client.http.delete(`/api/v4/comments/${encodeURIComponent(commentId)}`, {
         params: {
             commentId,
             permanent,
@@ -17902,16 +17883,12 @@ const createPostEventSubscriber = (event, callback) => {
             callback(payload.posts[0]);
         }
         else {
-            const cached = pullFromCache(['post', 'get', payload.posts[0].postId]);
             const { communities } = payload, others = __rest(payload, ["communities"]);
             ingestInCache(others);
-            if (communities === null || communities === void 0 ? void 0 : communities[0]) {
+            if ((communities === null || communities === void 0 ? void 0 : communities[0]) && !['post.updated'].includes(event)) {
                 fireEvent('community.updated', { communities });
             }
             const post = pullFromCache(['post', 'get', payload.posts[0].postId]);
-            if (cached && isMatch(cached.data, post.data)) {
-                return;
-            }
             if (['post.created', 'post.approved', 'post.declined'].includes(event)) {
                 let queries = (_a = queryCache(['post', 'query'])) === null || _a === void 0 ? void 0 : _a.filter(({ key }) => { var _a; return ((_a = key[2]) === null || _a === void 0 ? void 0 : _a.targetId) === post.data.targetId; });
                 if (event === 'post.declined') {
@@ -18067,14 +18044,10 @@ const onPostReactionAdded = (callback) => {
             callback(payload.posts[0]);
         }
         else {
-            const cached = pullFromCache(['post', 'get', payload.posts[0].postId]);
             preparePayloadForCache('post.addReaction', payload);
             const postPayload = __rest(payload, ["reactor"]);
             ingestInCache(postPayload);
             const post = pullFromCache(['post', 'get', payload.posts[0].postId]);
-            if (cached && isMatch(cached.data, post.data)) {
-                return;
-            }
             callback(post.data);
         }
     };
@@ -18103,14 +18076,10 @@ const onPostReactionRemoved = (callback) => {
             callback(payload.posts[0]);
         }
         else {
-            const cached = pullFromCache(['post', 'get', payload.posts[0].postId]);
             preparePayloadForCache('post.removeReaction', payload);
             const postPayload = __rest(payload, ["reactor"]);
             ingestInCache(postPayload);
             const post = pullFromCache(['post', 'get', payload.posts[0].postId]);
-            if (cached && isMatch(cached.data, post.data)) {
-                return;
-            }
             callback(post.data);
         }
     };
@@ -18122,15 +18091,12 @@ const createCommentEventSubscriber = (event, callback) => {
     const filter = (payload) => {
         var _a;
         if (!client.cache) {
+            // TODO: here we are missing specific properties here!
             callback(payload.comments[0]);
         }
         else {
-            const cached = pullFromCache(['comment', 'get', payload.comments[0].commentId]);
             ingestInCache(payload);
             const comment = pullFromCache(['comment', 'get', payload.comments[0].commentId]);
-            if (cached && isMatch(cached.data, comment.data)) {
-                return;
-            }
             if (['comment.created'].includes(event)) {
                 const queries = (_a = queryCache(['comment', 'query'])) === null || _a === void 0 ? void 0 : _a.filter(({ key }) => { var _a; return ((_a = key[2]) === null || _a === void 0 ? void 0 : _a.referenceId) === comment.data.referenceId; });
                 queries === null || queries === void 0 ? void 0 : queries.map(({ key, data }) => upsertInCache(key, data, { cachedAt: -1 }));
@@ -18248,14 +18214,10 @@ const onCommentReactionAdded = (callback) => {
             callback(payload.comments[0]);
         }
         else {
-            const cached = pullFromCache(['comment', 'get', payload.comments[0].commentId]);
             preparePayloadForCache('comment.addReaction', payload);
             const commentPayload = __rest(payload, ["reactor"]);
             ingestInCache(commentPayload);
             const comment = pullFromCache(['comment', 'get', payload.comments[0].commentId]);
-            if (cached && isMatch(cached.data, comment.data)) {
-                return;
-            }
             callback(comment.data);
         }
     };
@@ -18284,14 +18246,10 @@ const onCommentReactionRemoved = (callback) => {
             callback(payload.comments[0]);
         }
         else {
-            const cached = pullFromCache(['comment', 'get', payload.comments[0].commentId]);
             preparePayloadForCache('comment.removeReaction', payload);
             const commentPayload = __rest(payload, ["reactor"]);
             ingestInCache(commentPayload);
             const comment = pullFromCache(['comment', 'get', payload.comments[0].commentId]);
-            if (cached && isMatch(cached.data, comment.data)) {
-                return;
-            }
             callback(comment.data);
         }
     };
@@ -18380,12 +18338,12 @@ const createReport = async (referenceType, referenceId) => {
     const client = getActiveClient();
     client.log('report/createReport', { referenceType, referenceId });
     const { domainName } = REFERENCE_TYPES[referenceType];
-    const { data } = await client.http.post(`/api/v3/${domainName}/${referenceId}/flag`);
+    const { data } = await client.http.post(`/api/v3/${domainName}/${(encodeURIComponent(referenceId))}/flag`);
     if (client.cache)
         ingestInCache(data);
     const event = referenceType === 'message'
         ? 'v3.message.didUpdate'
-        : `${referenceType}.updated`;
+        : `${referenceType}.flagged`;
     fireEvent(event, data);
     return !!data;
 };
@@ -18407,12 +18365,12 @@ const deleteReport = async (referenceType, referenceId) => {
     const client = getActiveClient();
     client.log('report/deleteReport', { referenceType, referenceId });
     const { domainName } = REFERENCE_TYPES[referenceType];
-    const { data } = await client.http.delete(`/api/v3/${domainName}/${referenceId}/unflag`);
+    const { data } = await client.http.delete(`/api/v3/${domainName}/${encodeURIComponent(referenceId)}/unflag`);
     if (client.cache)
         ingestInCache(data);
     const event = referenceType === 'message'
         ? 'v3.message.didUpdate'
-        : `${referenceType}.updated`;
+        : `${referenceType}.unflagged`;
     fireEvent(event, data);
     return !!data;
 };
@@ -18515,8 +18473,9 @@ queryChannels.locally = (query) => {
 const getChannels = async (channelIds) => {
     const client = getActiveClient();
     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`, { params: { channelIds } });
+    const { data } = await client.http.get(`/api/v3/channels/list`, { params: { channelIds: encodedChannelIds } });
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -18575,7 +18534,7 @@ 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/${channelId}`);
+    const { data } = await client.http.get(`/api/v3/channels/${encodeURIComponent(channelId)}`);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -18664,7 +18623,7 @@ 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/${channelId}`, patch);
+    const { data } = await client.http.put(`/api/v3/channels/${encodeURIComponent(channelId)}`, patch);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
         ingestInCache(data, { cachedAt });
@@ -18693,7 +18652,7 @@ const deleteChannel = async (channelId) => {
     const client = getActiveClient();
     client.log('channel/deleteChannel', channelId);
     // API-FIX: This endpoint has not been implemented yet.
-    await client.http.delete(`/api/v3/channels/${channelId}`);
+    await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}`);
     const deleted = await getChannel(channelId);
     // no need for event, fired by server
     return deleted.data;
@@ -18716,7 +18675,7 @@ 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/${channelId}/join`);
+    const { data } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/join`);
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -18741,7 +18700,7 @@ 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/${channelId}/leave`);
+    const { data } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/leave`);
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -18767,19 +18726,20 @@ const queryChannelMembers = async (query) => {
     const client = getActiveClient();
     client.log('channel/queryChannelMembers', query);
     const _a = query !== null && query !== void 0 ? query : {}, { page, channelId, membership } = _a, params = __rest(_a, ["page", "channelId", "membership"]);
-    const { data } = await client.http.get(`/api/v3/channels/${channelId}/users`, {
+    const { data } = await client.http.get(`/api/v3/channels/${encodeURIComponent(channelId)}/users`, {
         params: Object.assign(Object.assign({}, params), { filter: membership, options: {
                 token: toToken(page, 'skiplimit'),
             } }),
     });
     const { paging } = data, payload = __rest(data, ["paging"]);
     const { channelUsers } = payload;
+    const cachedAt = client.cache && Date.now();
     if (client.cache) {
         ingestInCache(payload);
     }
     const nextPage = toPage(paging.next);
     const prevPage = toPage(paging.previous);
-    return { data: channelUsers, nextPage, prevPage };
+    return { data: channelUsers, cachedAt, nextPage, prevPage };
 };
 /**
  * ```js
@@ -18818,7 +18778,7 @@ 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/${channelId}/users`, { channelId, userIds });
+    const { data } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/users`, { channelId, userIds });
     if (client.cache)
         ingestInCache(data);
     fireEvent('v3.channel.didAddUsers', {
@@ -18846,7 +18806,7 @@ 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/${channelId}/users`, { data: { channelId, userIds } });
+    const { data } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/users`, { data: { channelId, userIds } });
     if (client.cache)
         ingestInCache(data);
     fireEvent('v3.channel.didRemoveUsers', {
@@ -18875,7 +18835,7 @@ 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/${channelId}/users/roles`, { channelId, role: roleId, userIds });
+    const { data } = await client.http.post(`/api/v3/channels/${encodeURIComponent(channelId)}/users/roles`, { channelId, role: roleId, userIds });
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -18901,7 +18861,7 @@ 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/${channelId}/users/roles`, { data: { channelId, role: roleId, userIds } });
+    const { data } = await client.http.delete(`/api/v3/channels/${encodeURIComponent(channelId)}/users/roles`, { data: { channelId, role: roleId, userIds } });
     if (client.cache)
         ingestInCache(data);
     const { channelUsers } = data;
@@ -19252,15 +19212,12 @@ const createCommunityEventSubscriber = (event, callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
         if (!client.cache) {
+            // TODO: here we are missing specific properties here!
             callback(payload.communities[0]);
         }
         else {
-            const cached = pullFromCache(['community', 'get', payload.communities[0].communityId]);
             ingestInCache(payload);
             const community = pullFromCache(['community', 'get', payload.communities[0].communityId]);
-            if (cached && isMatch(cached.data, community === null || community === void 0 ? void 0 : community.data)) {
-                return;
-            }
             callback(community.data);
         }
     };
@@ -19295,24 +19252,20 @@ function getEventRelatedMember(event, payload) {
 const createCommunityMemberEventSubscriber = (event, callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
-        const cachedCommunity = pullFromCache(['community', 'get', payload.communities[0].communityId]);
-        const cachedMember = pullFromCache([
-            'communityUsers',
-            'get',
-            getResolver('communityUsers')(getEventRelatedMember(event, payload))
-        ]);
-        ingestInCache(payload);
-        const community = pullFromCache(['community', 'get', payload.communities[0].communityId]);
-        const member = pullFromCache([
-            'communityUsers',
-            'get',
-            getResolver('communityUsers')(getEventRelatedMember(event, payload))
-        ]);
-        if (cachedCommunity && isMatch(cachedCommunity.data, community.data)
-            && cachedMember && isMatch(cachedMember.data, member.data)) {
-            return;
+        if (!client.cache) {
+            // TODO: here we are missing specific properties here!
+            callback(payload.communities[0], getEventRelatedMember(event, payload));
+        }
+        else {
+            ingestInCache(payload);
+            const community = pullFromCache(['community', 'get', payload.communities[0].communityId]);
+            const member = pullFromCache([
+                'communityUsers',
+                'get',
+                getResolver('communityUsers')(getEventRelatedMember(event, payload))
+            ]);
+            callback(community.data, member.data);
         }
-        callback(community.data, member.data);
     };
     return createEventSubscriber(client, event, event, filter);
 };
@@ -19531,17 +19484,56 @@ const observeCommunity = (communityId, callback) => {
 const queryGlobalFeed = async (query) => {
     const client = getActiveClient();
     client.log('feed/queryGlobalFeed', query);
-    const _a = query !== null && query !== void 0 ? query : {}, { page } = _a, params = __rest(_a, ["page"]);
-    const { data } = await client.http.get(`/api/v4/me/global-feeds`, { params: Object.assign(Object.assign({}, params), { options: {
+    const _a = query !== null && query !== void 0 ? query : {}, { useCustomRanking, page } = _a, params = __rest(_a, ["useCustomRanking", "page"]);
+    const { data } = await client.http.get(useCustomRanking ? `/api/v5/me/global-feeds` : `/api/v4/me/global-feeds`, { params: Object.assign(Object.assign({}, params), { options: {
                 token: toToken(page, 'skiplimit')
             } }) });
     const { paging } = data, payload = __rest(data, ["paging"]);
     const { posts } = payload;
-    if (client.cache)
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
         ingestInCache(payload);
+        const cacheKey = ['globalFeed', 'query', Object.assign(Object.assign({}, params), { useCustomRanking, options: Object.assign({}, page) })];
+        pushToCache(cacheKey, { posts: posts.map(getResolver('post')), paging });
+    }
     const nextPage = toPage(paging.next);
     const prevPage = toPage(paging.previous);
-    return { data: posts, prevPage, nextPage };
+    return { data: posts, cachedAt, prevPage, nextPage };
+};
+/**
+ * ```js
+ * import { queryGlobalFeed } from '@amityco/ts-sdk'
+ * const posts = await queryGlobalFeed.locally()
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.Post} objects from cache
+ *
+ * @param query The query parameters
+ * @returns A page of {@link Amity.Post} objects
+ *
+ * @category Feed API
+ * @async
+ **/
+queryGlobalFeed.locally = (query) => {
+    var _a, _b;
+    const client = getActiveClient();
+    client.log('post/queryGlobalFeed.locally', query);
+    if (!client.cache)
+        return;
+    const _c = query !== null && query !== void 0 ? query : {}, { useCustomRanking, page } = _c, params = __rest(_c, ["useCustomRanking", "page"]);
+    const queryKey = ['globalFeed', 'query', Object.assign(Object.assign({}, params), { useCustomRanking, options: Object.assign({}, page) })];
+    const { data, cachedAt } = (_a = pullFromCache(queryKey)) !== null && _a !== void 0 ? _a : {};
+    if (!(data === null || data === void 0 ? void 0 : data.posts.length))
+        return;
+    const posts = data.posts
+        .map(postId => pullFromCache(['post', 'get', postId]))
+        .filter(Boolean)
+        .map(({ data }) => data);
+    const prevPage = toPage(data === null || data === void 0 ? void 0 : data.paging.previous);
+    const nextPage = toPage(data === null || data === void 0 ? void 0 : data.paging.next);
+    return posts.length === ((_b = data === null || data === void 0 ? void 0 : data.posts) === null || _b === void 0 ? void 0 : _b.length)
+        ? { data: posts, cachedAt, prevPage, nextPage }
+        : undefined;
 };
 
 /**
@@ -20002,4 +19994,4 @@ const onStreamRecorded = (callback) => {
     return createEventSubscriber(client, 'stream/onStreamRecorded', 'video-streaming.didRecord', filter);
 };
 
-export { SubscriptionLevels, VERSION$1 as VERSION, addChannelMembers, addChannelMembersRole, addCommunityMembers, addCommunityMembersRole, addReaction, backupCache, connectClient, createChannel, createClient, createComment, createCommunity, createFile, createMessage, createPost, createQuery, createReport, createStream, deleteChannel, deleteComment, deleteCommunity, deleteFile, deleteMessage, deletePost, deleteReport, deleteStream, disableCache, disconnectClient, disposeStream, dropFromCache, enableCache, fileUrlWithSize, filterByPropEquality, getActiveClient, getChannel, getChannels, getComment, getCommentTopic, getComments, getCommunities, getCommunity, getCommunityTopic, getFile, getMessage, getMessages, getPost, getPostTopic, getPosts, getRole, getStream, getUser, getUserTopic, getUsers, isAfterBefore, isAfterBeforeRaw, isCachable, isConnected, isFetcher, isFresh, isLocal, isMutator, isOffline, isPaged, isReportedByMe, isSkipLimit, joinChannel, joinCommunity, leaveChannel, leaveCommunity, mergeInCache, observeChannel, observeComment, observeComments, observeCommunity, observeFile, observeMessage, observeMessages, observePost, observePosts, observeUser, onChannelDeleted, onChannelJoined, onChannelLeft, onChannelUpdated, onClientBanned, onClientDisconnected, onCommentCreated, onCommentDeleted, onCommentFlagged, onCommentReactionAdded, onCommentReactionRemoved, onCommentUnflagged, onCommentUpdated, onCommunityCreated, onCommunityDeleted, onCommunityJoined, onCommunityLeft, onCommunityUpdated, onCommunityUserAdded, onCommunityUserBanned, onCommunityUserRemoved, onCommunityUserUnbanned, onConnectionError, onMemberAdded, onMemberRemoved, onMessageCreated, onMessageDeleted, onMessageUpdated, onPostApproved, onPostCreated, onPostDeclined, onPostDeleted, onPostFlagged, onPostReactionAdded, onPostReactionRemoved, onPostUnflagged, onPostUpdated, onReactionRemoved, onStreamRecorded, onStreamStarted, onStreamStopped, onUserFlagCleared, onUserFlagged, onUserUnflagged, onUserUpdated, pullFromCache, pushToCache, queryCache, queryChannelMembers, queryChannels, queryComments, queryCommunities, queryCommunityMembers, queryGlobalFeed, queryMessages, queryOptions, queryPosts, queryRoles, queryStreams, queryUsers, removeChannelMembers, removeChannelMembersRole, removeCommunityMembers, removeCommunityMembersRole, removeReaction, restoreCache, runQuery, sliceByPaging, sortByChannelSegment, sortByDisplayName, sortByFirstCreated, sortByLastActivity, sortByLastCreated, sortBySegmentNumber, subscribeTopic, toPage, toPageRaw, toToken, updateChannel, updateComment, updateCommunity, updateMessage, updatePost, updateStream, updateUser, upsertInCache, wipeCache };
+export { SubscriptionLevels, VERSION$1 as VERSION, addChannelMembers, addChannelMembersRole, addCommunityMembers, addCommunityMembersRole, addReaction, backupCache, connectClient, createChannel, createClient, createComment, createCommunity, createFile, createMessage, createPost, createQuery, createReport, createStream, deleteChannel, deleteComment, deleteCommunity, deleteFile, deleteMessage, deletePost, deleteReport, deleteStream, disableCache, disconnectClient, disposeStream, dropFromCache, enableCache, fileUrlWithSize, filterByPropEquality, getActiveClient, getChannel, getChannels, getComment, getCommentTopic, getComments, getCommunities, getCommunity, getCommunityTopic, getFile, getMessage, getMessages, getPost, getPostTopic, getPosts, getRole, getStream, getUser, getUserTopic, getUsers, isAfterBefore, isAfterBeforeRaw, isCachable, isConnected, isFetcher, isFresh, isLocal, isMutator, isOffline, isPaged, isReportedByMe, isSkipLimit, joinChannel, joinCommunity, leaveChannel, leaveCommunity, mergeInCache, observeChannel, observeComment, observeComments, observeCommunity, observeFile, observeMessage, observeMessages, observePost, observePosts, observeUser, onChannelDeleted, onChannelJoined, onChannelLeft, onChannelUpdated, onClientBanned, onClientDisconnected, onCommentCreated, onCommentDeleted, onCommentFlagged, onCommentReactionAdded, onCommentReactionRemoved, onCommentUnflagged, onCommentUpdated, onCommunityCreated, onCommunityDeleted, onCommunityJoined, onCommunityLeft, onCommunityUpdated, onCommunityUserAdded, onCommunityUserBanned, onCommunityUserRemoved, onCommunityUserUnbanned, onConnectionError, onMemberAdded, onMemberRemoved, onMessageCreated, onMessageDeleted, onMessageUpdated, onPostApproved, onPostCreated, onPostDeclined, onPostDeleted, onPostFlagged, onPostReactionAdded, onPostReactionRemoved, onPostUnflagged, onPostUpdated, onReactionRemoved, onStreamRecorded, onStreamStarted, onStreamStopped, onUserFlagCleared, onUserFlagged, onUserUnflagged, onUserUpdated, pullFromCache, pushToCache, queryCache, queryChannelMembers, queryChannels, queryComments, queryCommunities, queryCommunityMembers, queryGlobalFeed, queryMessages, queryOptions, queryPosts, queryRoles, queryStreams, queryUsers, removeChannelMembers, removeChannelMembersRole, removeCommunityMembers, removeCommunityMembersRole, removeReaction, restoreCache, runQuery, sortByChannelSegment, sortByDisplayName, sortByFirstCreated, sortByLastActivity, sortByLastCreated, sortBySegmentNumber, subscribeTopic, toPage, toPageRaw, toToken, updateChannel, updateComment, updateCommunity, updateMessage, updatePost, updateStream, updateUser, upsertInCache, wipeCache };