@amityco/ts-sdk-react-native 6.23.0 → 6.24.0

package/dist/marker/events/onChannelUnreadUpdatedLocal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Internal used only
+ *
+ * Fired when an {@link Amity.userMessageFeedMarkers} has been resolved by Object Rsesolver
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category MessageMarker Events
+ */
+export declare const onChannelUnreadUpdatedLocal: (callback: Amity.Listener<Amity.Events['local.channelUnread.updated']>) => Amity.Unsubscriber;
+//# sourceMappingURL=onChannelUnreadUpdatedLocal.d.ts.map

package/dist/marker/events/onChannelUnreadUpdatedLocal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onChannelUnreadUpdatedLocal.d.ts","sourceRoot":"","sources":["../../../src/marker/events/onChannelUnreadUpdatedLocal.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,aAC5B,MAAM,QAAQ,CAAC,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC,KACpE,MAAM,YAaR,CAAC"}

package/dist/marker/events/onSubChannelUnreadUpdatedLocal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Internal used only
+ *
+ * Fired when an {@link Amity.userMessageFeedMarkers} has been resolved by Object Rsesolver
+ *
+ * @param callback The function to call when the event was fired
+ * @returns an {@link Amity.Unsubscriber} function to stop listening
+ *
+ * @category MessageMarker Events
+ */
+export declare const onSubChannelUnreadUpdatedLocal: (callback: Amity.Listener<Amity.Events['local.subChannelUnread.updated']>) => Amity.Unsubscriber;
+//# sourceMappingURL=onSubChannelUnreadUpdatedLocal.d.ts.map

package/dist/marker/events/onSubChannelUnreadUpdatedLocal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onSubChannelUnreadUpdatedLocal.d.ts","sourceRoot":"","sources":["../../../src/marker/events/onSubChannelUnreadUpdatedLocal.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,aAC/B,MAAM,QAAQ,CAAC,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC,KACvE,MAAM,YAaR,CAAC"}

package/dist/marker/events/onUserFeedMarkerUpdated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onUserFeedMarkerUpdated.d.ts","sourceRoot":"","sources":["../../../src/marker/events/onUserFeedMarkerUpdated.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,aACxB,MAAM,QAAQ,CAAC,MAAM,UAAU,CAAC,KACzC,MAAM,YAgBR,CAAC"}
+{"version":3,"file":"onUserFeedMarkerUpdated.d.ts","sourceRoot":"","sources":["../../../src/marker/events/onUserFeedMarkerUpdated.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,aACxB,MAAM,QAAQ,CAAC,MAAM,UAAU,CAAC,KACzC,MAAM,YAeR,CAAC"}

package/dist/marker/utils/reCalculateChannelUnreadInfo.d.ts

@@ -1,2 +1,2 @@
-export declare const reCalculateChannelUnreadInfo: (channelId: string) => Promise<void>;
+export declare const reCalculateChannelUnreadInfo: (channelId: string) => Amity.ChannelUnreadInfo;
 //# sourceMappingURL=reCalculateChannelUnreadInfo.d.ts.map

package/dist/marker/utils/reCalculateChannelUnreadInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reCalculateChannelUnreadInfo.d.ts","sourceRoot":"","sources":["../../../src/marker/utils/reCalculateChannelUnreadInfo.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,4BAA4B,cAAqB,MAAM,kBAiCnE,CAAC"}
+{"version":3,"file":"reCalculateChannelUnreadInfo.d.ts","sourceRoot":"","sources":["../../../src/marker/utils/reCalculateChannelUnreadInfo.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,4BAA4B,cAAe,MAAM,KAAG,MAAM,iBAqCtE,CAAC"}

package/dist/postRepository/observers/getPost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/observers/getPost.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,WACV,MAAM,IAAI,CAAC,QAAQ,CAAC,YAClB,MAAM,kBAAkB,CAAC,MAAM,IAAI,CAAC,KAC7C,MAAM,YA0CR,CAAC"}
+{"version":3,"file":"getPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/observers/getPost.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,WACV,MAAM,IAAI,CAAC,QAAQ,CAAC,YAClB,MAAM,kBAAkB,CAAC,MAAM,IAAI,CAAC,KAC7C,MAAM,YAkER,CAAC"}

package/dist/postRepository/observers/getPosts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPosts.d.ts","sourceRoot":"","sources":["../../../src/postRepository/observers/getPosts.ts"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,QAAQ,WACX,MAAM,kBAAkB,YACtB,MAAM,sBAAsB,CAAC,MAAM,IAAI,CAAC,WACzC,MAAM,oBAAoB,KAClC,MAAM,YAsJR,CAAC"}
+{"version":3,"file":"getPosts.d.ts","sourceRoot":"","sources":["../../../src/postRepository/observers/getPosts.ts"],"names":[],"mappings":"AA2CA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,QAAQ,WACX,MAAM,kBAAkB,YACtB,MAAM,sBAAsB,CAAC,MAAM,IAAI,CAAC,WACzC,MAAM,oBAAoB,KAClC,MAAM,YAkLR,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/ts-sdk-react-native",
-  "version": "6.23.0",
+  "version": "6.24.0",
   "license": "CC-BY-ND-4.0",
   "author": "amity.co <developers@amity.co> (https://amity.co)",
   "description": "Amity Social Cloud Typescript SDK",

package/src/@types/core/events.ts

@@ -194,6 +194,9 @@ declare global {
         userFeedMarkers: Amity.UserFeedMarkerResponse[];
       };
 
+      'local.subChannelUnread.updated': Amity.SubChannelUnreadInfo;
+      'local.channelUnread.updated': Amity.ChannelUnreadInfo;
+
       'local.story.created': Amity.StoryPayload;
       'local.story.updated': Amity.StoryPayload;
       'local.story.deleted': Amity.StoryPayload;
@@ -206,6 +209,11 @@ declare global {
       'local.story.error': Amity.StoryPayload;
       'local.story.reload': { referenceIds: Amity.Story['referenceId'][] };
 
+      'local.post.updated': Amity.PostPayload;
+      
+      'local.comment.created': Amity.CommentPayload;
+      'local.comment.deleted': Amity.CommentPayload;
+
       sessionStateChange: Amity.SessionStates;
       // used by accessTokenExpiryWatcher
       tokenExpired: Amity.SessionStates.TOKEN_EXPIRED;

package/src/@types/domains/community.ts

@@ -75,6 +75,22 @@ declare global {
       };
 
     type QueryCommunities = {
+      /** @deprecated use searchCommunities instead */
+      displayName?: string;
+      membership?: 'all' | 'member' | 'notMember';
+      categoryId?: Amity.InternalCategory['categoryId'];
+      includeDeleted?: boolean;
+      tags?: Amity.Taggable['tags'];
+      sortBy?:
+        | 'firstCreated'
+        | 'lastCreated'
+        /** @deprecated sortBy displayName is not available */
+        | 'displayName';
+      page?: string;
+      limit?: number;
+    };
+
+    type SearchQueryCommunities = {
       displayName?: string;
       membership?: 'all' | 'member' | 'notMember';
       categoryId?: Amity.InternalCategory['categoryId'];
@@ -87,11 +103,20 @@ declare global {
 
     type CommunityLiveCollection = Amity.LiveCollectionParams<Omit<QueryCommunities, 'page'>>;
 
+    type SearchCommunityLiveCollection = Amity.LiveCollectionParams<
+      Omit<SearchQueryCommunities, 'page'>
+    >;
+
     type CommunityLiveCollectionCache = Amity.LiveCollectionCache<
       Amity.Community['communityId'],
       Pick<QueryCommunities, 'page'>
     >;
 
+    type SearchCommunityLiveCollectionCache = Amity.LiveCollectionCache<
+      Amity.Community['communityId'],
+      Pick<SearchQueryCommunities, 'page'>
+    >;
+
     type QueryCommunityMembers = {
       communityId: string;
       memberships?: ('banned' | 'member')[];

package/src/channelRepository/channelMembership/observers/getMembers/ChannelMemberLiveCollectionController.ts

@@ -52,7 +52,7 @@ export class ChannelMemberLiveCollectionController extends LiveCollectionControl
     );
 
     this.callback = callback.bind(this);
-    this.loadPage(true);
+    this.loadPage({ initial: true });
   }
 
   protected setup() {
@@ -104,7 +104,7 @@ export class ChannelMemberLiveCollectionController extends LiveCollectionControl
     if (!this.shouldNotify(data) && origin === 'event') return;
 
     this.callback({
-      onNextPage: () => this.loadPage(false, Amity.LiveCollectionPageDirection.NEXT),
+      onNextPage: () => this.loadPage({ direction: Amity.LiveCollectionPageDirection.NEXT }),
       data,
       hasNextPage: !!this.paginationController.getNextToken(),
       loading,

package/src/channelRepository/observers/getChannel.ts

@@ -33,8 +33,8 @@ import { isEqual } from '~/utils/isEqual';
 import { updateChannelCache } from '../utils/updateChannelCache';
 import { onChannelMarkerUpdated } from '~/marker/events/onChannelMarkerUpdated';
 import { onSubChannelCreated } from '~/subChannelRepository';
-import { onUserFeedMarkerUpdated } from '~/marker/events/onUserFeedMarkerUpdated';
 import { LinkedObject } from '~/utils/linkedObject';
+import { onChannelUnreadUpdatedLocal } from '~/marker/events/onChannelUnreadUpdatedLocal';
 
 /* begin_public_function
   id: channel.get
@@ -271,7 +271,7 @@ export const getChannel = (
         'channel',
       ),
       convertEventPayload(onSubChannelCreated, 'channelId', 'channel'),
-      convertEventPayload(onUserFeedMarkerUpdated, 'entityId', 'channel'),
+      convertEventPayload(onChannelUnreadUpdatedLocal, 'channelId', 'channel'),
     ],
     {
       forceDispatch: true,

package/src/channelRepository/observers/getChannels/ChannelLiveCollectionController.ts

@@ -47,7 +47,6 @@ import { getActiveClient } from '~/client';
 import { prepareChannelPayload } from '~/channelRepository/utils';
 import { ChannelPaginationNoPageController } from './ChannelPagnationNoPageController';
 import { PaginationController } from '~/core/liveCollection/PaginationController';
-import { onUserFeedMarkerUpdated } from '~/marker/events/onUserFeedMarkerUpdated';
 import { onSubChannelCreated } from '~/subChannelRepository';
 
 import ObjectResolverEngine from '~/client/utils/ObjectResolver/objectResolverEngine';
@@ -56,6 +55,7 @@ import { resolveUnreadInfoOnChannelEvent } from '~/channelRepository/utils/resol
 import { onChannelResolved } from '~/channelRepository/events/onChannelResolved';
 import { onUserMessageFeedMarkerResolved } from '~/marker/events/onUserMessageFeedMarkerResolved';
 import { LinkedObject } from '~/utils/linkedObject';
+import { onChannelUnreadUpdatedLocal } from '~/marker/events/onChannelUnreadUpdatedLocal';
 
 export class ChannelLiveCollectionController extends LiveCollectionController<
   'channel',
@@ -98,7 +98,7 @@ export class ChannelLiveCollectionController extends LiveCollectionController<
 
     this.paginationController = paginationController;
     this.callback = callback.bind(this);
-    this.loadPage(true);
+    this.loadPage({ initial: true });
   }
 
   protected setup() {
@@ -148,7 +148,7 @@ export class ChannelLiveCollectionController extends LiveCollectionController<
     this.callback({
       onNextPage:
         this.paginationController instanceof ChannelPaginationController
-          ? () => this.loadPage(false, Amity.LiveCollectionPageDirection.NEXT)
+          ? () => this.loadPage({ direction: Amity.LiveCollectionPageDirection.NEXT })
           : undefined,
       data,
       hasNextPage:
@@ -517,10 +517,6 @@ export class ChannelLiveCollectionController extends LiveCollectionController<
         ),
         action: Amity.ChannelActionType.OnUpdate,
       },
-      {
-        fn: convertEventPayload(onUserFeedMarkerUpdated, 'entityId', 'channel'),
-        action: Amity.ChannelActionType.OnUpdate,
-      },
       {
         fn: convertEventPayload(onSubChannelCreated, 'channelId', 'channel'),
         action: Amity.ChannelActionType.OnUpdate,
@@ -553,6 +549,10 @@ export class ChannelLiveCollectionController extends LiveCollectionController<
         },
         action: Amity.ChannelActionType.OnResolve,
       },
+      {
+        fn: convertEventPayload(onChannelUnreadUpdatedLocal, 'channelId', 'channel'),
+        action: Amity.ChannelActionType.OnUpdate,
+      },
     ];
 
     if (this.paginationController instanceof PaginationController) {

package/src/client/utils/ReadReceiptSync/readReceiptSyncEngine.ts

@@ -2,6 +2,7 @@ import { pullFromCache, pushToCache, queryCache } from '~/cache/api';
 import { getActiveClient } from '../../api/activeClient';
 import { markAsReadBySegment } from '~/subChannelRepository/api/markAsReadBySegment';
 import { reCalculateChannelUnreadInfo } from '~/marker/utils/reCalculateChannelUnreadInfo';
+import { fireEvent } from '~/core/events';
 
 export class MessageReadReceiptSyncEngine {
   private client: Amity.Client;
@@ -178,10 +179,12 @@ export class MessageReadReceiptSyncEngine {
       subChannelUnreadInfo.readToSegment = segment;
       subChannelUnreadInfo.unreadCount = Math.max(subChannelUnreadInfo.lastSegment - segment, 0);
 
-      reCalculateChannelUnreadInfo(subChannelUnreadInfo.channelId);
-    }
+      const channelUnreadInfo = reCalculateChannelUnreadInfo(subChannelUnreadInfo.channelId);
+      fireEvent('local.channelUnread.updated', channelUnreadInfo);
 
-    pushToCache(cacheKey, subChannelUnreadInfo);
+      pushToCache(cacheKey, subChannelUnreadInfo);
+      fireEvent('local.subChannelUnread.updated', subChannelUnreadInfo);
+    }
 
     // Step 2: Enqueue the read receipt
     this.enqueueReadReceipt(subChannelId, segment);

package/src/commentRepository/api/createComment.ts

@@ -53,7 +53,7 @@ export const createComment = async (
   if (['post', 'content'].includes(bundle.referenceType)) {
     const post = await getPost(bundle.referenceId);
 
-    fireEvent('post.updated', {
+    fireEvent('local.post.updated', {
       posts: [post.data],
       categories: [],
       comments: [],
@@ -97,7 +97,7 @@ export const createComment = async (
     }
   }
 
-  fireEvent('comment.created', data);
+  fireEvent('local.comment.created', data);
 
   return {
     data: LinkedObject.comment(comments[0]),

package/src/commentRepository/api/deleteComment.ts

@@ -64,8 +64,7 @@ export const deleteComment = async (
   } else {
     const post = await getPost(comment.data.referenceId);
 
-    // @TODO: Need to separate Local / MQTT later
-    fireEvent('post.updated', {
+    fireEvent('local.post.updated', {
       posts: [post.data],
       categories: [],
       comments: [],
@@ -78,8 +77,7 @@ export const deleteComment = async (
     });
   }
 
-  // @TODO: Need to separate Local / MQTT later
-  fireEvent('comment.deleted', {
+  fireEvent('local.comment.deleted', {
     comments: [deleted],
     commentChildren: [],
     files: [],

package/src/commentRepository/events/utils.ts

@@ -1,5 +1,5 @@
 import { getActiveClient } from '~/client/api';
-import { createEventSubscriber } from '~/core/events';
+import { createEventSubscriber, fireEvent } from '~/core/events';
 import { pullFromCache, pushToCache, queryCache, upsertInCache } from '~/cache/api';
 import { ingestInCache } from '~/cache/api/ingestInCache';
 import { LinkedObject } from '~/utils/linkedObject';

package/src/commentRepository/internalApi/createComment.ts

@@ -27,7 +27,7 @@ export const createComment = async (
 
   const post = await getPost(bundle.referenceId);
 
-  fireEvent('post.updated', {
+  fireEvent('local.post.updated', {
     posts: [post.data],
     categories: [],
     comments: [],
@@ -38,7 +38,8 @@ export const createComment = async (
     postChildren: [],
     users: [],
   });
-  fireEvent('comment.created', data);
+
+  fireEvent('local.comment.created', data);
 
   const { comments } = data;
   return {

package/src/commentRepository/internalApi/deleteComment.ts

@@ -33,7 +33,7 @@ export const deleteComment = async (
 
   const post = await getPost(comment.data.referenceId);
 
-  fireEvent('post.updated', {
+  fireEvent('local.post.updated', {
     posts: [post.data],
     categories: [],
     comments: [],
@@ -45,7 +45,7 @@ export const deleteComment = async (
     users: [],
   });
 
-  fireEvent('comment.deleted', {
+  fireEvent('local.comment.deleted', {
     comments: [deleted],
     commentChildren: [],
     files: [],

package/src/communityRepository/observers/getCommunities/CommunitiesLiveCollectionController.ts

@@ -0,0 +1,147 @@
+/* eslint-disable no-use-before-define */
+import hash from 'object-hash';
+import { pullFromCache, pushToCache } from '~/cache/api';
+import { CommunitiesPaginationController } from './CommunitiesPaginationController';
+import { CommunitiesQueryStreamController } from './CommunitiesQueryStreamController';
+import { LiveCollectionController } from '~/core/liveCollection/LiveCollectionController';
+import {
+  onCommunityCreated,
+  onCommunityDeleted,
+  onCommunityUpdated,
+} from '~/communityRepository/events';
+import {
+  filterByCommunityMembership,
+  filterByPropEquality,
+  sortByDisplayName,
+  sortByFirstCreated,
+  sortByLastCreated,
+} from '~/core/query';
+import { prepareCommunityPayload } from '~/communityRepository/utils';
+import { getActiveClient } from '~/client';
+import { EnumCommunityActions } from './enums';
+
+export class CommunityLiveCollectionController extends LiveCollectionController<
+  'community',
+  Amity.CommunityLiveCollection,
+  Amity.Community,
+  CommunitiesPaginationController
+> {
+  private queryStreamController: CommunitiesQueryStreamController;
+
+  private query: Amity.CommunityLiveCollection;
+
+  constructor(
+    query: Amity.CommunityLiveCollection,
+    callback: Amity.LiveCollectionCallback<Amity.Community>,
+  ) {
+    const queryStreamId = hash(query);
+    const cacheKey = ['community', 'collection', queryStreamId];
+    const paginationController = new CommunitiesPaginationController(query);
+
+    super(paginationController, queryStreamId, cacheKey, callback);
+
+    this.query = query;
+    this.queryStreamController = new CommunitiesQueryStreamController(
+      this.query,
+      this.cacheKey,
+      this.notifyChange.bind(this),
+      prepareCommunityPayload,
+    );
+
+    this.callback = callback.bind(this);
+    this.loadPage({ initial: true });
+  }
+
+  protected setup() {
+    const collection = pullFromCache<Amity.CommunityLiveCollectionCache>(this.cacheKey)?.data;
+    if (!collection) {
+      pushToCache(this.cacheKey, {
+        data: [],
+        params: {},
+      });
+    }
+  }
+
+  protected async persistModel(queryPayload: Amity.CommunityPayload & Amity.Pagination) {
+    await this.queryStreamController.saveToMainDB(queryPayload);
+  }
+
+  protected persistQueryStream({
+    response,
+    direction,
+    refresh,
+  }: Amity.LiveCollectionPersistQueryStreamParams<'community'>) {
+    this.queryStreamController.appendToQueryStream(response, direction, refresh);
+  }
+
+  startSubscription() {
+    return this.queryStreamController.subscribeRTE([
+      { fn: onCommunityCreated, action: EnumCommunityActions.OnCommunityCreated },
+      { fn: onCommunityDeleted, action: EnumCommunityActions.OnCommunityDeleted },
+      { fn: onCommunityUpdated, action: EnumCommunityActions.OnCommunityUpdated },
+    ]);
+  }
+
+  notifyChange({ origin, loading, error }: Amity.LiveCollectionNotifyParams) {
+    const collection = pullFromCache<Amity.CommunityLiveCollectionCache>(this.cacheKey)?.data;
+    if (!collection) return;
+
+    const data = this.applyFilter(
+      collection.data
+        .map(id => pullFromCache<Amity.Community>(['community', 'get', id])!)
+        .filter(Boolean)
+        .map(({ data }) => data) ?? [],
+    );
+
+    if (!this.shouldNotify(data) && origin === 'event') return;
+
+    this.callback({
+      onNextPage: () => this.loadPage({ direction: Amity.LiveCollectionPageDirection.NEXT }),
+      data,
+      hasNextPage: !!this.paginationController.getNextToken(),
+      loading,
+      error,
+    });
+  }
+
+  applyFilter(data: Amity.Community[]) {
+    const { userId } = getActiveClient();
+
+    let communities = data;
+
+    if (this.query.includeDeleted) {
+      communities = filterByPropEquality(communities, 'isDeleted', false);
+    }
+
+    if (this.query.categoryId) {
+      communities = communities.filter(c => c.categoryIds?.includes(this.query.categoryId!));
+    }
+
+    if (this.query.tags) {
+      communities = communities.filter(c => c.tags?.some(t => this.query.tags?.includes(t)));
+    }
+
+    if (this.query.membership && userId) {
+      communities = filterByCommunityMembership(communities, this.query.membership, userId);
+    }
+
+    if (!this.query.displayName) {
+      const sortFn = (() => {
+        switch (this.query.sortBy) {
+          case 'firstCreated':
+            return sortByFirstCreated;
+          case 'lastCreated':
+            return sortByLastCreated;
+          case 'displayName':
+            return sortByDisplayName;
+          default:
+            return sortByLastCreated;
+        }
+      })();
+
+      communities = communities.sort(sortFn);
+    }
+
+    return communities;
+  }
+}

package/src/communityRepository/observers/getCommunities/CommunitiesPaginationController.ts

@@ -0,0 +1,31 @@
+import { PaginationController } from '~/core/liveCollection/PaginationController';
+import { COLLECTION_DEFAULT_PAGINATION_LIMIT } from '~/utils/constants';
+import { inferIsDeleted } from '~/utils/inferIsDeleted';
+
+/**
+ * TODO: handle cache receive cache option, and cache policy
+ * TODO: check if querybyIds is supported
+ */
+export class CommunitiesPaginationController extends PaginationController<
+  'community',
+  Amity.CommunityLiveCollection
+> {
+  async getRequest(queryParams: Amity.CommunityLiveCollection, token: string | undefined) {
+    const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT, ...params } = queryParams;
+    const options = token ? { token } : { limit };
+
+    const { data: queryResponse } = await this.http.get<Amity.CommunityPayload & Amity.Pagination>(
+      `/api/v3/communities`,
+      {
+        params: {
+          ...params,
+          isDeleted: inferIsDeleted(params.includeDeleted),
+          keyword: params.displayName,
+          filter: params.membership,
+          options,
+        },
+      },
+    );
+    return queryResponse;
+  }
+}

package/src/communityRepository/observers/getCommunities/CommunitiesQueryStreamController.ts

@@ -0,0 +1,86 @@
+import { QueryStreamController } from '~/core/liveCollection/QueryStreamController';
+import { pullFromCache, pushToCache } from '~/cache/api';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { getResolver } from '~/core/model';
+import { getActiveClient } from '~/client';
+import { EnumCommunityActions } from './enums';
+
+export class CommunitiesQueryStreamController extends QueryStreamController<
+  Amity.CommunityPayload,
+  Amity.CommunityLiveCollection
+> {
+  private notifyChange: (params: Amity.LiveCollectionNotifyParams) => void;
+
+  private preparePayload: (response: Amity.CommunityPayload) => Amity.ProcessedCommunityPayload;
+
+  constructor(
+    query: Amity.CommunityLiveCollection,
+    cacheKey: string[],
+    notifyChange: (params: Amity.LiveCollectionNotifyParams) => void,
+    preparePayload: (response: Amity.CommunityPayload) => Amity.ProcessedCommunityPayload,
+  ) {
+    super(query, cacheKey);
+    this.notifyChange = notifyChange;
+    this.preparePayload = preparePayload;
+  }
+
+  async saveToMainDB(response: Amity.CommunityPayload) {
+    const processedPayload = await this.preparePayload(response);
+
+    const client = getActiveClient();
+    const cachedAt = client.cache && Date.now();
+
+    if (client.cache) {
+      ingestInCache(processedPayload, { cachedAt });
+    }
+  }
+
+  appendToQueryStream(
+    response: Amity.CommunityPayload & Partial<Amity.Pagination>,
+    direction: Amity.LiveCollectionPageDirection,
+    refresh = false,
+  ) {
+    if (refresh) {
+      pushToCache(this.cacheKey, {
+        data: response.communities.map(getResolver('community')),
+      });
+    } else {
+      const collection = pullFromCache<Amity.CommunityLiveCollectionCache>(this.cacheKey)?.data;
+
+      const communities = collection?.data ?? [];
+
+      pushToCache(this.cacheKey, {
+        ...collection,
+        data: [...new Set([...communities, ...response.communities.map(getResolver('community'))])],
+      });
+    }
+  }
+
+  reactor(action: EnumCommunityActions) {
+    return (community: Amity.Community) => {
+      const collection = pullFromCache<Amity.CommunityLiveCollectionCache>(this.cacheKey)?.data;
+      if (!collection) return;
+
+      if (this.query.displayName && action === EnumCommunityActions.OnCommunityCreated) {
+        return;
+      }
+
+      /*
+       * Simply update collection and let responder decide what to do with data
+       */
+      collection.data = [...new Set([community.communityId, ...collection.data])];
+
+      pushToCache(this.cacheKey, collection);
+      this.notifyChange({ origin: Amity.LiveDataOrigin.EVENT, loading: false });
+    };
+  }
+
+  subscribeRTE(
+    createSubscriber: {
+      fn: (reactor: (channel: Amity.Community) => void) => Amity.Unsubscriber;
+      action: EnumCommunityActions;
+    }[],
+  ) {
+    return createSubscriber.map(subscriber => subscriber.fn(this.reactor(subscriber.action)));
+  }
+}

package/src/communityRepository/observers/getCommunities/enums.ts

@@ -0,0 +1,5 @@
+export enum EnumCommunityActions {
+  OnCommunityCreated = 'onCommunityCreated',
+  OnCommunityDeleted = 'onCommunityDeleted',
+  OnCommunityUpdated = 'onCommunityUpdated',
+}

package/src/communityRepository/observers/index.ts

@@ -1,5 +1,6 @@
 export * from './observeCommunity';
 
+export * from './searchCommunities';
 export * from './getCommunities';
 export * from './getCommunity';
 export * from './getTrendingCommunities';