@amityco/ts-sdk 7.8.1-fbfc876d.0 → 7.8.1

package/dist/liveReactionRepository/api/createReaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createReaction.d.ts","sourceRoot":"","sources":["../../../src/liveReactionRepository/api/createReaction.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc;iBAMZ,MAAM;cACT,MAAM;MACd,QAAQ,OAAO,CAyBlB,CAAC"}
+{"version":3,"file":"createReaction.d.ts","sourceRoot":"","sources":["../../../src/liveReactionRepository/api/createReaction.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc;iBAMZ,MAAM;cACT,MAAM;MACd,QAAQ,OAAO,CAwBlB,CAAC"}

package/dist/pollRepository/api/createPoll.d.ts

@@ -4,8 +4,8 @@
  * const created = await createPoll({
  *   question: 'question',
  *   answers: [
- *      { dataType: 'text', data: 'answer1' },
- *      { dataType: 'text', data: 'answer2' },
+ *      { dataType: 'text', data: 'answer1', fileId: 'fileId1' },
+ *      { dataType: 'text', data: 'answer2', fileId: 'fileId2' },
  *   ],
  *   closedIn: 1649136484
  * }))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/ts-sdk",
-  "version": "7.8.1-fbfc876d.0",
+  "version": "7.8.1",
   "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/client.ts

@@ -116,6 +116,11 @@ declare global {
       };
     };
 
+    type ShareableLinkConfiguration = {
+      domain: string;
+      patterns: Record<string, string>;
+    };
+
     type FeedSettings = {
       [name in Amity.ContentFeedType]?: Amity.ContentSetting[];
     };

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

@@ -28,6 +28,7 @@ declare global {
     const enum CommunitySortByEnum {
       FirstCreated = 'firstCreated',
       LastCreated = 'lastCreated',
+      DisplayName = 'displayName',
     }
 
     type CommunitySortBy = `${Amity.CommunitySortByEnum}`;

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

@@ -1,7 +1,35 @@
 export {};
 
+export const enum FeedDataTypeEnum {
+  Text = 'text',
+  Video = 'video',
+  Image = 'image',
+  File = 'file',
+  LiveStream = 'liveStream',
+  Clip = 'clip',
+  Poll = 'poll',
+}
+
+export const enum FeedSortByEnum {
+  LastCreated = 'lastCreated',
+  FirstCreated = 'firstCreated',
+  LastUpdated = 'lastUpdated',
+  FirstUpdated = 'firstUpdated',
+}
+
+export const enum FeedSourceEnum {
+  Community = 'community',
+  User = 'user',
+}
+
 declare global {
   namespace Amity {
+    type FeedDataType = FeedDataTypeEnum;
+
+    type FeedSortBy = FeedSortByEnum;
+
+    type FeedSource = FeedSourceEnum;
+
     type Feed = {
       feedId: string;
       feedType: 'reviewing' | 'published';
@@ -31,5 +59,21 @@ declare global {
       Amity.InternalPost['postId'],
       QueryGlobalFeed
     >;
+
+    type QueryUserFeed = {
+      userId: string;
+      includeDeleted?: boolean;
+      sortBy?: Amity.FeedSortBy;
+      dataTypes?: Amity.FeedDataType[];
+      matchingOnlyParentPost?: boolean;
+      feedSources?: Amity.FeedSource[];
+    };
+
+    type UserFeedLiveCollection = Amity.LiveCollectionParams<QueryUserFeed>;
+
+    type UserFeedLiveCollectionCache = Amity.LiveCollectionCache<
+      Amity.InternalPost['postId'],
+      QueryUserFeed
+    >;
   }
 }

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

@@ -24,12 +24,9 @@ declare global {
       'params'
     >;
 
-    type PinnedPost = {
+    type PinnedPost = Amity.RawPin & {
       post: Amity.Post | undefined;
-      placement: Amity.Pin['placement'];
       target: Amity.PinTarget | undefined;
-      pinnedBy: Amity.User;
-      pinnedAt: Date;
     };
 
     type GlobalPinnedPostLiveCollection = Amity.LiveCollectionParams<{}>;

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

@@ -2,7 +2,7 @@ export {};
 
 declare global {
   namespace Amity {
-    type PollDataType = 'text';
+    type PollDataType = 'text' | 'image';
 
     type PollAnswerType = 'single' | 'multiple';
 
@@ -12,6 +12,7 @@ declare global {
       data: string;
       voteCount: number;
       isVotedByUser: boolean;
+      fileId?: string;
     };
 
     type PollStatus = 'closed' | 'open';

package/src/@types/index.ts

@@ -44,4 +44,5 @@ export * from './domains/joinRequest';
 export * from './domains/pin';
 export * from './domains/pinnedPost';
 export * from './domains/liveReaction';
+export * from './domains/feed';
 export * from './domains/hashtag';

package/src/client/api/getShareableLinkConfiguration.ts

@@ -0,0 +1,26 @@
+import { getActiveClient } from './activeClient';
+
+/**
+ * ```js
+ * import Client from '@amityco/ts-sdk'
+ * const shareableLinkConfiguration = await Client.getShareableLinkConfiguration()
+ * const postLinkPattern = shareableLinkConfiguration.post
+ * ```
+ *
+ * Fetches a {@link Amity.ShareableLinkConfiguration} object
+ *
+ * @returns A Promise of {@link Amity.ShareableLinkConfiguration} object
+ *
+ * @category Client API
+ * @async
+ */
+export const getShareableLinkConfiguration =
+  async (): Promise<Amity.ShareableLinkConfiguration> => {
+    const client = getActiveClient();
+
+    const { data } = await client.http.get<Amity.ShareableLinkConfiguration>(
+      `/api/v3/network-settings/shareable-deep-links`,
+    );
+
+    return data;
+  };

package/src/client/api/index.ts

@@ -21,3 +21,7 @@ export * from './enableUnreadCount';
 export * from './setUploadedFileAccessType';
 
 export * from './fetchLinkPreview';
+
+export * from './getSocialSettings';
+
+export * from './getShareableLinkConfiguration';

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

@@ -29,6 +29,7 @@ import {
 } from '~/communityRepository/communityMembership';
 import { isNonNullable } from '~/utils';
 import { convertEventPayload } from '~/utils/event';
+import { communityLinkedObject } from '~/utils/linkedObject/communityLinkedObject';
 
 export class CommunityLiveCollectionController extends LiveCollectionController<
   'community',
@@ -105,12 +106,11 @@ export class CommunityLiveCollectionController extends LiveCollectionController<
     const collection = pullFromCache<Amity.CommunityLiveCollectionCache>(this.cacheKey)?.data;
     if (!collection) return;
 
-    const data = this.applyFilter(
+    const data =
       collection.data
         .map(id => pullFromCache<Amity.Community>(['community', 'get', id]))
         .filter(isNonNullable)
-        .map(({ data }) => data) ?? [],
-    );
+        .map(({ data }) => communityLinkedObject(data)) ?? [];
 
     if (!this.shouldNotify(data) && origin === 'event') return;
 

package/src/feedRepository/index.ts

@@ -1,2 +1,2 @@
 export { queryGlobalFeed } from './api';
-export { getCustomRankingGlobalFeed, getGlobalFeed } from './observers';
+export { getCustomRankingGlobalFeed, getGlobalFeed, getUserFeed } from './observers';

package/src/feedRepository/observers/getUserFeed/LiveCollectionController.ts

@@ -0,0 +1,162 @@
+import hash from 'object-hash';
+import { pullFromCache, pushToCache } from '~/cache/api';
+import { UserFeedPaginationController } from './PaginationController';
+import { UserFeedQueryStreamController } from './QueryStreamController';
+import { LiveCollectionController } from '~/core/liveCollection/LiveCollectionController';
+import {
+  onPostCreated,
+  onPostUpdated,
+  onPostDeleted,
+  onPostFlagged,
+  onPostUnflagged,
+  onPostReactionAdded,
+  onPostReactionRemoved,
+  onPostApproved,
+  onPostDeclined,
+} from '~/postRepository/events';
+import { isNonNullable } from '~/utils';
+import { EnumPostActions } from '~/postRepository/observers/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 UserFeedLiveCollectionController extends LiveCollectionController<
+  'post',
+  Amity.UserFeedLiveCollection,
+  Amity.Post,
+  UserFeedPaginationController
+> {
+  private queryStreamController: UserFeedQueryStreamController;
+
+  private query: Amity.UserFeedLiveCollection;
+
+  constructor(
+    query: Amity.UserFeedLiveCollection,
+    callback: Amity.LiveCollectionCallback<Amity.Post>,
+  ) {
+    const queryStreamId = hash(query);
+    const cacheKey = ['userFeed', 'collection', queryStreamId];
+    const paginationController = new UserFeedPaginationController(query);
+
+    super(paginationController, queryStreamId, cacheKey, callback);
+
+    this.query = query;
+    this.queryStreamController = new UserFeedQueryStreamController(
+      this.query,
+      this.cacheKey,
+      this.notifyChange.bind(this),
+      preparePostPayload,
+    );
+
+    this.callback = callback.bind(this);
+    this.loadPage({ initial: true });
+  }
+
+  protected setup() {
+    const collection = pullFromCache<Amity.UserFeedLiveCollectionCache>(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.UserFeedLiveCollectionCache>(
+                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.UserFeedLiveCollectionCache>(
+                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.UserFeedLiveCollectionCache>(this.cacheKey)?.data;
+    if (!collection) return;
+
+    const data = (
+      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,
+    });
+  }
+}

package/src/feedRepository/observers/getUserFeed/PaginationController.ts

@@ -0,0 +1,37 @@
+import { PaginationController } from '~/core/liveCollection/PaginationController';
+import { COLLECTION_DEFAULT_PAGINATION_LIMIT } from '~/utils/constants';
+import { inferIsDeleted } from '~/utils/inferIsDeleted';
+
+export class UserFeedPaginationController extends PaginationController<
+  'post',
+  Amity.UserFeedLiveCollection
+> {
+  async getRequest(queryParams: Amity.UserFeedLiveCollection, token: string | undefined) {
+    const {
+      userId,
+      feedSources,
+      dataTypes,
+      includeDeleted,
+      matchingOnlyParentPost,
+      limit = COLLECTION_DEFAULT_PAGINATION_LIMIT,
+      ...params
+    } = queryParams;
+
+    const options = token ? { token } : { limit };
+
+    const { data: queryResponse } = await this.http.get<Amity.PostPayload & Amity.Pagination>(
+      `/api/v4/user-feeds/${userId}`,
+      {
+        params: {
+          ...params,
+          options,
+          dataTypes: dataTypes?.length ? dataTypes : undefined,
+          includePostedFeed: feedSources,
+          isDeleted: inferIsDeleted(includeDeleted),
+          matchingOnlyParentPost: matchingOnlyParentPost ?? !dataTypes?.length,
+        },
+      },
+    );
+    return queryResponse;
+  }
+}

package/src/feedRepository/observers/getUserFeed/QueryStreamController.ts

@@ -0,0 +1,119 @@
+import { getResolver } from '~/core/model';
+import { getActiveClient } from '~/client';
+import { pullFromCache, pushToCache } from '~/cache/api';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { EnumPostActions } from '~/postRepository/observers/enums';
+import { QueryStreamController } from '~/core/liveCollection/QueryStreamController';
+
+export class UserFeedQueryStreamController extends QueryStreamController<
+  Amity.PostPayload,
+  Amity.UserFeedLiveCollection
+> {
+  private notifyChange: (params: Amity.LiveCollectionNotifyParams) => void;
+
+  private preparePayload: (response: Amity.PostPayload) => Amity.ProcessedPostPayload;
+
+  constructor(
+    query: Amity.UserFeedLiveCollection,
+    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.UserFeedLiveCollectionCache>(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.UserFeedLiveCollectionCache>(this.cacheKey)?.data;
+
+      if (!collection) return;
+
+      // if the collection is parent post collection and
+      // post is not included in the collection or post is child post
+      if (
+        (!this.query.dataTypes || this.query.dataTypes.length === 0) &&
+        !collection.data.includes(post.parentPostId ? post.parentPostId : post.postId)
+      )
+        return;
+
+      if (action === EnumPostActions.OnPostDeleted) {
+        collection.data = collection.data.filter(postId => postId !== post.postId);
+      }
+
+      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) {
+        if (
+          this.query.dataTypes &&
+          this.query.dataTypes.length > 0 &&
+          !this.query.dataTypes.includes(post.dataType)
+        ) {
+          return;
+        }
+
+        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/feedRepository/observers/getUserFeed.ts

@@ -0,0 +1,56 @@
+import { getActiveClient } from '~/client/api/activeClient';
+import { dropFromCache } from '~/cache/api/dropFromCache';
+import { ENABLE_CACHE_MESSAGE } from '~/utils/constants';
+import { UserFeedLiveCollectionController } from './getUserFeed/LiveCollectionController';
+
+/* begin_public_function
+  id: feed.query.user_feed
+*/
+/**
+ * ```js
+ * import { FeedRepository } from '@amityco/ts-sdk'
+ *
+ * let posts = []
+ * const unsubscribe = FeedRepository.getUserFeed({
+ *   userId: string,
+ *   feedSources: ['user', 'community'],
+ * }, response => response => processResponse(response))
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.Post} for a given user and feedSources
+ *
+ * @param params.userId the ID of the user
+ * @param params.feedSources the sources of the feed
+ * @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 getUserFeed = (
+  params: Amity.UserFeedLiveCollection,
+  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(`getUserFeed(tmpid: ${timestamp}) > listen`);
+
+  const userFeedLiveCollection = new UserFeedLiveCollectionController(params, callback);
+  const disposers = userFeedLiveCollection.startSubscription();
+
+  const cacheKey = userFeedLiveCollection.getCacheKey();
+
+  disposers.push(() => dropFromCache(cacheKey));
+
+  return () => {
+    log(`getUserFeed(tmpid: ${timestamp}) > dispose`);
+    disposers.forEach(fn => fn());
+  };
+};
+/* end_public_function */

package/src/feedRepository/observers/index.ts

@@ -1,2 +1,3 @@
 export { getCustomRankingGlobalFeed } from './getCustomRankingGlobalFeed';
 export { getGlobalFeed } from './getGlobalFeed';
+export { getUserFeed } from './getUserFeed';

package/src/liveReactionRepository/api/createReaction.ts

@@ -48,7 +48,6 @@ export const createReaction = async ({
     occurredAt: new Date().toISOString(),
   };
 
-
   reactionSynceEngine.createLiveReaction(reaction);
 
   fireEvent('local.liveReaction.created', [{ ...reaction, userId: client.userId!, referenceId }]);

package/src/pollRepository/api/createPoll.ts

@@ -11,8 +11,8 @@ import { ingestInCache } from '~/cache/api/ingestInCache';
  * const created = await createPoll({
  *   question: 'question',
  *   answers: [
- *      { dataType: 'text', data: 'answer1' },
- *      { dataType: 'text', data: 'answer2' },
+ *      { dataType: 'text', data: 'answer1', fileId: 'fileId1' },
+ *      { dataType: 'text', data: 'answer2', fileId: 'fileId2' },
  *   ],
  *   closedIn: 1649136484
  * }))