@amityco/ts-sdk 7.7.1-c7691770.0 → 7.7.1-cfb204b8.0

package/dist/postRepository/api/getPostsByHashtag.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk';
+ * const { data: posts, prevPage, nextPage } = await PostRepository.searchPostsByHashtag({ hashtags: ['amity'], limit: 10 });
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.Post} objects
+ *
+ * @param query The query parameters
+ * @returns posts
+ * @category Post API
+ * @async
+ */
+export declare const getPostsByHashtag: (query: Amity.QueryPostsWithHashtags) => Promise<Amity.Cached<Amity.PageToken<Amity.Post>>>;
+//# sourceMappingURL=getPostsByHashtag.d.ts.map

package/dist/postRepository/api/getPostsByHashtag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPostsByHashtag.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/getPostsByHashtag.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,UACrB,MAAM,sBAAsB,KAClC,QAAQ,MAAM,MAAM,CAAC,MAAM,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,CAqDnD,CAAC"}

package/dist/postRepository/api/index.d.ts

@@ -10,4 +10,5 @@ export * from './flagPost';
 export * from './unflagPost';
 export * from './isPostFlaggedByMe';
 export * from './createClipPost';
+export * from './getPostsByHashtag';
 //# sourceMappingURL=index.d.ts.map

package/dist/postRepository/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,qBAAqB,CAAC"}

package/dist/postRepository/observers/getPostsByHashtag/SearchPostLiveCollectionController.d.ts

@@ -0,0 +1,14 @@
+import { SearchPostPaginationController } from './SearchPostPaginationController';
+import { LiveCollectionController } from '~/core/liveCollection/LiveCollectionController';
+export declare class SearchPostLiveCollectionController extends LiveCollectionController<'post', Amity.PostLiveCollection, Amity.Post, SearchPostPaginationController> {
+    private queryStreamController;
+    private query;
+    constructor(query: Amity.PostLiveCollection, callback: Amity.LiveCollectionCallback<Amity.Post>);
+    protected setup(): void;
+    protected persistModel(queryPayload: Amity.PostPayload & Amity.Pagination): Promise<void>;
+    protected persistQueryStream({ response, direction, refresh, }: Amity.LiveCollectionPersistQueryStreamParams<'post'>): void;
+    startSubscription(): Amity.Unsubscriber[];
+    notifyChange({ origin, loading, error }: Amity.LiveCollectionNotifyParams): void;
+    applyFilter(data: Amity.InternalPost[]): Amity.InternalPost<any>[];
+}
+//# sourceMappingURL=SearchPostLiveCollectionController.d.ts.map

package/dist/postRepository/observers/getPostsByHashtag/SearchPostLiveCollectionController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchPostLiveCollectionController.d.ts","sourceRoot":"","sources":["../../../../src/postRepository/observers/getPostsByHashtag/SearchPostLiveCollectionController.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAElF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAyB1F,qBAAa,kCAAmC,SAAQ,wBAAwB,CAC9E,MAAM,EACN,KAAK,CAAC,kBAAkB,EACxB,KAAK,CAAC,IAAI,EACV,8BAA8B,CAC/B;IACC,OAAO,CAAC,qBAAqB,CAAkC;IAE/D,OAAO,CAAC,KAAK,CAA2B;gBAE5B,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,QAAQ,EAAE,KAAK,CAAC,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC;IAmB/F,SAAS,CAAC,KAAK;cAUC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU;IAI/E,SAAS,CAAC,kBAAkB,CAAC,EAC3B,QAAQ,EACR,SAAS,EACT,OAAO,GACR,EAAE,KAAK,CAAC,sCAAsC,CAAC,MAAM,CAAC;IAIvD,iBAAiB;IA0DjB,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,0BAA0B;IAsBzE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE;CAmBvC"}

package/dist/postRepository/observers/getPostsByHashtag/SearchPostPaginationController.d.ts

@@ -0,0 +1,5 @@
+import { PaginationController } from '~/core/liveCollection/PaginationController';
+export declare class SearchPostPaginationController extends PaginationController<'post', Amity.PostLiveCollection> {
+    getRequest(queryParams: Amity.PostLiveCollection, token: string | undefined): Promise<Amity.PostPayload<any> & Amity.Pagination>;
+}
+//# sourceMappingURL=SearchPostPaginationController.d.ts.map

package/dist/postRepository/observers/getPostsByHashtag/SearchPostPaginationController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchPostPaginationController.d.ts","sourceRoot":"","sources":["../../../../src/postRepository/observers/getPostsByHashtag/SearchPostPaginationController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAIlF,qBAAa,8BAA+B,SAAQ,oBAAoB,CACtE,MAAM,EACN,KAAK,CAAC,kBAAkB,CACzB;IACO,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;CAoClF"}

package/dist/postRepository/observers/getPostsByHashtag/SearchPostQueryStreamController.d.ts

@@ -0,0 +1,15 @@
+import { QueryStreamController } from '~/core/liveCollection/QueryStreamController';
+import { EnumPostActions } from '../enums';
+export declare class SearchPostQueryStreamController extends QueryStreamController<Amity.PostPayload, Amity.PostLiveCollection> {
+    private notifyChange;
+    private preparePayload;
+    constructor(query: Amity.PostLiveCollection, cacheKey: string[], notifyChange: (params: Amity.LiveCollectionNotifyParams) => void, preparePayload: (response: Amity.PostPayload) => Amity.ProcessedPostPayload);
+    saveToMainDB(response: Amity.PostPayload): Promise<void>;
+    appendToQueryStream(response: Amity.PostPayload & Partial<Amity.Pagination>, direction: Amity.LiveCollectionPageDirection, refresh?: boolean): void;
+    reactor(action: EnumPostActions): (post: Amity.InternalPost) => void;
+    subscribeRTE(createSubscriber: {
+        fn: (reactor: (post: Amity.InternalPost) => void) => Amity.Unsubscriber;
+        action: EnumPostActions;
+    }[]): Amity.Unsubscriber[];
+}
+//# sourceMappingURL=SearchPostQueryStreamController.d.ts.map

package/dist/postRepository/observers/getPostsByHashtag/SearchPostQueryStreamController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchPostQueryStreamController.d.ts","sourceRoot":"","sources":["../../../../src/postRepository/observers/getPostsByHashtag/SearchPostQueryStreamController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAKpF,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,qBAAa,+BAAgC,SAAQ,qBAAqB,CACxE,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,kBAAkB,CACzB;IACC,OAAO,CAAC,YAAY,CAAqD;IAEzE,OAAO,CAAC,cAAc,CAA8D;gBAGlF,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAC/B,QAAQ,EAAE,MAAM,EAAE,EAClB,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,0BAA0B,KAAK,IAAI,EAChE,cAAc,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,oBAAoB;IAOvE,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW;IAW9C,mBAAmB,CACjB,QAAQ,EAAE,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EACvD,SAAS,EAAE,KAAK,CAAC,2BAA2B,EAC5C,OAAO,UAAQ;IAkBjB,OAAO,CAAC,MAAM,EAAE,eAAe,UACf,MAAM,YAAY;IA+BlC,YAAY,CACV,gBAAgB,EAAE;QAChB,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,KAAK,KAAK,CAAC,YAAY,CAAC;QACxE,MAAM,EAAE,eAAe,CAAC;KACzB,EAAE;CAIN"}

package/dist/postRepository/observers/index.d.ts

@@ -3,4 +3,5 @@ export * from './getPosts';
 export * from './getPinnedPosts';
 export * from './getGlobalPinnedPosts';
 export * from './semanticSearchPosts';
+export * from './searchPostsByHashtag';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/observers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/observers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/postRepository/observers/searchPostsByHashtag.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk'
+ *
+ * let posts = []
+ * const unsub = PostRepository.searchPostsByHashtag({
+ *   hashtags: ['amity'],
+ *   limit: 10,
+ * }, response => merge(posts, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Post} for a given target object
+ *
+ * @param params.hashtags the hashtags to search for
+ * @param callback the function to call when new data are available
+ * @param config
+ * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the messages
+ *
+ * @category Posts Live Collection
+ */
+export declare const searchPostsByHashtag: (params: Amity.PostLiveCollection, callback: Amity.LiveCollectionCallback<Amity.Post>, config?: Amity.LiveCollectionConfig) => Amity.Unsubscriber;
+//# sourceMappingURL=searchPostsByHashtag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searchPostsByHashtag.d.ts","sourceRoot":"","sources":["../../../src/postRepository/observers/searchPostsByHashtag.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,WACvB,MAAM,kBAAkB,YACtB,MAAM,sBAAsB,CAAC,MAAM,IAAI,CAAC,WACzC,MAAM,oBAAoB,KAClC,MAAM,YAqBR,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/ts-sdk",
-  "version": "7.7.1-c7691770.0",
+  "version": "7.7.1-cfb204b8.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/domains/hashtag.ts

@@ -5,7 +5,7 @@ declare global {
     type Hashtag = {
       text: string;
       index: number;
-      lenght: number;
+      length: number;
     };
   }
 }

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

@@ -11,7 +11,7 @@ export const PostContentType = Object.freeze({
 declare global {
   namespace Amity {
     // bad hack until we get proper feed objects in backend
-    type PostTargetType = Amity.Feed['targetType'] | 'content';
+    type PostTargetType = Amity.Feed['targetType'] | 'content' | 'all';
 
     type PostContentType = ValueOf<typeof PostContentType> | string;
 
@@ -106,8 +106,14 @@ declare global {
       matchingOnlyParentPost?: boolean;
       page?: string;
       limit?: number;
+      hashtags?: string[];
     };
 
+    type QueryPostsWithHashtags = Pick<
+      Amity.QueryPosts,
+      'dataTypes' | 'matchingOnlyParentPost' | 'sortBy' | 'page' | 'limit' | 'hashtags'
+    >;
+
     // Omit sortBy explained in asc-3398
     type PostLiveCollection = Amity.LiveCollectionParams<
       Omit<QueryPosts, 'sortBy' | 'page'> & {

package/src/postRepository/api/getPostsByHashtag.ts

@@ -0,0 +1,78 @@
+import { getActiveClient } from '~/client/api';
+
+import { pushToCache } from '~/cache/api';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { getResolver } from '~/core/model';
+
+import { prepareMembershipPayload } from '~/group/utils';
+import { LinkedObject } from '~/utils/linkedObject';
+
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk';
+ * const { data: posts, prevPage, nextPage } = await PostRepository.searchPostsByHashtag({ hashtags: ['amity'], limit: 10 });
+ * ```
+ *
+ * Queries a paginable list of {@link Amity.Post} objects
+ *
+ * @param query The query parameters
+ * @returns posts
+ * @category Post API
+ * @async
+ */
+export const getPostsByHashtag = async (
+  query: Amity.QueryPostsWithHashtags,
+): Promise<Amity.Cached<Amity.PageToken<Amity.Post>>> => {
+  const client = getActiveClient();
+  client.log('post/queryByHashtag', query);
+
+  const { page, limit = 10, ...params } = query;
+  const { dataTypes, matchingOnlyParentPost, hashtags } = params;
+
+  const options = (() => {
+    if (page) return { token: page };
+    if (limit) return { limit };
+
+    return undefined;
+  })();
+
+  // API-FIX: parameters should be querystring. (1)
+  // API-FIX: backend should answer Amity.Response (2)
+  // const { data } = await client.http.get<Amity.Response<Amity.PagedResponse<Amity.PostPayload>>>(
+  const { data } = await client.http.get<Amity.PostPayload & Amity.Pagination>(
+    `/api/v1/search/posts`,
+    {
+      params: {
+        ...params,
+        hashtags,
+        /*
+         * when creating post like image, file, video BE will create 2 posts
+         * 1. parent post to store text with dataType=text
+         * 2. child post to store dataTypes post data
+         *
+         * By default, BE queries only parent post
+         */
+        matchingOnlyParentPost: matchingOnlyParentPost ?? !dataTypes?.length,
+        options,
+      },
+    },
+  );
+
+  // API-FIX: backend should answer Amity.Response (2)
+  // const { paging, posts } = unwrapPayload(data)
+  // unpacking
+  const { paging, ...payload } = data;
+  const preparedPayload = prepareMembershipPayload(payload, 'communityUsers');
+  const { posts } = payload;
+
+  const cachedAt = client.cache && Date.now();
+
+  if (client.cache) {
+    ingestInCache(preparedPayload, { cachedAt });
+
+    const cacheKey = ['post', 'query', { ...params, options } as Amity.Serializable];
+    pushToCache(cacheKey, { posts: posts.map(getResolver('post')), paging });
+  }
+
+  return { data: posts.map(LinkedObject.post), cachedAt, paging };
+};

package/src/postRepository/api/index.ts

@@ -15,3 +15,5 @@ export * from './unflagPost';
 export * from './isPostFlaggedByMe';
 
 export * from './createClipPost';
+
+export * from './getPostsByHashtag';

package/src/postRepository/api/queryPosts.ts

@@ -63,13 +63,13 @@ export const queryPosts = async (
   // const { paging, posts } = unwrapPayload(data)
   // unpacking
   const { paging, ...payload } = data;
-  const paperedPayload = prepareMembershipPayload(payload, 'communityUsers');
+  const preparedPayload = prepareMembershipPayload(payload, 'communityUsers');
   const { posts } = payload;
 
   const cachedAt = client.cache && Date.now();
 
   if (client.cache) {
-    ingestInCache(paperedPayload, { cachedAt });
+    ingestInCache(preparedPayload, { cachedAt });
 
     const cacheKey = ['post', 'query', { ...params, options } as Amity.Serializable];
     pushToCache(cacheKey, { posts: posts.map(getResolver('post')), paging });

package/src/postRepository/observers/getPostsByHashtag/SearchPostLiveCollectionController.ts

@@ -0,0 +1,180 @@
+import hash from 'object-hash';
+import { pullFromCache, pushToCache } from '~/cache/api';
+import { SearchPostPaginationController } from './SearchPostPaginationController';
+import { SearchPostQueryStreamController } from './SearchPostQueryStreamController';
+import { LiveCollectionController } from '~/core/liveCollection/LiveCollectionController';
+import {
+  onPostCreated,
+  onPostUpdated,
+  onPostDeleted,
+  onPostFlagged,
+  onPostUnflagged,
+  onPostReactionAdded,
+  onPostReactionRemoved,
+  onPostApproved,
+  onPostDeclined,
+} from '~/postRepository/events';
+import { filterByPostDataTypes, sortByFirstCreated, sortByLastCreated } from '~/core/query';
+import { isNonNullable } from '~/utils';
+import { EnumPostActions } from '../enums';
+import { LinkedObject } from '~/utils/linkedObject';
+import { preparePostPayload } from '~/postRepository/utils/payload';
+import { convertEventPayload } from '~/utils/event';
+import { onCommentCreated, onCommentDeleted } from '~/commentRepository';
+import { getPost } from '~/postRepository/internalApi/getPost';
+import { onPostUpdatedLocal } from '~/postRepository/events/onPostUpdatedLocal';
+import { onLocalPostReactionAdded } from '~/postRepository/events/onLocalPostReactionAdded';
+import { onLocalPostReactionRemoved } from '~/postRepository/events/onLocalPostReactionRemoved';
+import { onLocalPostDeleted } from '~/postRepository/events/onLocalPostDeleted';
+
+export class SearchPostLiveCollectionController extends LiveCollectionController<
+  'post',
+  Amity.PostLiveCollection,
+  Amity.Post,
+  SearchPostPaginationController
+> {
+  private queryStreamController: SearchPostQueryStreamController;
+
+  private query: Amity.PostLiveCollection;
+
+  constructor(query: Amity.PostLiveCollection, callback: Amity.LiveCollectionCallback<Amity.Post>) {
+    const queryStreamId = hash(query);
+    const cacheKey = ['posts', 'collection', queryStreamId];
+    const paginationController = new SearchPostPaginationController(query);
+
+    super(paginationController, queryStreamId, cacheKey, callback);
+
+    this.query = query;
+    this.queryStreamController = new SearchPostQueryStreamController(
+      this.query,
+      this.cacheKey,
+      this.notifyChange.bind(this),
+      preparePostPayload,
+    );
+
+    this.callback = callback.bind(this);
+    this.loadPage({ initial: true });
+  }
+
+  protected setup() {
+    const collection = pullFromCache<Amity.PostLiveCollectionCache>(this.cacheKey)?.data;
+    if (!collection) {
+      pushToCache(this.cacheKey, {
+        data: [],
+        params: {},
+      });
+    }
+  }
+
+  protected async persistModel(queryPayload: Amity.PostPayload & Amity.Pagination) {
+    await this.queryStreamController.saveToMainDB(queryPayload);
+  }
+
+  protected persistQueryStream({
+    response,
+    direction,
+    refresh,
+  }: Amity.LiveCollectionPersistQueryStreamParams<'post'>) {
+    this.queryStreamController.appendToQueryStream(response, direction, refresh);
+  }
+
+  startSubscription() {
+    return this.queryStreamController.subscribeRTE([
+      { fn: onPostCreated, action: EnumPostActions.OnPostCreated },
+      { fn: onPostUpdated, action: EnumPostActions.OnPostUpdated },
+      { fn: onPostUpdatedLocal, action: EnumPostActions.OnPostUpdated },
+      { fn: onPostDeleted, action: EnumPostActions.OnPostDeleted },
+      { fn: onPostFlagged, action: EnumPostActions.OnPostFlagged },
+      { fn: onPostUnflagged, action: EnumPostActions.OnPostUnflagged },
+      { fn: onPostApproved, action: EnumPostActions.OnPostApproved },
+      { fn: onPostDeclined, action: EnumPostActions.OnPostDeclined },
+      { fn: onPostReactionAdded, action: EnumPostActions.OnPostReactionAdded },
+      { fn: onPostReactionRemoved, action: EnumPostActions.OnPostReactionRemoved },
+      { fn: onLocalPostReactionAdded, action: EnumPostActions.OnPostReactionAdded },
+      { fn: onLocalPostReactionRemoved, action: EnumPostActions.OnPostReactionRemoved },
+      { fn: onLocalPostDeleted, action: EnumPostActions.OnPostDeleted },
+      {
+        fn: convertEventPayload(
+          (callback: Amity.Listener<Amity.InternalComment>) => {
+            return onCommentCreated(async (comment: Amity.InternalComment) => {
+              const currentCollection = pullFromCache<Amity.PostLiveCollectionCache>(
+                this.cacheKey,
+              )?.data;
+
+              if (!currentCollection || currentCollection.data.includes(comment.referenceId))
+                return;
+
+              await getPost(comment.referenceId);
+              callback(comment);
+            });
+          },
+          'referenceId',
+          'post',
+        ),
+        action: EnumPostActions.OnPostUpdated,
+      },
+      {
+        fn: convertEventPayload(
+          (callback: Amity.Listener<Amity.InternalComment>) => {
+            return onCommentDeleted(async (comment: Amity.InternalComment) => {
+              const currentCollection = pullFromCache<Amity.PostLiveCollectionCache>(
+                this.cacheKey,
+              )?.data;
+
+              if (!currentCollection || currentCollection.data.includes(comment.referenceId))
+                return;
+
+              await getPost(comment.referenceId);
+              callback(comment);
+            });
+          },
+          'referenceId',
+          'post',
+        ),
+        action: EnumPostActions.OnPostUpdated,
+      },
+    ]);
+  }
+
+  notifyChange({ origin, loading, error }: Amity.LiveCollectionNotifyParams) {
+    const collection = pullFromCache<Amity.PostLiveCollectionCache>(this.cacheKey)?.data;
+    if (!collection) return;
+
+    const data = this.applyFilter(
+      collection.data
+        .map(id => pullFromCache<Amity.InternalPost>(['post', 'get', id])!)
+        .filter(isNonNullable)
+        .map(({ data }) => data) ?? [],
+    ).map(LinkedObject.post);
+
+    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.InternalPost[]) {
+    let posts = data;
+
+    if (this.query.dataTypes?.length) {
+      posts = filterByPostDataTypes(posts, this.query.dataTypes);
+    }
+
+    switch (this.query.sortBy) {
+      case 'firstCreated':
+        posts = posts.sort(sortByFirstCreated);
+        break;
+      case 'lastCreated':
+      default:
+        posts = posts.sort(sortByLastCreated);
+        break;
+    }
+
+    return posts;
+  }
+}

package/src/postRepository/observers/getPostsByHashtag/SearchPostPaginationController.ts

@@ -0,0 +1,45 @@
+import { PaginationController } from '~/core/liveCollection/PaginationController';
+import { COLLECTION_DEFAULT_PAGINATION_LIMIT } from '~/utils/constants';
+import { inferIsDeleted } from '~/utils/inferIsDeleted';
+
+export class SearchPostPaginationController extends PaginationController<
+  'post',
+  Amity.PostLiveCollection
+> {
+  async getRequest(queryParams: Amity.PostLiveCollection, token: string | undefined) {
+    const {
+      limit = COLLECTION_DEFAULT_PAGINATION_LIMIT,
+      matchingOnlyParentPost,
+      hashtags,
+      ...params
+    } = queryParams;
+
+    const { dataTypes } = params;
+
+    const baseOptions = {
+      type: params.sortBy || queryParams.limit ? 'pagination' : undefined,
+    };
+
+    const options = token ? { ...baseOptions, token } : { ...baseOptions, limit };
+
+    const { data: queryResponse } = await this.http.get<Amity.PostPayload & Amity.Pagination>(
+      `/api/v1/search/posts`,
+      {
+        params: {
+          ...params,
+          hashtags,
+          /*
+           * when creating post like image, file, video BE will create 2 posts
+           * 1. parent post to store text with dataType=text
+           * 2. child post to store dataTypes post data
+           *
+           * By default, BE queries only parent post
+           */
+          matchingOnlyParentPost: matchingOnlyParentPost ?? !dataTypes?.length,
+          options,
+        },
+      },
+    );
+    return queryResponse;
+  }
+}

package/src/postRepository/observers/getPostsByHashtag/SearchPostQueryStreamController.ts

@@ -0,0 +1,99 @@
+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 { EnumPostActions } from '../enums';
+
+export class SearchPostQueryStreamController extends QueryStreamController<
+  Amity.PostPayload,
+  Amity.PostLiveCollection
+> {
+  private notifyChange: (params: Amity.LiveCollectionNotifyParams) => void;
+
+  private preparePayload: (response: Amity.PostPayload) => Amity.ProcessedPostPayload;
+
+  constructor(
+    query: Amity.PostLiveCollection,
+    cacheKey: string[],
+    notifyChange: (params: Amity.LiveCollectionNotifyParams) => void,
+    preparePayload: (response: Amity.PostPayload) => Amity.ProcessedPostPayload,
+  ) {
+    super(query, cacheKey);
+    this.notifyChange = notifyChange;
+    this.preparePayload = preparePayload;
+  }
+
+  async saveToMainDB(response: Amity.PostPayload) {
+    const processedPayload = await this.preparePayload(response);
+
+    const client = getActiveClient();
+    const cachedAt = client.cache && Date.now();
+
+    if (client.cache) {
+      ingestInCache(processedPayload, { cachedAt });
+    }
+  }
+
+  appendToQueryStream(
+    response: Amity.PostPayload & Partial<Amity.Pagination>,
+    direction: Amity.LiveCollectionPageDirection,
+    refresh = false,
+  ) {
+    if (refresh) {
+      pushToCache(this.cacheKey, {
+        data: response.posts.map(getResolver('post')),
+      });
+    } else {
+      const collection = pullFromCache<Amity.PostLiveCollectionCache>(this.cacheKey)?.data;
+
+      const posts = collection?.data ?? [];
+
+      pushToCache(this.cacheKey, {
+        ...collection,
+        data: [...new Set([...posts, ...response.posts.map(getResolver('post'))])],
+      });
+    }
+  }
+
+  reactor(action: EnumPostActions) {
+    return (post: Amity.InternalPost) => {
+      const collection = pullFromCache<Amity.PostLiveCollectionCache>(this.cacheKey)?.data;
+
+      if (!collection) return;
+
+      if (post.parentPostId && post.isDeleted) {
+        const parentPost = pullFromCache<Amity.InternalPost>([
+          'post',
+          'get',
+          post.parentPostId,
+        ])?.data;
+
+        if (!parentPost) return;
+
+        parentPost.children = parentPost.children.filter(childId => childId !== post.postId);
+        pushToCache(['post', 'get', parentPost.postId], parentPost);
+      }
+
+      if (action === EnumPostActions.OnPostDeclined) {
+        collection.data = collection.data.filter(postId => postId !== post.postId);
+      }
+
+      if (action === EnumPostActions.OnPostCreated || action === EnumPostActions.OnPostApproved) {
+        collection.data = [...new Set([post.postId, ...collection.data])];
+      }
+
+      pushToCache(this.cacheKey, collection);
+      this.notifyChange({ origin: Amity.LiveDataOrigin.EVENT, loading: false });
+    };
+  }
+
+  subscribeRTE(
+    createSubscriber: {
+      fn: (reactor: (post: Amity.InternalPost) => void) => Amity.Unsubscriber;
+      action: EnumPostActions;
+    }[],
+  ) {
+    return createSubscriber.map(subscriber => subscriber.fn(this.reactor(subscriber.action)));
+  }
+}

package/src/postRepository/observers/index.ts

@@ -3,3 +3,4 @@ export * from './getPosts';
 export * from './getPinnedPosts';
 export * from './getGlobalPinnedPosts';
 export * from './semanticSearchPosts';
+export * from './searchPostsByHashtag';

package/src/postRepository/observers/searchPostsByHashtag.ts

@@ -0,0 +1,56 @@
+import { getActiveClient } from '~/client/api';
+import { dropFromCache } from '~/cache/api';
+
+import { ENABLE_CACHE_MESSAGE } from '~/utils/constants';
+import { SearchPostLiveCollectionController } from './getPostsByHashtag/SearchPostLiveCollectionController';
+
+/* begin_public_function
+  id: post.query
+*/
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk'
+ *
+ * let posts = []
+ * const unsub = PostRepository.searchPostsByHashtag({
+ *   hashtags: ['amity'],
+ *   limit: 10,
+ * }, response => merge(posts, response.data))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Post} for a given target object
+ *
+ * @param params.hashtags the hashtags to search for
+ * @param callback the function to call when new data are available
+ * @param config
+ * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the messages
+ *
+ * @category Posts Live Collection
+ */
+export const searchPostsByHashtag = (
+  params: Amity.PostLiveCollection,
+  callback: Amity.LiveCollectionCallback<Amity.Post>,
+  config?: Amity.LiveCollectionConfig,
+): Amity.Unsubscriber => {
+  const { log, cache } = getActiveClient();
+
+  if (!cache) {
+    console.log(ENABLE_CACHE_MESSAGE);
+  }
+
+  const timestamp = Date.now();
+  log(`searchPostsByHashtag(tmpid: ${timestamp}) > listen`);
+
+  const postsLiveCollection = new SearchPostLiveCollectionController(params, callback);
+  const disposers = postsLiveCollection.startSubscription();
+
+  const cacheKey = postsLiveCollection.getCacheKey();
+
+  disposers.push(() => dropFromCache(cacheKey));
+
+  return () => {
+    log(`searchPostsByHashtag(tmpid: ${timestamp}) > dispose`);
+    disposers.forEach(fn => fn());
+  };
+};
+/* end_public_function */