@amityco/ts-sdk 6.30.4-4fa323d.0 → 6.30.4-c9fbf64.0

package/dist/index.cjs.js

@@ -13146,8 +13146,11 @@ function isCurrentUserPartOfCommunity(c, m) {
  */
 function updateMembershipStatus(communities, communityUsers) {
     return communities.map(c => {
-        const isJoined = communityUsers.some(m => isCurrentUserPartOfCommunity(c, m) && isMember(m.communityMembership));
-        return Object.assign(Object.assign({}, c), { isJoined });
+        if (c.isJoined == null) {
+            const isJoined = communityUsers.some(m => isCurrentUserPartOfCommunity(c, m) && isMember(m.communityMembership));
+            return Object.assign(Object.assign({}, c), { isJoined });
+        }
+        return c;
     });
 }
 
@@ -14426,7 +14429,7 @@ const createMessageReport = async ({ client, referenceId, }) => {
     return !!payload;
 };
 const createPostReport = async ({ client, referenceId, }) => {
-    const { data: payload } = await client.http.post(`/api/v3/post/${encodeURIComponent(referenceId)}/flag`);
+    const { data: payload } = await client.http.post(`/api/v3/posts/${encodeURIComponent(referenceId)}/flag`);
     if (client.cache) {
         const postPayload = await preparePostPayload(payload);
         ingestInCache(postPayload);
@@ -14444,7 +14447,7 @@ const createUserReport = async ({ client, referenceId, }) => {
     return !!payload;
 };
 const createCommentReport = async ({ client, referenceId, }) => {
-    const { data: payload } = await client.http.post(`/api/v3/comment/${encodeURIComponent(referenceId)}/flag`);
+    const { data: payload } = await client.http.post(`/api/v3/comments/${encodeURIComponent(referenceId)}/flag`);
     if (client.cache) {
         const commentPayload = await prepareCommentPayload(payload);
         ingestInCache(commentPayload);
@@ -14493,7 +14496,7 @@ const deleteMessageReport = async ({ client, referenceId, }) => {
     return !!payload;
 };
 const deletePostReport = async ({ client, referenceId, }) => {
-    const { data: payload } = await client.http.delete(`/api/v3/post/${encodeURIComponent(referenceId)}/flag`);
+    const { data: payload } = await client.http.delete(`/api/v3/posts/${encodeURIComponent(referenceId)}/unflag`);
     if (client.cache) {
         const postPayload = await preparePostPayload(payload);
         ingestInCache(postPayload);
@@ -14511,7 +14514,7 @@ const deleteUserReport = async ({ client, referenceId, }) => {
     return !!payload;
 };
 const deleteCommentReport = async ({ client, referenceId, }) => {
-    const { data: payload } = await client.http.delete(`/api/v3/comment/${encodeURIComponent(referenceId)}/flag`);
+    const { data: payload } = await client.http.delete(`/api/v3/comments/${encodeURIComponent(referenceId)}/unflag`);
     if (client.cache) {
         const commentPayload = await prepareCommentPayload(payload);
         ingestInCache(commentPayload);
@@ -18809,7 +18812,7 @@ const joinCommunity = async (communityId) => {
     const client = getActiveClient();
     client.log('community/joinCommunity', communityId);
     const { data: payload } = await client.http.post(`/api/v3/communities/${communityId}/join`);
-    fireEvent('community.joined', payload);
+    fireEvent('local.community.joined', payload);
     const data = prepareCommunityPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
@@ -18840,7 +18843,7 @@ const leaveCommunity = async (communityId) => {
     const client = getActiveClient();
     client.log('community/leaveCommunity', communityId);
     const { data: payload } = await client.http.delete(`/api/v3/communities/${communityId}/leave`);
-    fireEvent('community.left', payload);
+    fireEvent('local.community.left', payload);
     const data = prepareCommunityPayload(payload);
     const cachedAt = client.cache && Date.now();
     if (client.cache)
@@ -19005,8 +19008,6 @@ function getEventRelatedMember(event, payload) {
     if (event === 'community.joined' || event === 'community.left') {
         return payload.communityUsers;
     }
-    // NOTE: backend returns the one who took the action and the one on whom
-    // the action was taken. We need the 2nd one
     if (event === 'community.userRemoved' || event === 'local.community.userRemoved') {
         return payload.communityUsers.filter(x => x.communityMembership === 'none');
     }
@@ -19281,6 +19282,10 @@ const onCommunityJoined = (callback) => createCommunityMemberEventSubscriber('co
  */
 const onCommunityLeft = (callback) => createCommunityMemberEventSubscriber('community.left', callback);
 
+const onLocalCommunityJoined = (callback) => createLocalCommunityMemberEventSubscriber('local.community.joined', callback);
+
+const onLocalCommunityLeft = (callback) => createLocalCommunityMemberEventSubscriber('local.community.left', callback);
+
 /**
  * ```js
  * import { observeCommunity } from '@amityco/ts-sdk'
@@ -19382,12 +19387,12 @@ class CommunitiesQueryStreamController$1 extends QueryStreamController {
     }
 }
 
-var EnumCommunityActions$1;
+var EnumCommunityActions$3;
 (function (EnumCommunityActions) {
     EnumCommunityActions["OnCommunityCreated"] = "onCommunityCreated";
     EnumCommunityActions["OnCommunityDeleted"] = "onCommunityDeleted";
     EnumCommunityActions["OnCommunityUpdated"] = "onCommunityUpdated";
-})(EnumCommunityActions$1 || (EnumCommunityActions$1 = {}));
+})(EnumCommunityActions$3 || (EnumCommunityActions$3 = {}));
 
 var EnumCommunityMemberActions$1;
 (function (EnumCommunityMemberActions) {
@@ -19666,7 +19671,9 @@ class CommunityMembersLiveCollectionController extends LiveCollectionController
     startSubscription() {
         return this.queryStreamController.subscribeRTE([
             { fn: onCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
+            { fn: onLocalCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
             { fn: onCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
+            { fn: onLocalCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
             { fn: onCommunityUserBanned, action: EnumCommunityMemberActions$1.OnCommunityUserBanned },
             { fn: onCommunityUserChanged, action: EnumCommunityMemberActions$1.OnCommunityUserChanged },
             { fn: onCommunityUserRoleAdded, action: EnumCommunityMemberActions$1.OnCommunityUserRoleAdded },
@@ -19926,7 +19933,9 @@ class SearchCommunityMembersLiveCollectionController extends LiveCollectionContr
     startSubscription() {
         return this.queryStreamController.subscribeRTE([
             { fn: onCommunityJoined, action: EnumCommunityMemberActions.OnCommunityJoined },
+            { fn: onLocalCommunityJoined, action: EnumCommunityMemberActions.OnCommunityJoined },
             { fn: onCommunityLeft, action: EnumCommunityMemberActions.OnCommunityLeft },
+            { fn: onLocalCommunityLeft, action: EnumCommunityMemberActions.OnCommunityLeft },
             { fn: onCommunityUserBanned, action: EnumCommunityMemberActions.OnCommunityUserBanned },
             { fn: onCommunityUserChanged, action: EnumCommunityMemberActions.OnCommunityUserChanged },
             {
@@ -20041,7 +20050,9 @@ var index$b = /*#__PURE__*/Object.freeze({
   onLocalCommunityUserAdded: onLocalCommunityUserAdded,
   onLocalCommunityUserRemoved: onLocalCommunityUserRemoved,
   onCommunityJoined: onCommunityJoined,
-  onCommunityLeft: onCommunityLeft
+  onCommunityLeft: onCommunityLeft,
+  onLocalCommunityJoined: onLocalCommunityJoined,
+  onLocalCommunityLeft: onLocalCommunityLeft
 });
 
 class SearchCommunityLiveCollectionController extends LiveCollectionController {
@@ -20073,11 +20084,13 @@ class SearchCommunityLiveCollectionController extends LiveCollectionController {
     }
     startSubscription() {
         return this.queryStreamController.subscribeRTE([
-            { fn: onCommunityDeleted, action: EnumCommunityActions$1.OnCommunityDeleted },
-            { fn: onCommunityUpdated, action: EnumCommunityActions$1.OnCommunityUpdated },
+            { fn: onCommunityDeleted, action: EnumCommunityActions$3.OnCommunityDeleted },
+            { fn: onCommunityUpdated, action: EnumCommunityActions$3.OnCommunityUpdated },
             { fn: onCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
             { fn: onCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
             { fn: onCommunityUserChanged, action: EnumCommunityMemberActions$1.OnMemberCountChanged },
+            { fn: onLocalCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
+            { fn: onLocalCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
         ]);
     }
     notifyChange({ origin, loading, error }) {
@@ -20087,7 +20100,7 @@ class SearchCommunityLiveCollectionController extends LiveCollectionController {
             return;
         const data = this.applyFilter((_b = collection.data
             .map(id => pullFromCache(['community', 'get', id]))
-            .filter(Boolean)
+            .filter(isNonNullable)
             .map(({ data }) => data)) !== null && _b !== void 0 ? _b : []);
         if (!this.shouldNotify(data) && origin === 'event')
             return;
@@ -20172,12 +20185,12 @@ class CommunitiesPaginationController extends PaginationController {
     }
 }
 
-var EnumCommunityActions;
+var EnumCommunityActions$2;
 (function (EnumCommunityActions) {
     EnumCommunityActions["OnCommunityCreated"] = "onCommunityCreated";
     EnumCommunityActions["OnCommunityDeleted"] = "onCommunityDeleted";
     EnumCommunityActions["OnCommunityUpdated"] = "onCommunityUpdated";
-})(EnumCommunityActions || (EnumCommunityActions = {}));
+})(EnumCommunityActions$2 || (EnumCommunityActions$2 = {}));
 
 class CommunitiesQueryStreamController extends QueryStreamController {
     constructor(query, cacheKey, notifyChange, preparePayload) {
@@ -20213,7 +20226,7 @@ class CommunitiesQueryStreamController extends QueryStreamController {
             const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
             if (!collection)
                 return;
-            if (this.query.displayName && action === EnumCommunityActions.OnCommunityCreated) {
+            if (this.query.displayName && action === EnumCommunityActions$2.OnCommunityCreated) {
                 return;
             }
             /*
@@ -20258,12 +20271,14 @@ class CommunityLiveCollectionController extends LiveCollectionController {
     }
     startSubscription() {
         return this.queryStreamController.subscribeRTE([
-            { fn: onCommunityCreated, action: EnumCommunityActions.OnCommunityCreated },
-            { fn: onCommunityDeleted, action: EnumCommunityActions.OnCommunityDeleted },
-            { fn: onCommunityUpdated, action: EnumCommunityActions.OnCommunityUpdated },
+            { fn: onCommunityCreated, action: EnumCommunityActions$2.OnCommunityCreated },
+            { fn: onCommunityDeleted, action: EnumCommunityActions$2.OnCommunityDeleted },
+            { fn: onCommunityUpdated, action: EnumCommunityActions$2.OnCommunityUpdated },
             { fn: onCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
             { fn: onCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
             { fn: onCommunityUserChanged, action: EnumCommunityMemberActions$1.OnMemberCountChanged },
+            { fn: onLocalCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
+            { fn: onLocalCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
         ]);
     }
     notifyChange({ origin, loading, error }) {
@@ -20273,7 +20288,7 @@ class CommunityLiveCollectionController extends LiveCollectionController {
             return;
         const data = this.applyFilter((_b = collection.data
             .map(id => pullFromCache(['community', 'get', id]))
-            .filter(Boolean)
+            .filter(isNonNullable)
             .map(({ data }) => data)) !== null && _b !== void 0 ? _b : []);
         if (!this.shouldNotify(data) && origin === 'event')
             return;
@@ -20386,6 +20401,8 @@ const getCommunity = (communityId, callback) => {
         onCommunityDeleted,
         onCommunityJoined,
         onCommunityLeft,
+        onLocalCommunityJoined,
+        onLocalCommunityLeft,
         onCommunityUserBanned,
         onCommunityUserUnbanned,
         onCommunityUserChanged,
@@ -20394,71 +20411,128 @@ 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
+ * TODO: handle cache receive cache option, and cache policy
+ * TODO: check if querybyIds is supported
  */
-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 });
+class TrendingCommunitiesPaginationController extends PaginationController {
+    async getRequest(queryParams, token) {
+        const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT } = queryParams, params = __rest(queryParams, ["limit"]);
+        const options = token ? { token } : { limit };
+        const { data: queryResponse } = await this.http.get(`/api/v3/communities/top-trending`, {
+            params: Object.assign(Object.assign({}, params), { options }),
+        });
+        return queryResponse;
     }
-    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);
+class TrendingCommunitiesQueryStreamController extends QueryStreamController {
+    constructor(query, cacheKey, notifyChange, preparePayload) {
+        super(query, cacheKey);
+        this.notifyChange = notifyChange;
+        this.preparePayload = preparePayload;
     }
-    if (params.categoryId) {
-        communities = communities.filter(c => { var _a; return (_a = c.categoryIds) === null || _a === void 0 ? void 0 : _a.includes(params.categoryId); });
+    async saveToMainDB(response) {
+        const processedPayload = await this.preparePayload(response);
+        const client = getActiveClient();
+        const cachedAt = client.cache && Date.now();
+        if (client.cache) {
+            ingestInCache(processedPayload, { cachedAt });
+            saveCommunityUsers(response.communities, response.communityUsers);
+        }
     }
-    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); }); });
+    appendToQueryStream(response, direction, refresh = false) {
+        var _a, _b;
+        if (refresh) {
+            pushToCache(this.cacheKey, {
+                data: response.communities.map(getResolver('community')),
+            });
+        }
+        else {
+            const collection = (_a = pullFromCache(this.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 : [];
+            pushToCache(this.cacheKey, Object.assign(Object.assign({}, collection), { data: [...new Set([...communities, ...response.communities.map(getResolver('community'))])] }));
+        }
     }
-    if (params.membership && userId) {
-        communities = filterByCommunityMembership(communities, params.membership, userId);
+    reactor(action) {
+        return (community) => {
+            var _a;
+            const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+            if (!collection)
+                return;
+            pushToCache(this.cacheKey, collection);
+            this.notifyChange({ origin: "event" /* Amity.LiveDataOrigin.EVENT */, loading: false });
+        };
     }
-    const sortBy = params.sortBy || 'lastCreated';
-    if (sortBy === 'lastCreated' || sortBy === 'firstCreated') {
-        communities = communities.sort(sortBy === 'lastCreated' ? sortByLastCreated : sortByFirstCreated);
+    subscribeRTE(createSubscriber) {
+        return createSubscriber.map(subscriber => subscriber.fn(this.reactor(subscriber.action)));
     }
-    /*
-     * 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: '' })))
-            .sort(sortByDisplayName);
+}
+
+var EnumCommunityActions$1;
+(function (EnumCommunityActions) {
+    EnumCommunityActions["OnCommunityDeleted"] = "onCommunityDeleted";
+    EnumCommunityActions["OnCommunityUpdated"] = "onCommunityUpdated";
+})(EnumCommunityActions$1 || (EnumCommunityActions$1 = {}));
+
+class TrendingCommunityLiveCollectionController extends LiveCollectionController {
+    constructor(query, callback) {
+        const queryStreamId = hash__default["default"](query);
+        const cacheKey = ['trendingCommunity', 'collection', queryStreamId];
+        const paginationController = new TrendingCommunitiesPaginationController(query);
+        super(paginationController, queryStreamId, cacheKey, callback);
+        this.query = query;
+        this.queryStreamController = new TrendingCommunitiesQueryStreamController(this.query, this.cacheKey, this.notifyChange.bind(this), prepareCommunityPayload);
+        this.callback = callback.bind(this);
+        this.loadPage({ initial: true });
     }
-    return communities;
-};
+    setup() {
+        var _a;
+        const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (!collection) {
+            pushToCache(this.cacheKey, {
+                data: [],
+                params: {},
+            });
+        }
+    }
+    async persistModel(queryPayload) {
+        await this.queryStreamController.saveToMainDB(queryPayload);
+    }
+    persistQueryStream({ response, direction, refresh, }) {
+        this.queryStreamController.appendToQueryStream(response, direction, refresh);
+    }
+    startSubscription() {
+        return this.queryStreamController.subscribeRTE([
+            { fn: onCommunityDeleted, action: EnumCommunityActions$1.OnCommunityDeleted },
+            { fn: onCommunityUpdated, action: EnumCommunityActions$1.OnCommunityUpdated },
+            { fn: onCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
+            { fn: onCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
+            { fn: onCommunityUserChanged, action: EnumCommunityMemberActions$1.OnMemberCountChanged },
+            { fn: onLocalCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
+            { fn: onLocalCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
+        ]);
+    }
+    notifyChange({ origin, loading, error }) {
+        var _a, _b;
+        const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (!collection)
+            return;
+        const data = (_b = collection.data
+            .map(id => pullFromCache(['community', 'get', id]))
+            .filter(isNonNullable)
+            .map(({ data }) => data)) !== null && _b !== void 0 ? _b : [];
+        if (!this.shouldNotify(data) && origin === 'event')
+            return;
+        this.callback({
+            onNextPage: () => this.loadPage({ direction: "next" /* Amity.LiveCollectionPageDirection.NEXT */ }),
+            data,
+            hasNextPage: !!this.paginationController.getNextToken(),
+            loading,
+            error,
+        });
+    }
+}
 
-/* eslint-disable no-use-before-define */
 /* begin_public_function
   id: community.query.trending_communities
 */
@@ -20487,60 +20561,9 @@ const getTrendingCommunities = (params, callback, config) => {
     }
     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);
+    const trendingCommunitiesLiveCollection = new TrendingCommunityLiveCollectionController(params, callback);
+    const disposers = trendingCommunitiesLiveCollection.startSubscription();
+    const cacheKey = trendingCommunitiesLiveCollection.getCacheKey();
     disposers.push(() => dropFromCache(cacheKey));
     return () => {
         log(`getTrendingCommunities(tmpid: ${timestamp}) > dispose`);
@@ -20549,39 +20572,128 @@ const getTrendingCommunities = (params, callback, config) => {
 };
 /* 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
+ * TODO: handle cache receive cache option, and cache policy
+ * TODO: check if querybyIds is supported
  */
-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 });
+class RecommendedCommunitiesPaginationController extends PaginationController {
+    async getRequest(queryParams, token) {
+        const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT } = queryParams, params = __rest(queryParams, ["limit"]);
+        const options = token ? { token } : { limit };
+        const { data: queryResponse } = await this.http.get(`/api/v3/communities/recommended`, {
+            params: Object.assign(Object.assign({}, params), { options }),
+        });
+        return queryResponse;
     }
-    return { data: communities, cachedAt };
-};
+}
+
+class RecommendedCommunitiesQueryStreamController extends QueryStreamController {
+    constructor(query, cacheKey, notifyChange, preparePayload) {
+        super(query, cacheKey);
+        this.notifyChange = notifyChange;
+        this.preparePayload = preparePayload;
+    }
+    async saveToMainDB(response) {
+        const processedPayload = await this.preparePayload(response);
+        const client = getActiveClient();
+        const cachedAt = client.cache && Date.now();
+        if (client.cache) {
+            ingestInCache(processedPayload, { cachedAt });
+            saveCommunityUsers(response.communities, response.communityUsers);
+        }
+    }
+    appendToQueryStream(response, direction, refresh = false) {
+        var _a, _b;
+        if (refresh) {
+            pushToCache(this.cacheKey, {
+                data: response.communities.map(getResolver('community')),
+            });
+        }
+        else {
+            const collection = (_a = pullFromCache(this.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 : [];
+            pushToCache(this.cacheKey, Object.assign(Object.assign({}, collection), { data: [...new Set([...communities, ...response.communities.map(getResolver('community'))])] }));
+        }
+    }
+    reactor(action) {
+        return (community) => {
+            var _a;
+            const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+            if (!collection)
+                return;
+            pushToCache(this.cacheKey, collection);
+            this.notifyChange({ origin: "event" /* Amity.LiveDataOrigin.EVENT */, loading: false });
+        };
+    }
+    subscribeRTE(createSubscriber) {
+        return createSubscriber.map(subscriber => subscriber.fn(this.reactor(subscriber.action)));
+    }
+}
+
+var EnumCommunityActions;
+(function (EnumCommunityActions) {
+    EnumCommunityActions["OnCommunityDeleted"] = "onCommunityDeleted";
+    EnumCommunityActions["OnCommunityUpdated"] = "onCommunityUpdated";
+})(EnumCommunityActions || (EnumCommunityActions = {}));
+
+class RecommendedCommunityLiveCollectionController extends LiveCollectionController {
+    constructor(query, callback) {
+        const queryStreamId = hash__default["default"](query);
+        const cacheKey = ['community', 'collection', queryStreamId];
+        const paginationController = new RecommendedCommunitiesPaginationController(query);
+        super(paginationController, queryStreamId, cacheKey, callback);
+        this.query = query;
+        this.queryStreamController = new RecommendedCommunitiesQueryStreamController(this.query, this.cacheKey, this.notifyChange.bind(this), prepareCommunityPayload);
+        this.callback = callback.bind(this);
+        this.loadPage({ initial: true });
+    }
+    setup() {
+        var _a;
+        const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (!collection) {
+            pushToCache(this.cacheKey, {
+                data: [],
+                params: {},
+            });
+        }
+    }
+    async persistModel(queryPayload) {
+        await this.queryStreamController.saveToMainDB(queryPayload);
+    }
+    persistQueryStream({ response, direction, refresh, }) {
+        this.queryStreamController.appendToQueryStream(response, direction, refresh);
+    }
+    startSubscription() {
+        return this.queryStreamController.subscribeRTE([
+            { fn: onCommunityDeleted, action: EnumCommunityActions.OnCommunityDeleted },
+            { fn: onCommunityUpdated, action: EnumCommunityActions.OnCommunityUpdated },
+            { fn: onCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
+            { fn: onCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
+            { fn: onCommunityUserChanged, action: EnumCommunityMemberActions$1.OnMemberCountChanged },
+            { fn: onLocalCommunityJoined, action: EnumCommunityMemberActions$1.OnCommunityJoined },
+            { fn: onLocalCommunityLeft, action: EnumCommunityMemberActions$1.OnCommunityLeft },
+        ]);
+    }
+    notifyChange({ origin, loading, error }) {
+        var _a, _b;
+        const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+        if (!collection)
+            return;
+        const data = (_b = collection.data
+            .map(id => pullFromCache(['community', 'get', id]))
+            .filter(isNonNullable)
+            .map(({ data }) => data)) !== null && _b !== void 0 ? _b : [];
+        if (!this.shouldNotify(data) && origin === 'event')
+            return;
+        this.callback({
+            onNextPage: () => this.loadPage({ direction: "next" /* Amity.LiveCollectionPageDirection.NEXT */ }),
+            data,
+            hasNextPage: !!this.paginationController.getNextToken(),
+            loading,
+            error,
+        });
+    }
+}
 
 /* begin_public_function
   id: community.query.recommended_communities
@@ -20611,60 +20723,9 @@ const getRecommendedCommunities = (params, callback, config) => {
     }
     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);
+    const recommendedCommunitiesLiveCollection = new RecommendedCommunityLiveCollectionController(params, callback);
+    const disposers = recommendedCommunitiesLiveCollection.startSubscription();
+    const cacheKey = recommendedCommunitiesLiveCollection.getCacheKey();
     disposers.push(() => dropFromCache(cacheKey));
     return () => {
         log(`getRecommendedCommunities(tmpid: ${timestamp}) > dispose`);