@amityco/ts-sdk 6.4.6-e12bdf9.0 → 6.5.1-24920fb.0

package/dist/index.cjs.js

@@ -96,8 +96,8 @@ const PostContentType = Object.freeze({
 
 function getVersion() {
     try {
-        // the string ''v6.4.5-cjs'' should be replaced by actual value by @rollup/plugin-replace
-        return 'v6.4.5-cjs';
+        // the string ''v6.5.0-cjs'' should be replaced by actual value by @rollup/plugin-replace
+        return 'v6.5.0-cjs';
     }
     catch (error) {
         return '__dev__';
@@ -524,7 +524,8 @@ const idResolvers = {
     post: ({ postId }) => postId,
     comment: ({ commentId }) => commentId,
     poll: ({ pollId }) => pollId,
-    reaction: ({ reactionId }) => reactionId,
+    reaction: ({ referenceType, referenceId }) => `${referenceType}#${referenceId}`,
+    reactor: ({ reactionId }) => reactionId,
     stream: ({ streamId }) => streamId,
     follow: ({ from, to }) => `${from}#${to}`,
     followInfo: ({ userId }) => userId,
@@ -551,10 +552,10 @@ const getResolver = (name) => idResolvers[name];
  */
 const CRITERIAS = {
     file: ['fileId', 'attributes'],
-    user: ['userId', 'avatarFileId'],
+    user: ['userId', 'avatarFileId', 'roles', 'permissions'],
     role: ['roleId'],
-    channel: ['channelId', 'rateLimit'],
-    subChannel: ['subChannelId'],
+    channel: ['channelId', 'defaultSubChannelId'],
+    subChannel: ['subChannelId', 'latestMessageId'],
     channelUsers: ['channelId', 'userId', 'membership'],
     message: ['messageId'],
     community: ['communityId', 'postSetting'],
@@ -563,7 +564,8 @@ const CRITERIAS = {
     post: ['postId', 'feedId'],
     comment: ['commentId', 'referenceId'],
     poll: ['pollId'],
-    reaction: ['reactionId'],
+    reaction: ['referenceId', 'referenceType', 'reactors'],
+    reactor: ['reactionId'],
     stream: ['streamId'],
     follow: ['from', 'to'],
     feed: ['feedId', 'feedType'],
@@ -22564,12 +22566,8 @@ const getTotalUnreadCount = (callback) => {
     if (!userId)
         throw new ASCError('The _id has not been defined in ActiveUser', 800000 /* Amity.ClientError.UNKNOWN_ERROR */, "error" /* Amity.ErrorLevel.ERROR */);
     const callbackDataSelector = (data) => { var _a; return (_a = data === null || data === void 0 ? void 0 : data.unreadCount) !== null && _a !== void 0 ? _a : 0; };
-    // based on the mobile specs, unreadCount will not trigger observer when userMarker
-    // is re-fetched, so apply this filter to ensure the behavior is the same.
-    const callbackFilter = (newModel, oldModel) => (newModel === null || newModel === void 0 ? void 0 : newModel.unreadCount) !== (oldModel === null || oldModel === void 0 ? void 0 : oldModel.unreadCount);
     return liveObject(userId, callback, 'userId', getUserMarker, [onUserMarkerFetched], {
         callbackDataSelector,
-        callbackFilter,
     });
 };
 
@@ -23616,6 +23614,38 @@ queryChannelMembers.locally = (query) => {
         : undefined;
 };
 
+/*
+ * Exported for testing
+ * @hidden
+ */
+const applyFilter$2 = (data, params) => {
+    let channelMembers = filterByPropIntersection(data, 'roles', params.roles);
+    if (params.memberships) {
+        /*
+         * even though membership includes muted as a possible value
+         * when querying the server.
+         * Muted is specified under seperarte property namely isMuted
+         * Hence why I've seperately checked for it's equality
+         */
+        channelMembers = channelMembers.filter(member => {
+            // @ts-ignore
+            if (params.memberships.includes('muted') && member.isMuted) {
+                return true;
+            }
+            // @ts-ignore
+            return params.memberships.includes(member.membership);
+        });
+    }
+    if (params.search) {
+        // eslint-disable-next-line no-console
+        console.warn('`search` param will be deprecated in the next major release. If you want to search channel members by displayName, Please use `searchMembers()` instead.');
+        channelMembers = filterBySearchTerm(channelMembers, params.search);
+    }
+    // sort, 'lastCreated' is the default sort order
+    const sortBy = params.sortBy ? params.sortBy : 'lastCreated';
+    channelMembers = channelMembers.sort(sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
+    return channelMembers;
+};
 /* begin_public_function
   id: channel.member.query
 */
@@ -23640,6 +23670,7 @@ queryChannelMembers.locally = (query) => {
 const getMembers$1 = (params, callback, config) => {
     const { log, cache } = getActiveClient();
     if (!cache) {
+        // eslint-disable-next-line no-console
         console.log(ENABLE_CACHE_MESSAGE);
     }
     const timestamp = Date.now();
@@ -23649,34 +23680,6 @@ const getMembers$1 = (params, callback, config) => {
     const { policy = COLLECTION_DEFAULT_CACHING_POLICY } = config !== null && config !== void 0 ? config : {};
     const disposers = [];
     const cacheKey = ['channelUsers', 'collection', { channelId: params.channelId }];
-    const applyFilter = (data) => {
-        let channelMembers = filterByPropIntersection(data, 'roles', params.roles);
-        if (params.memberships) {
-            /*
-             * even though membership includes muted as a possible value
-             * when querying the server.
-             * Muted is specified under seperarte property namely isMuted
-             * Hence why I've seperately checked for it's equality
-             */
-            channelMembers = channelMembers.filter(member => {
-                // @ts-ignore
-                if (params.memberships.includes('muted') && member.isMuted) {
-                    return true;
-                }
-                // @ts-ignore
-                return params.memberships.includes(member.membership);
-            });
-        }
-        if (params.search) {
-            // eslint-disable-next-line no-console
-            console.warn('`search` param will be deprecated in the next major release. If you want to search channel members by displayName, Please use `searchMembers()` instead.');
-            channelMembers = filterBySearchTerm(channelMembers, params.search);
-        }
-        // sort, 'lastCreated' is the default sort order
-        const sortBy = params.sortBy ? params.sortBy : 'lastCreated';
-        channelMembers = channelMembers.sort(sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
-        return channelMembers;
-    };
     const responder = (data, isEventModel = false) => {
         var _a, _b;
         const channelMembers = (_a = data.data
@@ -23688,7 +23691,7 @@ const getMembers$1 = (params, callback, config) => {
             /*
              * Only apply filter to RTE Model
              */
-            data: isEventModel ? applyFilter(channelMembers) : channelMembers,
+            data: isEventModel ? applyFilter$2(channelMembers, params) : channelMembers,
             hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
             loading: data.loading,
             error: data.error,
@@ -23776,6 +23779,7 @@ var index$i = /*#__PURE__*/Object.freeze({
   __proto__: null,
   addMembers: addMembers$1,
   removeMembers: removeMembers$1,
+  applyFilter: applyFilter$2,
   getMembers: getMembers$1,
   searchMembers: searchMembers
 });
@@ -24313,6 +24317,7 @@ const onSubChannelDeleted = (callback) => {
 };
 
 const SYNC_TRIGGER_INTERVAL_TIME = 2000;
+const ON_SUB_CHANNEL_DELETE_SYNC_TRIGGER_DELAY = 2000;
 let clearSyncTrigger;
 let disposers = [];
 let isWaitingForResponse = false;
@@ -24403,7 +24408,13 @@ const registerEventListeners = () => {
     }, 
     // only trigger sync from remote events to prevent an unread count equal `-1`
     // when an optimistic message creation is performed.
-    false), onChannelCreated(() => events.push("subchannel is created" /* Amity.MarkerSyncEvent.CHANNEL_CREATED */)), onChannelDeleted(() => events.push("subchannel is deleted" /* Amity.MarkerSyncEvent.CHANNEL_DELETED */)), onChannelJoined(() => events.push("subchannel is joined" /* Amity.MarkerSyncEvent.CHANNEL_JOINED */)), onChannelLeft(() => events.push("subchannel is left" /* Amity.MarkerSyncEvent.CHANNEL_LEFT */)), onSubChannelCreated(() => events.push("subchannel is created" /* Amity.MarkerSyncEvent.SUB_CHANNEL_CREATED */)), onSubChannelDeleted(() => events.push("subchannel is deleted" /* Amity.MarkerSyncEvent.SUBCHANNEL_IS_DELETED */)), onFeedMarkerUpdated(() => events.push("feed marker updated" /* Amity.MarkerSyncEvent.MARKER_UPDATED */)), onUserMarkerSync(() => events.push("feed marker updated" /* Amity.MarkerSyncEvent.MARKER_UPDATED */)));
+    false), onChannelCreated(() => events.push("subchannel is created" /* Amity.MarkerSyncEvent.CHANNEL_CREATED */)), onChannelDeleted(() => events.push("subchannel is deleted" /* Amity.MarkerSyncEvent.CHANNEL_DELETED */)), onChannelJoined(() => events.push("subchannel is joined" /* Amity.MarkerSyncEvent.CHANNEL_JOINED */)), onChannelLeft(() => events.push("subchannel is left" /* Amity.MarkerSyncEvent.CHANNEL_LEFT */)), onSubChannelCreated(() => events.push("subchannel is created" /* Amity.MarkerSyncEvent.SUB_CHANNEL_CREATED */)), onSubChannelDeleted(() => 
+    /*
+     workaround: when receiving the event for sub-channel deletion,
+     before triggering marker update, the SDK will have to add a 2-second delay.
+     so that the unread count is calculated correctly.
+    */
+    setTimeout(() => events.push("subchannel is deleted" /* Amity.MarkerSyncEvent.SUBCHANNEL_IS_DELETED */), ON_SUB_CHANNEL_DELETE_SYNC_TRIGGER_DELAY)), onFeedMarkerUpdated(() => events.push("feed marker updated" /* Amity.MarkerSyncEvent.MARKER_UPDATED */)), onUserMarkerSync(() => events.push("feed marker updated" /* Amity.MarkerSyncEvent.MARKER_UPDATED */)));
 };
 const unRegisterEventListeners = () => {
     disposers.forEach(fn => fn());
@@ -26092,6 +26103,28 @@ queryUsers.locally = (query = {}) => {
         : undefined;
 };
 
+/*
+ * Exported for testing
+ * @hidden
+ */
+const applyFilter$1 = (data, params) => {
+    let users = filterByPropEquality(data, 'displayName', params.displayName);
+    switch (params.sortBy) {
+        case 'firstCreated':
+            users = users.sort(sortByFirstCreated);
+            break;
+        case 'lastCreated':
+            users = users.sort(sortByLastCreated);
+            break;
+        default:
+            users = users
+                // this needs to be aligned with the backend data type
+                .map(u => (u.displayName ? u : Object.assign(Object.assign({}, u), { displayName: '' })))
+                // @ts-ignore
+                .sort(sortByDisplayName);
+    }
+    return users;
+};
 /* begin_public_function
   id: user.query
 */
@@ -26114,6 +26147,7 @@ queryUsers.locally = (query = {}) => {
 const getUsers = (params, callback, config) => {
     const { log, cache } = getActiveClient();
     if (!cache) {
+        // eslint-disable-next-line no-console
         console.log(ENABLE_CACHE_MESSAGE);
     }
     const timestamp = Date.now();
@@ -26123,24 +26157,6 @@ const getUsers = (params, callback, config) => {
     const { policy = COLLECTION_DEFAULT_CACHING_POLICY } = config !== null && config !== void 0 ? config : {};
     const disposers = [];
     const cacheKey = ['user', 'collection', {}];
-    const applyFilter = (data) => {
-        let users = filterByPropEquality(data, 'displayName', params.displayName);
-        switch (params.sortBy) {
-            case 'firstCreated':
-                users = users.sort(sortByFirstCreated);
-                break;
-            case 'lastCreated':
-                users = users.sort(sortByLastCreated);
-                break;
-            default:
-                users = users
-                    // this needs to be aligned with the backend data type
-                    .map(u => (u.displayName ? u : Object.assign(Object.assign({}, u), { displayName: '' })))
-                    // @ts-ignore
-                    .sort(sortByDisplayName);
-        }
-        return users;
-    };
     const responder = (data, isEventModel = false) => {
         var _a, _b;
         const users = (_a = data.data
@@ -26152,7 +26168,7 @@ const getUsers = (params, callback, config) => {
             /*
              * Only apply filter to RTE Model
              */
-            data: isEventModel ? applyFilter(users) : users,
+            data: isEventModel ? applyFilter$1(users, params) : users,
             hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
             loading: data.loading,
             error: data.error,
@@ -27856,7 +27872,7 @@ const onReactorRemoved = (referenceType, referenceId, callback) => {
  * })
  * ```
  *
- * Queries a paginable list of {@link Amity.ReactionQuery} objects
+ * Queries a paginable list of {@link Amity.Reaction} objects
  *
  * @param query The query parameters
  * @returns A page of {@link Amity.Reaction} objects
@@ -27883,6 +27899,30 @@ const queryReactions = async (query) => {
     return { data: reactions, prevPage, nextPage };
 };
 
+/**
+ * ```js
+ * import { queryReactor } from '@amityco/ts-sdk'
+ * const { data: reactions, prevPage, nextPage } = await queryReactor({
+ *   referenceId: 'postId',
+ *   referenceType: 'post',
+ * })
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.Reactor} objects
+ *
+ * @param query The query parameters
+ * @returns A page of {@link Amity.Reactor} objects
+ *
+ * @reaction Reaction API
+ * @async
+ * */
+const queryReactor = async (query) => {
+    const client = getActiveClient();
+    client.log('reaction/queryReactor', query);
+    const _a = await queryReactions(query), { data } = _a, response = __rest(_a, ["data"]);
+    return Object.assign(Object.assign({}, response), { data: data[0].reactors });
+};
+
 /* begin_public_function
   id: reaction.query
 */
@@ -27897,11 +27937,11 @@ const queryReactions = async (query) => {
  * }, response => merge(reactions, response.data))
  * ```
  *
- * Observe all mutations on a list of {@link Amity.Reaction} for a given target object
+ * Observe all mutations on a list of {@link Amity.Reactor} for a given target object
  *
- * @param params.referenceType the type of the target
- * @param params.referenceId the ID of the target
+ * @param params for querying reactions
  * @param callback the function to call when new data are available
+ * @param config the live collection configuration
  * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the messages
  *
  * @category Reactions Live Collection
@@ -27956,7 +27996,7 @@ const getReactions = (params, callback, config) => {
         const reactions = (_b = collection === null || collection === void 0 ? void 0 : collection.data) !== null && _b !== void 0 ? _b : [];
         if (!initial && reactions.length > 0 && !((_c = collection === null || collection === void 0 ? void 0 : collection.params) === null || _c === void 0 ? void 0 : _c.page))
             return;
-        const query = createQuery(queryReactions, Object.assign(Object.assign({}, queryParams), { page: (_d = (!initial ? collection === null || collection === void 0 ? void 0 : collection.params.page : undefined)) !== null && _d !== void 0 ? _d : { limit } }));
+        const query = createQuery(queryReactor, Object.assign(Object.assign({}, queryParams), { page: (_d = (!initial ? collection === null || collection === void 0 ? void 0 : collection.params.page : undefined)) !== null && _d !== void 0 ? _d : { limit } }));
         runQuery(query, ({ data: result, error, loading, nextPage: page }) => {
             const data = {
                 loading,
@@ -27965,9 +28005,7 @@ const getReactions = (params, callback, config) => {
                 data: reactions,
             };
             if (result) {
-                data.data = [
-                    ...new Set([...reactions, ...result[0].reactors.map(getResolver('reaction'))]),
-                ];
+                data.data = [...new Set([...reactions, ...result.map(getResolver('reactor'))])];
             }
             pushToCache(cacheKey, data);
             responder(data);
@@ -29727,8 +29765,8 @@ const updateCommunity = async (communityId, patch) => {
 
 /**
  * ```js
- * import { getCommunity } from '@amityco/ts-sdk'
- * const community = await getCommunity('foobar')
+ * import { CommunityRepository } from '@amityco/ts-sdk'
+ * const community = await CommunityRepository.getCommunity('foobar')
  * ```
  *
  * Fetches a {@link Amity.Community} object
@@ -29756,8 +29794,8 @@ const getCommunity$1 = async (communityId) => {
 };
 /**
  * ```js
- * import { getCommunity } from '@amityco/ts-sdk'
- * const community = getCommunity.locally('foobar')
+ * import { CommunityRepository } from '@amityco/ts-sdk'
+ * const community = CommunityRepository.getCommunity.locally('foobar')
  * ```
  *
  * Fetches a {@link Amity.Community} object from cache
@@ -29882,9 +29920,12 @@ const leaveCommunity = async (communityId) => {
   id: community.query.trending_communities
 */
 /**
+ * @deprecated This API renamed to `getTrendingCommunities()`.
+ * Please use getTrendingCommunities() instead.
+ *
  * ```js
- * import { getTopTrendingCommunities } from '@amityco/ts-sdk'
- * const trendingCommunities = await getTopTrendingCommunities()
+ * import { CommunityRepository } from '@amityco/ts-sdk'
+ * const trendingCommunities = await CommunityRepository.getTrendingCommunities()
  * ```
  *
  * Gets a list of top trending {@link Amity.Community} objects
@@ -29946,74 +29987,6 @@ getTopTrendingCommunities.locally = (query) => {
         : undefined;
 };
 
-/* begin_public_function
-  id: community.query.recommended_communities
-*/
-/**
- * ```js
- * import { getRecommendedCommunities } from '@amityco/ts-sdk'
- * const communities = await getRecommendedCommunities()
- * ```
- *
- * Gets a list of recommended {@link Amity.Community} objects
- *
- * @param query The query parameters
- * @returns A list of {@link Amity.Community} objects
- *
- * @category Community API
- * @async
- */
-const getRecommendedCommunities = async (query) => {
-    const client = getActiveClient();
-    client.log('channel/getRecommendedCommunities', query);
-    const { limit = 5 } = query !== null && query !== void 0 ? query : {};
-    // API-FIX: backend doesnt answer Amity.Response
-    // const { data: payload } = await client.http.get<Amity.Response<CommunityPayload>>(
-    const { data: payload } = await client.http.get(`/api/v3/communities/recommended`, { params: { options: { limit } } });
-    const data = prepareCommunityPayload(payload);
-    const { communities } = data;
-    const cachedAt = client.cache && Date.now();
-    if (client.cache) {
-        ingestInCache(data, { cachedAt });
-        const cacheKey = ['community', 'recommended', { params: { options: { limit } } }];
-        pushToCache(cacheKey, { communities: communities.map(getResolver('community')) });
-    }
-    return { data: communities, cachedAt };
-};
-/* end_public_function */
-/**
- * ```js
- * import { getRecommendedCommunities } from '@amityco/ts-sdk'
- * const communities = getRecommendedCommunities.locally()
- * ```
- *
- * Gets a list of recommended {@link Amity.Community} objects from cache
- *
- * @param query The query parameters
- * @returns communities
- *
- * @category Community API
- */
-getRecommendedCommunities.locally = (query) => {
-    var _a, _b;
-    const client = getActiveClient();
-    client.log('community/getRecommendedCommunities.locally', query);
-    if (!client.cache)
-        return;
-    const { limit = 5 } = query !== null && query !== void 0 ? query : {};
-    const queryKey = ['community', 'recommended', { params: { options: { limit } } }];
-    const { data, cachedAt } = (_a = pullFromCache(queryKey)) !== null && _a !== void 0 ? _a : {};
-    if (!(data === null || data === void 0 ? void 0 : data.communities.length))
-        return;
-    const communities = data.communities
-        .map(communityId => pullFromCache(['community', 'get', communityId]))
-        .filter(Boolean)
-        .map(({ data }) => data);
-    return communities.length === ((_b = data === null || data === void 0 ? void 0 : data.communities) === null || _b === void 0 ? void 0 : _b.length)
-        ? { data: communities, cachedAt }
-        : undefined;
-};
-
 const createCommunityEventSubscriber = (event, callback) => {
     const client = getActiveClient();
     const filter = (payload) => {
@@ -30418,10 +30391,10 @@ const queryCommunities = async (query) => {
 */
 /**
  * ```js
- * import { getCommunities } from '@amityco/ts-sdk'
+ * import { CommunityRepository } from '@amityco/ts-sdk'
  *
  * let communities = []
- * const unsub = getCommunities({
+ * const unsub = CommunityRepository.getCommunities({
  *   displayName: Amity.Community['displayName'],
  * }, response => merge(communities, response.data))
  * ```
@@ -30538,11 +30511,11 @@ const getCommunities = (params, callback, config) => {
 */
 /**
  * ```js
- * import { getCommunity } from '@amityco/ts-sdk';
+ * import { CommunityRepository } from '@amityco/ts-sdk';
  *
  * let community;
  *
- * const unsubscribe = getCommunity(communityId, response => {
+ * const unsub = CommunityRepository.getCommunity(communityId, response => {
  *   community = response.data;
  * });
  * ```
@@ -30568,6 +30541,287 @@ const getCommunity = (communityId, callback) => {
 };
 /* end_public_function */
 
+/**
+ * ```js
+ * import { CommunityRepository } from '@amityco/ts-sdk'
+ * const trendingCommunities = await CommunityRepository.getTrendingCommunities()
+ * ```
+ *
+ * Gets a list of top trending {@link Amity.Community} objects
+ *
+ * @param query The query parameters
+ * @returns A list of {@link Amity.Community} objects
+ *
+ * @category Community API
+ * @async
+ * @private
+ */
+const getTrendingCommunities$1 = async (query) => {
+    const client = getActiveClient();
+    client.log('community/getTrendingCommunities', query);
+    const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT } = query !== null && query !== void 0 ? query : {};
+    // API-FIX: backend doesnt answer Amity.Response
+    // const { data } = await client.http.get<Amity.Response<CommunityPayload>>(
+    const { data: payload } = await client.http.get(`/api/v3/communities/top-trending`, { params: { options: { limit } } });
+    const data = prepareCommunityPayload(payload);
+    const { communities } = data;
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(data, { cachedAt });
+    }
+    return { data: communities, cachedAt };
+};
+
+const communityQueryFilter = (data, params, userId) => {
+    let communities = data;
+    communities = filterByPropEquality(communities, 'displayName', params.displayName);
+    if (!params.includeDeleted) {
+        communities = filterByPropEquality(communities, 'isDeleted', false);
+    }
+    if (params.categoryId) {
+        communities = communities.filter(c => { var _a; return (_a = c.categoryIds) === null || _a === void 0 ? void 0 : _a.includes(params.categoryId); });
+    }
+    if (params.tags) {
+        communities = communities.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.membership && userId) {
+        communities = filterByCommunityMembership(communities, params.membership, userId);
+    }
+    const sortBy = params.sortBy || 'lastCreated';
+    if (sortBy === 'lastCreated' || sortBy === 'firstCreated') {
+        communities = communities.sort(sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
+    }
+    /*
+     * The server returns communities with empty | null displayName's first before
+     * returning sorted list of communities with displayNames
+     *
+     * This section needs to be updated as displayNames can be null as well
+     */
+    if (sortBy === 'displayName') {
+        communities = communities
+            // 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);
+    }
+    return communities;
+};
+
+/* eslint-disable no-use-before-define */
+/* begin_public_function
+  id: community.query.trending_communities
+*/
+/**
+ * ```js
+ * import { CommunityRepository } from '@amityco/ts-sdk'
+ *
+ * let communities = []
+ * const unsub = CommunityRepository.getCommunities({
+ *   displayName: Amity.Community['displayName'],
+ * }, response => merge(communities, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Community}s
+ *
+ * @param params for querying communities
+ * @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 communities
+ *
+ * @category Community Live Collection
+ */
+const getTrendingCommunities = (params, callback, config) => {
+    const { log, cache, userId } = getActiveClient();
+    if (!cache) {
+        console.log(ENABLE_CACHE_MESSAGE);
+    }
+    const timestamp = Date.now();
+    log(`getTrendingCommunities(tmpid: ${timestamp}) > listen`);
+    const { limit: queryLimit } = params;
+    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 = ['community', 'top-trending', { params: { options: { limit } } }];
+    const responder = (data, isEventModel = false) => {
+        var _a, _b;
+        const communities = (_a = data.data
+            .map(communityId => pullFromCache(['community', 'get', communityId]))
+            .filter(Boolean)
+            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+        callback({
+            onNextPage: onFetch,
+            data: isEventModel ? communityQueryFilter(communities, params, userId) : communities,
+            hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
+            loading: data.loading,
+            error: data.error,
+        });
+    };
+    const realtimeRouter = (_) => (community) => {
+        var _a;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (!collection)
+            return;
+        /*
+         * Simply update collection and let responder decide what to do with data
+         */
+        collection.data = [...new Set([community.communityId, ...collection.data])];
+        pushToCache(cacheKey, collection);
+        responder(collection);
+    };
+    const onFetch = (initial = false) => {
+        var _a, _b;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        const communities = (_b = collection === null || collection === void 0 ? void 0 : collection.data) !== null && _b !== void 0 ? _b : [];
+        if (!initial && communities.length > 0 && !(collection === null || collection === void 0 ? void 0 : collection.params.page))
+            return;
+        const query = createQuery(getTrendingCommunities$1, params);
+        runQuery(query, ({ data: result, error, loading }) => {
+            const data = {
+                loading,
+                error,
+                params,
+                data: communities,
+            };
+            if (result) {
+                data.data = [...new Set([...communities, ...result.map(getResolver('community'))])];
+            }
+            pushToCache(cacheKey, data);
+            responder(data);
+        }, queryOptions(policy, CACHE_SHORTEN_LIFESPAN));
+    };
+    disposers.push(onCommunityUserChanged(realtimeRouter()));
+    onFetch(true);
+    disposers.push(() => dropFromCache(cacheKey));
+    return () => {
+        log(`getTrendingCommunities(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+/* end_public_function */
+
+/* begin_public_function
+  id: community.query.recommended_communities
+*/
+/**
+ * ```js
+ * import { CommunityRepository } from '@amityco/ts-sdk'
+ * const communities = await CommunityRepository.getRecommendedCommunities()
+ * ```
+ *
+ * Gets a list of recommended {@link Amity.Community} objects
+ *
+ * @param query The query parameters
+ * @returns A list of {@link Amity.Community} objects
+ *
+ * @category Community API
+ * @async
+ * @private
+ */
+const getRecommendedCommunities$1 = async (query) => {
+    const client = getActiveClient();
+    client.log('community/getRecommendedCommunities', query);
+    const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT } = query !== null && query !== void 0 ? query : {};
+    // API-FIX: backend doesnt answer Amity.Response
+    // 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 = prepareCommunityPayload(payload);
+    const { communities } = data;
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(data, { cachedAt });
+    }
+    return { data: communities, cachedAt };
+};
+
+/* begin_public_function
+  id: community.query.recommended_communities
+*/
+/**
+ * ```js
+ * import { CommunityRepository } from '@amityco/ts-sdk'
+ *
+ * let communities = []
+ * const unsub = CommunityRepository.getCommunities({
+ *   displayName: Amity.Community['displayName'],
+ * }, response => merge(communities, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Community}s
+ *
+ * @param params for querying communities
+ * @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 communities
+ *
+ * @category Community Live Collection
+ */
+const getRecommendedCommunities = (params, callback, config) => {
+    const { log, cache, userId } = getActiveClient();
+    if (!cache) {
+        console.log(ENABLE_CACHE_MESSAGE);
+    }
+    const timestamp = Date.now();
+    log(`getRecommendedCommunities(tmpid: ${timestamp}) > listen`);
+    const { limit: queryLimit } = params; __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 = ['community', 'recommended', { params: { options: { limit } } }];
+    const responder = (data, isEventModel = false) => {
+        var _a, _b;
+        const communities = (_a = data.data
+            .map(communityId => pullFromCache(['community', 'get', communityId]))
+            .filter(Boolean)
+            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+        callback({
+            onNextPage: onFetch,
+            data: isEventModel ? communityQueryFilter(communities, params, userId) : communities,
+            hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
+            loading: data.loading,
+            error: data.error,
+        });
+    };
+    const realtimeRouter = (_) => (community) => {
+        var _a;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (!collection)
+            return;
+        /*
+         * Simply update collection and let responder decide what to do with data
+         */
+        collection.data = [...new Set([community.communityId, ...collection.data])];
+        pushToCache(cacheKey, collection);
+        responder(collection);
+    };
+    const onFetch = (initial = false) => {
+        var _a, _b;
+        const collection = (_a = pullFromCache(cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        const communities = (_b = collection === null || collection === void 0 ? void 0 : collection.data) !== null && _b !== void 0 ? _b : [];
+        if (!initial && communities.length > 0 && !(collection === null || collection === void 0 ? void 0 : collection.params.page))
+            return;
+        const query = createQuery(getRecommendedCommunities$1, params);
+        runQuery(query, ({ data: result, error, loading }) => {
+            const data = {
+                loading,
+                error,
+                params,
+                data: communities,
+            };
+            if (result) {
+                data.data = [...new Set([...communities, ...result.map(getResolver('community'))])];
+            }
+            pushToCache(cacheKey, data);
+            responder(data);
+        }, queryOptions(policy, CACHE_SHORTEN_LIFESPAN));
+    };
+    disposers.push(onCommunityUserChanged(realtimeRouter()));
+    onFetch(true);
+    disposers.push(() => dropFromCache(cacheKey));
+    return () => {
+        log(`getRecommendedCommunities(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+/* end_public_function */
+
 /* begin_public_function
   id: community.moderation.add_roles
 */
@@ -30854,6 +31108,24 @@ queryCommunityMembers.locally = (query) => {
         : undefined;
 };
 
+/*
+ * Exported for testing
+ * @hidden
+ */
+const applyFilter = (data, params) => {
+    let communityMembers = filterByPropIntersection(data, 'roles', params.roles);
+    if (params.membership) {
+        communityMembers = communityMembers.filter(({ communityMembership }) => 
+        // @ts-ignore
+        params.membership.includes(communityMembership));
+    }
+    if (params.search) {
+        communityMembers = filterBySearchTerm(communityMembers, params.search);
+    }
+    const sortBy = params.sortBy ? params.sortBy : 'lastCreated';
+    communityMembers = communityMembers.sort(sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
+    return communityMembers;
+};
 /* begin_public_function
   id: community.membership.query
 */
@@ -30878,6 +31150,7 @@ queryCommunityMembers.locally = (query) => {
 const getMembers = (params, callback, config) => {
     const { log, cache } = getActiveClient();
     if (!cache) {
+        // eslint-disable-next-line no-console
         console.log(ENABLE_CACHE_MESSAGE);
     }
     const timestamp = Date.now();
@@ -30887,20 +31160,6 @@ const getMembers = (params, callback, config) => {
     const { policy = COLLECTION_DEFAULT_CACHING_POLICY } = config !== null && config !== void 0 ? config : {};
     const disposers = [];
     const cacheKey = ['communityUsers', 'collection', { communityId: params.communityId }];
-    const applyFilter = (data) => {
-        let communityMembers = filterByPropIntersection(data, 'roles', params.roles);
-        if (params.membership) {
-            communityMembers = communityMembers.filter(({ communityMembership }) => 
-            // @ts-ignore
-            params.membership.includes(communityMembership));
-        }
-        if (params.search) {
-            communityMembers = filterBySearchTerm(communityMembers, params.search);
-        }
-        const sortBy = params.sortBy ? params.sortBy : 'lastCreated';
-        communityMembers = communityMembers.sort(sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
-        return communityMembers;
-    };
     const responder = (data, isEventModel = false) => {
         var _a, _b;
         const communityMembers = (_a = data.data
@@ -30909,7 +31168,7 @@ const getMembers = (params, callback, config) => {
             .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
         callback({
             onNextPage: onFetch,
-            data: isEventModel ? applyFilter(communityMembers) : communityMembers,
+            data: isEventModel ? applyFilter(communityMembers, params) : communityMembers,
             hasNextPage: !!((_b = data.params) === null || _b === void 0 ? void 0 : _b.page),
             loading: data.loading,
             error: data.error,
@@ -30967,6 +31226,7 @@ var index$7 = /*#__PURE__*/Object.freeze({
   __proto__: null,
   addMembers: addMembers,
   removeMembers: removeMembers,
+  applyFilter: applyFilter,
   getMembers: getMembers,
   onCommunityUserAdded: onCommunityUserAdded,
   onCommunityUserRemoved: onCommunityUserRemoved,
@@ -30990,13 +31250,14 @@ var index$6 = /*#__PURE__*/Object.freeze({
   joinCommunity: joinCommunity,
   leaveCommunity: leaveCommunity,
   getTopTrendingCommunities: getTopTrendingCommunities,
-  getRecommendedCommunities: getRecommendedCommunities,
   onCommunityCreated: onCommunityCreated,
   onCommunityUpdated: onCommunityUpdated,
   onCommunityDeleted: onCommunityDeleted,
   observeCommunity: observeCommunity,
   getCommunities: getCommunities,
-  getCommunity: getCommunity
+  getCommunity: getCommunity,
+  getTrendingCommunities: getTrendingCommunities,
+  getRecommendedCommunities: getRecommendedCommunities
 });
 
 /* begin_public_function
@@ -31088,7 +31349,7 @@ const queryCategories = async (query) => {
         const cacheKey = [
             'category',
             'query',
-            Object.assign(Object.assign({}, params), { options: Object.assign({}, page) }),
+            Object.assign(Object.assign({}, params), { includeDeleted, options: Object.assign({}, page) }),
         ];
         pushToCache(cacheKey, { categories: categories.map(getResolver('category')), paging });
     }
@@ -31967,11 +32228,11 @@ const observePost = (postId, callback, policy = 'cache_then_server') => {
 */
 /**
  * ```js
- * import { getPost } from '@amityco/ts-sdk';
+ * import { PostRepository } from '@amityco/ts-sdk';
  *
  * let post;
  *
- * const unsubscribe = getPost(postId, response => {
+ * const unsub = PostRepository.getPost(postId, response => {
  *   post = response.data;
  * });
  * ```
@@ -32051,7 +32312,7 @@ const queryPosts = async (query) => {
 };
 
 /* begin_public_function
-  id: post.query, feed.query.community_feed, feed.query.user_feed
+  id: post.query
 */
 /**
  * ```js
@@ -32627,11 +32888,11 @@ const observeComment = (commentId, callback, policy = 'cache_then_server') => {
 */
 /**
  * ```js
- * import { getComment } from '@amityco/ts-sdk';
+ * import { CommentRepository } from '@amityco/ts-sdk';
  *
  * let comment;
  *
- * const unsubscribe = getComment(commentId, response => {
+ * const unsub = CommentRepository.getComment(commentId, response => {
  *   comment = response.data;
  * });
  * ```
@@ -33140,7 +33401,8 @@ const onStreamRecorded = (callback) => {
 /**
  * ```js
  * import { StreamRepository } from '@amityco/ts-sdk'
- * const stream = await StreamRepository.getStreamById('foobar')
+ * const unsub = StreamRepository.getStreamById('foobar')
+ * unsub()
  * ```
  *
  * Fetches a {@link Amity.Stream} object
@@ -33157,7 +33419,33 @@ const getStreamById = (streamId, callback) => {
         onStreamStopped,
     ]);
 };
-/* end_public_function */
+/* end_public_function */
+/**
+ * ```js
+ * import { StreamRepository } from '@amityco/ts-sdk'
+ * const stream = StreamRepository.getStreamById.locally('foobar')
+ * ```
+ *
+ * Fetches a {@link Amity.Stream} live object
+ *
+ * @param streamId the ID of the {@link Amity.Stream} to fetch
+ * @returns the associated {@link Amity.Stream} live object
+ *
+ * @category Stream API
+ */
+getStreamById.locally = (streamId) => {
+    const client = getActiveClient();
+    client.log('stream/getStreamById', streamId);
+    if (!client.cache)
+        return;
+    const cached = pullFromCache(['stream', 'get', streamId]);
+    if (!cached)
+        return;
+    return {
+        data: cached.data,
+        cachedAt: cached.cachedAt,
+    };
+};
 
 /* begin_public_function
   id: stream.query
@@ -33182,12 +33470,12 @@ const getStreams = (params, callback, config) => {
         console.log(ENABLE_CACHE_MESSAGE);
     }
     const timestamp = Date.now();
-    log(`queryStreams(tmpid: ${timestamp}) > listen`);
+    log(`getStreams(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 = ['streams', 'collection', {}];
+    const cacheKey = ['streams', 'collection', params];
     const applyFilter = (data) => {
         let streams = filterByPropEquality(data, 'isDeleted', params.isDeleted);
         streams = streams.sort(params.sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
@@ -33196,7 +33484,9 @@ const getStreams = (params, callback, config) => {
     const responder = (data, isEventModel = false) => {
         var _a, _b;
         const streams = (_a = data.data
-            .map(streamId => pullFromCache(['streams', 'get', streamId]))
+            .map(streamId => {
+            return pullFromCache(['stream', 'get', streamId]);
+        })
             .filter(Boolean)
             .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
         callback({
@@ -33243,7 +33533,7 @@ const getStreams = (params, callback, config) => {
     disposers.push(onStreamRecorded(realtimeRouter()), onStreamStarted(realtimeRouter()), onStreamStopped(realtimeRouter()));
     onFetch(true);
     return () => {
-        log(`queryStreams(tmpid: ${timestamp}) > dispose`);
+        log(`getStreams(tmpid: ${timestamp}) > dispose`);
         disposers.forEach(fn => fn());
     };
 };
@@ -33264,64 +33554,6 @@ var index$1 = /*#__PURE__*/Object.freeze({
   getStreams: getStreams
 });
 
-/* begin_public_function
-  id: poll.get
-*/
-/**
- * ```js
- * import { getPoll } from '@amityco/ts-sdk'
- * const poll = await getPoll('foobar')
- * ```
- *
- * Fetches a {@link Amity.Poll} object
- *
- * @param pollId the ID of the {@link Amity.Poll} to fetch
- * @returns the associated {@link Amity.Poll} object
- *
- * @category Poll API
- * @async
- */
-const getPoll = async (pollId) => {
-    const client = getActiveClient();
-    client.log('poll/getPoll', pollId);
-    const { data } = await client.http.get(`/api/v3/polls/${pollId}`);
-    const cachedAt = client.cache && Date.now();
-    if (client.cache)
-        ingestInCache(data, { cachedAt });
-    const { polls } = data;
-    return {
-        data: polls.find(poll => poll.pollId === pollId),
-        cachedAt,
-    };
-};
-/* end_public_function */
-/**
- * ```js
- * import { getPoll } from '@amityco/ts-sdk'
- * const poll = getPoll.locally('foobar')
- * ```
- *
- * Fetches a {@link Amity.Poll} object
- *
- * @param pollId the ID of the {@link Amity.Poll} to fetch
- * @returns the associated {@link Amity.Poll} object
- *
- * @category Poll API
- */
-getPoll.locally = (pollId) => {
-    const client = getActiveClient();
-    client.log('poll/getPoll', pollId);
-    if (!client.cache)
-        return;
-    const cached = pullFromCache(['poll', 'get', pollId]);
-    if (!cached)
-        return;
-    return {
-        data: cached.data,
-        cachedAt: cached.cachedAt,
-    };
-};
-
 /* begin_public_function
   id: poll.create
 */
@@ -33394,6 +33626,64 @@ const closePoll = async (pollId) => {
 };
 /* end_public_function */
 
+/* begin_public_function
+  id: poll.get
+*/
+/**
+ * ```js
+ * import { getPoll } from '@amityco/ts-sdk'
+ * const poll = await getPoll('foobar')
+ * ```
+ *
+ * Fetches a {@link Amity.Poll} object
+ *
+ * @param pollId the ID of the {@link Amity.Poll} to fetch
+ * @returns the associated {@link Amity.Poll} object
+ *
+ * @category Poll API
+ * @async
+ */
+const getPoll$1 = async (pollId) => {
+    const client = getActiveClient();
+    client.log('poll/getPoll', pollId);
+    const { data } = await client.http.get(`/api/v3/polls/${pollId}`);
+    const cachedAt = client.cache && Date.now();
+    if (client.cache)
+        ingestInCache(data, { cachedAt });
+    const { polls } = data;
+    return {
+        data: polls.find(poll => poll.pollId === pollId),
+        cachedAt,
+    };
+};
+/* end_public_function */
+/**
+ * ```js
+ * import { getPoll } from '@amityco/ts-sdk'
+ * const poll = getPoll.locally('foobar')
+ * ```
+ *
+ * Fetches a {@link Amity.Poll} object
+ *
+ * @param pollId the ID of the {@link Amity.Poll} to fetch
+ * @returns the associated {@link Amity.Poll} object
+ *
+ * @category Poll API
+ */
+getPoll$1.locally = (pollId) => {
+    const client = getActiveClient();
+    client.log('poll/getPoll', pollId);
+    if (!client.cache)
+        return;
+    const cached = pullFromCache(['poll', 'get', pollId]);
+    if (!cached)
+        return;
+    return {
+        data: cached.data,
+        cachedAt: cached.cachedAt,
+    };
+};
+
 /* begin_public_function
   id: poll.delete
 */
@@ -33414,7 +33704,7 @@ const closePoll = async (pollId) => {
 const deletePoll = async (pollId) => {
     const client = getActiveClient();
     client.log('poll/deletePoll', pollId);
-    const poll = await getPoll(pollId);
+    const poll = await getPoll$1(pollId);
     // API-FIX: it returns { success: boolean } but seems it should be Amity.Response<{ success: boolean }
     const { data } = await client.http.delete(`/api/v3/polls/${pollId}`);
     const { success } = data; // unwrapPayload(data)
@@ -33546,23 +33836,50 @@ const observePoll = (pollId, callback, policy = 'cache_then_server') => {
     };
     const disposers = [];
     disposers.push(onPollUpdated(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onUpdate')), onPollDeleted(data => realtimeRouter({ data, loading: false, origin: 'event' }, 'onDelete')));
-    runQuery(createQuery(getPoll, pollId), result => (result.data || result.error) && router(result, 'onFetch'), queryOptions(policy));
+    runQuery(createQuery(getPoll$1, pollId), result => (result.data || result.error) && router(result, 'onFetch'), queryOptions(policy));
     return () => {
         log(`observePoll(tmpid: ${timestamp}) > dispose`);
         disposers.forEach(fn => fn());
     };
 };
 
+/* begin_public_function
+  id: poll.get
+*/
+/**
+ * ```js
+ * import { PollRepository } from '@amityco/ts-sdk';
+ *
+ * let poll;
+ *
+ * const unsub = PollRepository.getPoll(commentId, response => {
+ *   poll = response.data;
+ * });
+ * ```
+ *
+ * Observe all mutation on a given {@link Amity.Poll}
+ *
+ * @param pollId the ID of the poll to observe
+ * @param callback the function to call when new data are available
+ * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the poll
+ *
+ * @category Poll Live Object
+ */
+const getPoll = (pollId, callback) => {
+    return liveObject(pollId, callback, 'pollId', getPoll$1, [onPollUpdated, onPollDeleted]);
+};
+/* end_public_function */
+
 var index = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  getPoll: getPoll,
   createPoll: createPoll,
   closePoll: closePoll,
   deletePoll: deletePoll,
   votePoll: votePoll,
   onPollUpdated: onPollUpdated,
   onPollDeleted: onPollDeleted,
-  observePoll: observePoll
+  observePoll: observePoll,
+  getPoll: getPoll
 });
 
 /**