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

package/dist/@types/domains/hashtag.d.ts

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

package/dist/@types/domains/post.d.ts

@@ -9,7 +9,7 @@ export declare const PostContentType: Readonly<{
 }>;
 declare global {
     namespace Amity {
-        type PostTargetType = Amity.Feed['targetType'] | 'content';
+        type PostTargetType = Amity.Feed['targetType'] | 'content' | 'all';
         type PostContentType = ValueOf<typeof PostContentType> | string;
         type PostActionType = 'onFetch' | 'onCreate' | 'onUpdate' | 'onDelete' | 'onApproved' | 'onDeclined' | 'onFlagged' | 'onUnflagged' | 'onReactionAdded' | 'onReactionRemoved';
         type RawPost<T extends PostContentType = any> = {
@@ -77,7 +77,9 @@ declare global {
             matchingOnlyParentPost?: boolean;
             page?: string;
             limit?: number;
+            hashtags?: string[];
         };
+        type QueryPostsWithHashtags = Pick<Amity.QueryPosts, 'dataTypes' | 'matchingOnlyParentPost' | 'sortBy' | 'page' | 'limit' | 'hashtags'>;
         type PostLiveCollection = Amity.LiveCollectionParams<Omit<QueryPosts, 'sortBy' | 'page'> & {
             sortBy?: 'lastCreated' | 'firstCreated';
         }>;

package/dist/@types/domains/post.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../src/@types/domains/post.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../src/@types/domains/post.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs.js

@@ -23672,6 +23672,60 @@ const createClipPost = async (bundle) => {
 };
 /* end_public_function */
 
+/**
+ * ```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
+ */
+const getPostsByHashtag = async (query) => {
+    const client = getActiveClient();
+    client.log('post/queryByHashtag', query);
+    const { page, limit = 10 } = query, params = __rest(query, ["page", "limit"]);
+    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(`/api/v1/search/posts`, {
+        params: Object.assign(Object.assign({}, 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 !== null && matchingOnlyParentPost !== void 0 ? matchingOnlyParentPost : !(dataTypes === null || dataTypes === void 0 ? void 0 : dataTypes.length), options }),
+    });
+    // API-FIX: backend should answer Amity.Response (2)
+    // const { paging, posts } = unwrapPayload(data)
+    // unpacking
+    const { paging } = data, payload = __rest(data, ["paging"]);
+    const preparedPayload = prepareMembershipPayload(payload, 'communityUsers');
+    const { posts } = payload;
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(preparedPayload, { cachedAt });
+        const cacheKey = ['post', 'query', Object.assign(Object.assign({}, params), { options })];
+        pushToCache(cacheKey, { posts: posts.map(getResolver('post')), paging });
+    }
+    return { data: posts.map(LinkedObject.post), cachedAt, paging };
+};
+
 /* begin_public_function
   id: comment.get_by_ids
 */
@@ -25559,6 +25613,237 @@ const semanticSearchPosts = (params, callback, config) => {
     };
 };
 
+class SearchPostPaginationController extends PaginationController {
+    async getRequest(queryParams, token) {
+        const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT, matchingOnlyParentPost, hashtags } = queryParams, params = __rest(queryParams, ["limit", "matchingOnlyParentPost", "hashtags"]);
+        const { dataTypes } = params;
+        const baseOptions = {
+            type: params.sortBy || queryParams.limit ? 'pagination' : undefined,
+        };
+        const options = token ? Object.assign(Object.assign({}, baseOptions), { token }) : Object.assign(Object.assign({}, baseOptions), { limit });
+        const { data: queryResponse } = await this.http.get(`/api/v1/search/posts`, {
+            params: Object.assign(Object.assign({}, 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 !== null && matchingOnlyParentPost !== void 0 ? matchingOnlyParentPost : !(dataTypes === null || dataTypes === void 0 ? void 0 : dataTypes.length), options }),
+        });
+        return queryResponse;
+    }
+}
+
+class SearchPostQueryStreamController 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 });
+        }
+    }
+    appendToQueryStream(response, direction, refresh = false) {
+        var _a, _b;
+        if (refresh) {
+            pushToCache(this.cacheKey, {
+                data: response.posts.map(getResolver('post')),
+            });
+        }
+        else {
+            const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+            const posts = (_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([...posts, ...response.posts.map(getResolver('post'))])] }));
+        }
+    }
+    reactor(action) {
+        return (post) => {
+            var _a, _b;
+            const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+            if (!collection)
+                return;
+            if (post.parentPostId && post.isDeleted) {
+                const parentPost = (_b = pullFromCache([
+                    'post',
+                    'get',
+                    post.parentPostId,
+                ])) === null || _b === void 0 ? void 0 : _b.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: "event" /* Amity.LiveDataOrigin.EVENT */, loading: false });
+        };
+    }
+    subscribeRTE(createSubscriber) {
+        return createSubscriber.map(subscriber => subscriber.fn(this.reactor(subscriber.action)));
+    }
+}
+
+class SearchPostLiveCollectionController extends LiveCollectionController {
+    constructor(query, callback) {
+        const queryStreamId = hash__default["default"](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 });
+    }
+    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: 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) => {
+                    return onCommentCreated(async (comment) => {
+                        var _a;
+                        const currentCollection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+                        if (!currentCollection || currentCollection.data.includes(comment.referenceId))
+                            return;
+                        await getPost(comment.referenceId);
+                        callback(comment);
+                    });
+                }, 'referenceId', 'post'),
+                action: EnumPostActions.OnPostUpdated,
+            },
+            {
+                fn: convertEventPayload((callback) => {
+                    return onCommentDeleted(async (comment) => {
+                        var _a;
+                        const currentCollection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+                        if (!currentCollection || currentCollection.data.includes(comment.referenceId))
+                            return;
+                        await getPost(comment.referenceId);
+                        callback(comment);
+                    });
+                }, 'referenceId', 'post'),
+                action: EnumPostActions.OnPostUpdated,
+            },
+        ]);
+    }
+    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 = this.applyFilter((_b = collection.data
+            .map(id => pullFromCache(['post', 'get', id]))
+            .filter(isNonNullable)
+            .map(({ data }) => data)) !== null && _b !== void 0 ? _b : []).map(LinkedObject.post);
+        if (!this.shouldNotify(data) && origin === 'event')
+            return;
+        this.callback({
+            onNextPage: () => this.loadPage({ direction: "next" /* Amity.LiveCollectionPageDirection.NEXT */ }),
+            data,
+            hasNextPage: !!this.paginationController.getNextToken(),
+            loading,
+            error,
+        });
+    }
+    applyFilter(data) {
+        var _a;
+        let posts = data;
+        if ((_a = this.query.dataTypes) === null || _a === void 0 ? void 0 : _a.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;
+    }
+}
+
+/* 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
+ */
+const searchPostsByHashtag = (params, callback, config) => {
+    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 */
+
 var index$8 = /*#__PURE__*/Object.freeze({
     __proto__: null,
     getPostByIds: getPostByIds,
@@ -25573,6 +25858,7 @@ var index$8 = /*#__PURE__*/Object.freeze({
     unflagPost: unflagPost,
     isPostFlaggedByMe: isPostFlaggedByMe,
     createClipPost: createClipPost,
+    getPostsByHashtag: getPostsByHashtag,
     onPostCreated: onPostCreated,
     onPostUpdated: onPostUpdated,
     onPostDeleted: onPostDeleted,
@@ -25586,7 +25872,8 @@ var index$8 = /*#__PURE__*/Object.freeze({
     getPosts: getPosts,
     getPinnedPosts: getPinnedPosts,
     getGlobalPinnedPosts: getGlobalPinnedPosts,
-    semanticSearchPosts: semanticSearchPosts
+    semanticSearchPosts: semanticSearchPosts,
+    searchPostsByHashtag: searchPostsByHashtag
 });
 
 /* begin_public_function

package/dist/index.esm.js

@@ -39763,6 +39763,60 @@ const createClipPost = async (bundle) => {
 };
 /* end_public_function */
 
+/**
+ * ```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
+ */
+const getPostsByHashtag = async (query) => {
+    const client = getActiveClient();
+    client.log('post/queryByHashtag', query);
+    const { page, limit = 10 } = query, params = __rest(query, ["page", "limit"]);
+    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(`/api/v1/search/posts`, {
+        params: Object.assign(Object.assign({}, 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 !== null && matchingOnlyParentPost !== void 0 ? matchingOnlyParentPost : !(dataTypes === null || dataTypes === void 0 ? void 0 : dataTypes.length), options }),
+    });
+    // API-FIX: backend should answer Amity.Response (2)
+    // const { paging, posts } = unwrapPayload(data)
+    // unpacking
+    const { paging } = data, payload = __rest(data, ["paging"]);
+    const preparedPayload = prepareMembershipPayload(payload, 'communityUsers');
+    const { posts } = payload;
+    const cachedAt = client.cache && Date.now();
+    if (client.cache) {
+        ingestInCache(preparedPayload, { cachedAt });
+        const cacheKey = ['post', 'query', Object.assign(Object.assign({}, params), { options })];
+        pushToCache(cacheKey, { posts: posts.map(getResolver('post')), paging });
+    }
+    return { data: posts.map(LinkedObject.post), cachedAt, paging };
+};
+
 /* begin_public_function
   id: comment.get_by_ids
 */
@@ -41650,6 +41704,237 @@ const semanticSearchPosts = (params, callback, config) => {
     };
 };
 
+class SearchPostPaginationController extends PaginationController {
+    async getRequest(queryParams, token) {
+        const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT, matchingOnlyParentPost, hashtags } = queryParams, params = __rest(queryParams, ["limit", "matchingOnlyParentPost", "hashtags"]);
+        const { dataTypes } = params;
+        const baseOptions = {
+            type: params.sortBy || queryParams.limit ? 'pagination' : undefined,
+        };
+        const options = token ? Object.assign(Object.assign({}, baseOptions), { token }) : Object.assign(Object.assign({}, baseOptions), { limit });
+        const { data: queryResponse } = await this.http.get(`/api/v1/search/posts`, {
+            params: Object.assign(Object.assign({}, 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 !== null && matchingOnlyParentPost !== void 0 ? matchingOnlyParentPost : !(dataTypes === null || dataTypes === void 0 ? void 0 : dataTypes.length), options }),
+        });
+        return queryResponse;
+    }
+}
+
+class SearchPostQueryStreamController 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 });
+        }
+    }
+    appendToQueryStream(response, direction, refresh = false) {
+        var _a, _b;
+        if (refresh) {
+            pushToCache(this.cacheKey, {
+                data: response.posts.map(getResolver('post')),
+            });
+        }
+        else {
+            const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+            const posts = (_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([...posts, ...response.posts.map(getResolver('post'))])] }));
+        }
+    }
+    reactor(action) {
+        return (post) => {
+            var _a, _b;
+            const collection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+            if (!collection)
+                return;
+            if (post.parentPostId && post.isDeleted) {
+                const parentPost = (_b = pullFromCache([
+                    'post',
+                    'get',
+                    post.parentPostId,
+                ])) === null || _b === void 0 ? void 0 : _b.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: "event" /* Amity.LiveDataOrigin.EVENT */, loading: false });
+        };
+    }
+    subscribeRTE(createSubscriber) {
+        return createSubscriber.map(subscriber => subscriber.fn(this.reactor(subscriber.action)));
+    }
+}
+
+class SearchPostLiveCollectionController extends LiveCollectionController {
+    constructor(query, callback) {
+        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 });
+    }
+    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: 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) => {
+                    return onCommentCreated(async (comment) => {
+                        var _a;
+                        const currentCollection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+                        if (!currentCollection || currentCollection.data.includes(comment.referenceId))
+                            return;
+                        await getPost(comment.referenceId);
+                        callback(comment);
+                    });
+                }, 'referenceId', 'post'),
+                action: EnumPostActions.OnPostUpdated,
+            },
+            {
+                fn: convertEventPayload((callback) => {
+                    return onCommentDeleted(async (comment) => {
+                        var _a;
+                        const currentCollection = (_a = pullFromCache(this.cacheKey)) === null || _a === void 0 ? void 0 : _a.data;
+                        if (!currentCollection || currentCollection.data.includes(comment.referenceId))
+                            return;
+                        await getPost(comment.referenceId);
+                        callback(comment);
+                    });
+                }, 'referenceId', 'post'),
+                action: EnumPostActions.OnPostUpdated,
+            },
+        ]);
+    }
+    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 = this.applyFilter((_b = collection.data
+            .map(id => pullFromCache(['post', 'get', id]))
+            .filter(isNonNullable)
+            .map(({ data }) => data)) !== null && _b !== void 0 ? _b : []).map(LinkedObject.post);
+        if (!this.shouldNotify(data) && origin === 'event')
+            return;
+        this.callback({
+            onNextPage: () => this.loadPage({ direction: "next" /* Amity.LiveCollectionPageDirection.NEXT */ }),
+            data,
+            hasNextPage: !!this.paginationController.getNextToken(),
+            loading,
+            error,
+        });
+    }
+    applyFilter(data) {
+        var _a;
+        let posts = data;
+        if ((_a = this.query.dataTypes) === null || _a === void 0 ? void 0 : _a.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;
+    }
+}
+
+/* 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
+ */
+const searchPostsByHashtag = (params, callback, config) => {
+    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 */
+
 var index$8 = /*#__PURE__*/Object.freeze({
     __proto__: null,
     getPostByIds: getPostByIds,
@@ -41664,6 +41949,7 @@ var index$8 = /*#__PURE__*/Object.freeze({
     unflagPost: unflagPost,
     isPostFlaggedByMe: isPostFlaggedByMe,
     createClipPost: createClipPost,
+    getPostsByHashtag: getPostsByHashtag,
     onPostCreated: onPostCreated,
     onPostUpdated: onPostUpdated,
     onPostDeleted: onPostDeleted,
@@ -41677,7 +41963,8 @@ var index$8 = /*#__PURE__*/Object.freeze({
     getPosts: getPosts,
     getPinnedPosts: getPinnedPosts,
     getGlobalPinnedPosts: getGlobalPinnedPosts,
-    semanticSearchPosts: semanticSearchPosts
+    semanticSearchPosts: semanticSearchPosts,
+    searchPostsByHashtag: searchPostsByHashtag
 });
 
 /* begin_public_function