@amityco/ts-sdk-react-native 7.3.1-1cd86e2.0 → 7.4.1-9a54e83.0

package/dist/messageRepository/api/flagMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flagMessage.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/api/flagMessage.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;KAWK;AACL,eAAO,MAAM,WAAW,cAAqB,MAAM,OAAO,CAAC,WAAW,CAAC,KAAG,QAAQ,OAAO,CAgBxF,CAAC"}
+{"version":3,"file":"flagMessage.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/api/flagMessage.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;KAWK;AACL,eAAO,MAAM,WAAW,cAAqB,MAAM,OAAO,CAAC,WAAW,CAAC,KAAG,QAAQ,OAAO,CAgBxF,CAAC"}

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

@@ -1,14 +1,15 @@
 /**
  * ```js
  * import { PostRepository } from '@amityco/ts-sdk-react-native'
- * const flagged = await PostRepository.flagPost(postId)
+ * const flagged = await PostRepository.flagPost(postId, reason)
  * ```
  *
  * @param postId of the post to flag
+ * @param reason the reason to flag the post
  * @returns a boolean
  *
  * @category Post API
  * @async
  * */
-export declare const flagPost: (postId: Amity.Post['postId']) => Promise<boolean>;
+export declare const flagPost: (postId: Amity.Post['postId'], reason?: Amity.ContentFlagReason) => Promise<boolean>;
 //# sourceMappingURL=flagPost.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"flagPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/flagPost.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;KAWK;AACL,eAAO,MAAM,QAAQ,WAAkB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAG,QAAQ,OAAO,CAe5E,CAAC"}
+{"version":3,"file":"flagPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/flagPost.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;KAYK;AACL,eAAO,MAAM,QAAQ,WACX,MAAM,IAAI,CAAC,QAAQ,CAAC,WACnB,MAAM,iBAAiB,KAC/B,QAAQ,OAAO,CA2BjB,CAAC"}

package/dist/utils/linkedObject/postLinkedObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postLinkedObject.d.ts","sourceRoot":"","sources":["../../../src/utils/linkedObject/postLinkedObject.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,SAAU,MAAM,YAAY,KAAG,MAAM,IAiCjE,CAAC"}
+{"version":3,"file":"postLinkedObject.d.ts","sourceRoot":"","sources":["../../../src/utils/linkedObject/postLinkedObject.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,SAAU,MAAM,YAAY,KAAG,MAAM,IA6DjE,CAAC"}

package/dist/utils/postTypePredicate.d.ts

@@ -0,0 +1,4 @@
+export declare function isAmityImagePost(post: Amity.InternalPost): post is Amity.Post<'image'>;
+export declare function isAmityFilePost(post: Amity.InternalPost): post is Amity.Post<'file'>;
+export declare function isAmityVideoPost(post: Amity.InternalPost): post is Amity.Post<'video'>;
+//# sourceMappingURL=postTypePredicate.d.ts.map

package/dist/utils/postTypePredicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postTypePredicate.d.ts","sourceRoot":"","sources":["../../src/utils/postTypePredicate.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAOtF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAOpF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAQtF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/ts-sdk-react-native",
-  "version": "7.3.1-1cd86e2.0",
+  "version": "7.4.1-9a54e83.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/payload.ts

@@ -55,7 +55,29 @@ declare global {
 
     // API-FIX: backend should return a payload like { files: Amity.File<T>[] }
     type CreateFilePayload<T extends Amity.FileType = any> = Amity.File<T>[];
-    type FilePayload<T extends Amity.FileType = any> = Amity.File<T>;
+
+    type VideoFileExtraPayload = {
+      feedType: Amity.ContentFeedType;
+      status: Amity.VideoTranscodingStatus;
+      videoUrl?: { [name in Amity.VideoResolution]?: string } | null;
+    };
+
+    type FilePayload<T extends Amity.FileType = any> = {
+      fileId: string;
+      type: T;
+      altText?: string;
+      fileUrl: string;
+      attributes: {
+        name: string;
+        extension: string;
+        size: string;
+        mimeType: string;
+        metadata: Amity.MetadataFor<T>;
+      };
+      accessType: Amity.FileAccessType;
+    } & (T extends 'video' ? Amity.VideoFileExtraPayload : unknown) &
+      Amity.Timestamps &
+      Amity.SoftDelete;
 
     type RolePayload = {
       roles: Amity.Role[];

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

@@ -6,8 +6,24 @@ export const ContentFeedType = Object.freeze({
   MESSAGE: 'message',
 });
 
+export enum ContentFlagReasonEnum {
+  CommunityGuidelines = 'Against community guidelines',
+  HarassmentOrBullying = 'Harassment or bullying',
+  SelfHarmOrSuicide = 'Self-harm or suicide',
+  ViolenceOrThreateningContent = 'Violence or threatening content',
+  SellingRestrictedItems = 'Selling and promoting restricted items',
+  SexualContentOrNudity = 'Sexual message or nudity',
+  SpamOrScams = 'Spam or scams',
+  FalseInformation = 'False information or misinformation',
+  Others = 'Others',
+}
+
 declare global {
   namespace Amity {
+    type ContentFlagReason =
+      | Exclude<`${ContentFlagReasonEnum}`, `${ContentFlagReasonEnum.Others}`>
+      | (string & {});
+
     type ContentType = 'text' | 'image' | 'file' | 'video' | 'poll' | 'json' | string;
 
     type ContentFeedType = ValueOf<typeof ContentFeedType>;

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

@@ -63,26 +63,6 @@ declare global {
       ? VideoMetadata
       : never;
 
-    type VideoFileExtraPayload = {
-      feedType: Amity.ContentFeedType;
-      status: VideoTranscodingStatus;
-      videoUrl?: { [name in VideoResolution]?: string } | null;
-    };
-
-    type File<T extends FileType = any> = {
-      fileId: string;
-      type: T;
-      fileUrl: string;
-      attributes: {
-        name: string;
-        extension: string;
-        size: string;
-        mimeType: string;
-        metadata: MetadataFor<T>;
-      };
-      accessType: FileAccessType;
-    } & (T extends 'video' ? VideoFileExtraPayload : unknown) &
-      Amity.Timestamps &
-      Amity.SoftDelete;
+    type File<T extends FileType = any> = Amity.FilePayload<T>;
   }
 }

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

@@ -61,6 +61,10 @@ declare global {
       analytics: {
         markAsViewed: () => void;
       };
+      getImageInfo: () => Amity.File<'image'> | undefined;
+      getVideoInfo: () => Amity.File<'video'> | undefined;
+      getVideoThumbnailInfo: () => Amity.File<'image'> | undefined;
+      getFileInfo: () => Amity.File<'file'> | undefined;
     };
 
     type Post<T extends PostContentType = any> = Amity.InternalPost<T> & Amity.PostLinkObject;

package/src/commentRepository/api/flagComment.ts

@@ -1,7 +1,8 @@
 import { getActiveClient } from '~/client/api/activeClient';
-
 import { ingestInCache } from '~/cache/api/ingestInCache';
 import { fireEvent } from '~/core/events';
+import { prepareMembershipPayload } from '~/group/utils';
+import { ContentFlagReasonEnum } from '~/@types';
 
 /* begin_public_function
   id: comment.flag
@@ -9,21 +10,37 @@ import { fireEvent } from '~/core/events';
 /**
  * ```js
  * import { CommentRepository } from '@amityco/ts-sdk-react-native'
- * const flagged = await CommentRepository.flagComment('commentId')
+ * const flagged = await CommentRepository.flagComment(commentId, reason)
  * ```
  *
  * @param commentId The ID of the comment to flag
+ * @param reason the reason to flag the comment
  * @returns the created report result
  *
  * @category Comment API
  * @async
  * */
-export const flagComment = async (commentId: Amity.Comment['commentId']): Promise<boolean> => {
+export const flagComment = async (
+  commentId: Amity.Comment['commentId'],
+  reason?: Amity.ContentFlagReason,
+): Promise<boolean> => {
   const client = getActiveClient();
   client.log('comment/flagComment', commentId);
 
+  const isPredefinedReason =
+    reason &&
+    Object.entries(ContentFlagReasonEnum).some(
+      ([key, value]) => key !== ContentFlagReasonEnum.Others && value === reason,
+    );
+
+  const body = {
+    reason: reason && isPredefinedReason ? reason : ContentFlagReasonEnum.Others,
+    detail: reason && !isPredefinedReason ? reason : '',
+  };
+
   const { data: payload } = await client.http.post<Amity.CommentPayload>(
     `/api/v3/comments/${encodeURIComponent(commentId)}/flag`,
+    body,
   );
 
   if (client.cache) {

package/src/fileRepository/api/index.ts

@@ -4,3 +4,4 @@ export * from './deleteFile';
 export * from './fileUrlWithSize';
 export * from './uploadVideo';
 export * from './uploadImage';
+export * from './updateAltText';

package/src/fileRepository/api/updateAltText.ts

@@ -0,0 +1,39 @@
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { getActiveClient } from '~/client';
+
+/* begin_public_function
+  id: file.update.altText
+*/
+/**
+ * ```js
+ * import { FileRepository } from '@amityco/ts-sdk'
+ * const updated = await FileRepository.updateAltText(fileId, altText)
+ * ```
+ *
+ * Updates an {@link Amity.File<'image'>['altText']}.
+ *
+ * @param fileId The ID of the {@link Amity.File<'image'>} to edit
+ * @param altText The new alt text for the {@link Amity.File<'image'>}
+ * @returns the updated {@link Amity.File<'image'>} object
+ *
+ * @category File API
+ * @async
+ */
+export const updateAltText = async (
+  fileId: Amity.File['fileId'],
+  altText: string,
+): Promise<boolean> => {
+  const client = getActiveClient();
+  client.log('file/updateAltText', altText);
+
+  const { data } = await client.http.put<Amity.FilePayload<'image'>>(`/api/v3/files/${fileId}`, {
+    altText,
+  });
+
+  const cachedAt = client.cache && Date.now();
+
+  if (client.cache) ingestInCache({ files: [data] }, { cachedAt });
+
+  return true;
+};
+/* end_public_function */

package/src/fileRepository/api/uploadImage.ts

@@ -16,26 +16,45 @@ import GlobalFileAccessType from '~/client/utils/GlobalFileAccessType';
  *
  * @param formData The data necessary to create a new {@link Amity.File<'image'>}
  * @param onProgress The callback to track the upload progress
+ * @param altText The alt text for the image
  * @returns The newly created {@link Amity.File<'image'>}
  *
  * @category File API
  * @async
  */
+
 export const uploadImage = async (
   formData: FormData,
   onProgress?: (percent: number) => void,
+  altText?: string,
 ): Promise<Amity.Cached<Amity.File<'image'>[]>> => {
   const client = getActiveClient();
   client.log('file/uploadImage', formData);
 
   const files = formData.getAll('files');
 
-  if (!files.length) throw new Error('The formData object must have a `files` key.');
+  if (files?.length) {
+    console.warn('Deprecation Warning: `files` is deprecated, please use `file` instead.');
+
+    formData.append('preferredFilename', (files[0] as File).name);
+  } else {
+    const file = formData.get('file') as File;
+
+    if (!file) {
+      throw new Error('The formData object must have a `file` or `files` key');
+    }
+
+    formData.append('preferredFilename', file.name);
+
+    // alt is for single image
+    if (altText) {
+      formData.append('altText', altText);
+    }
+  }
 
   const accessType = GlobalFileAccessType.getInstance().getFileAccessType();
-  formData.append('accessType', accessType);
 
-  formData.append('preferredFilename', (files[0] as File).name);
+  formData.append('accessType', accessType);
 
   const headers =
     'getHeaders' in formData

package/src/messageRepository/api/flagMessage.ts

@@ -1,8 +1,6 @@
-import { getActiveClient } from '~/client/api/activeClient';
-
-import { ingestInCache } from '~/cache/api/ingestInCache';
 import { fireEvent } from '~/core/events';
-
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { getActiveClient } from '~/client/api/activeClient';
 import { prepareMessagePayload } from '~/messageRepository/utils';
 
 /* begin_public_function

package/src/postRepository/api/flagPost.ts

@@ -1,8 +1,8 @@
 import { getActiveClient } from '~/client/api/activeClient';
-
 import { ingestInCache } from '~/cache/api/ingestInCache';
 import { fireEvent } from '~/core/events';
 import { prepareMembershipPayload } from '~/group/utils';
+import { ContentFlagReasonEnum } from '~/@types';
 
 /* begin_public_function
   id: post.flag
@@ -10,21 +10,37 @@ import { prepareMembershipPayload } from '~/group/utils';
 /**
  * ```js
  * import { PostRepository } from '@amityco/ts-sdk-react-native'
- * const flagged = await PostRepository.flagPost(postId)
+ * const flagged = await PostRepository.flagPost(postId, reason)
  * ```
  *
  * @param postId of the post to flag
+ * @param reason the reason to flag the post
  * @returns a boolean
  *
  * @category Post API
  * @async
  * */
-export const flagPost = async (postId: Amity.Post['postId']): Promise<boolean> => {
+export const flagPost = async (
+  postId: Amity.Post['postId'],
+  reason?: Amity.ContentFlagReason,
+): Promise<boolean> => {
   const client = getActiveClient();
   client.log('post/flagPost', postId);
 
+  const isPredefinedReason =
+    reason &&
+    Object.entries(ContentFlagReasonEnum).some(
+      ([key, value]) => key !== ContentFlagReasonEnum.Others && value === reason,
+    );
+
+  const body = {
+    reason: reason && isPredefinedReason ? reason : ContentFlagReasonEnum.Others,
+    detail: reason && !isPredefinedReason ? reason : '',
+  };
+
   const { data: payload } = await client.http.post<Amity.PostPayload>(
     `/api/v3/posts/${encodeURIComponent(postId)}/flag`,
+    body,
   );
 
   if (client.cache) {

package/src/utils/linkedObject/postLinkedObject.ts

@@ -2,16 +2,19 @@ import { pullFromCache } from '~/cache/api';
 import { commentLinkedObject } from '~/utils/linkedObject/commentLinkedObject';
 import AnalyticsEngine from '../../analytic/service/analytic/AnalyticsEngine';
 import { userLinkedObject } from './userLinkedObject';
+import { isAmityFilePost, isAmityImagePost, isAmityVideoPost } from '../postTypePredicate';
 
 export const postLinkedObject = (post: Amity.InternalPost): Amity.Post => {
   return {
     ...post,
+
     analytics: {
       markAsViewed: () => {
         const analyticsEngineInstance = AnalyticsEngine.getInstance();
         analyticsEngineInstance.markPostAsViewed(post.postId);
       },
     },
+
     get latestComments(): (Amity.Comment | null)[] {
       if (!post.comments) return [];
       return (
@@ -30,10 +33,36 @@ export const postLinkedObject = (post: Amity.InternalPost): Amity.Post => {
           .filter(Boolean) || []
       );
     },
+
     get creator(): Amity.User | undefined {
       const cacheData = pullFromCache<Amity.User>(['user', 'get', post.postedUserId]);
       if (!cacheData?.data) return;
       return userLinkedObject(cacheData.data);
     },
+
+    getImageInfo(): Amity.File<'image'> | undefined {
+      return isAmityImagePost(post)
+        ? pullFromCache<Amity.File<'image'>>(['file', 'get', post?.data?.fileId])?.data
+        : undefined;
+    },
+
+    getVideoInfo(): Amity.File<'video'> | undefined {
+      return isAmityVideoPost(post)
+        ? pullFromCache<Amity.File<'video'>>(['file', 'get', post?.data?.videoFileId?.original])
+            ?.data
+        : undefined;
+    },
+
+    getVideoThumbnailInfo(): Amity.File<'image'> | undefined {
+      return isAmityVideoPost(post)
+        ? pullFromCache<Amity.File<'image'>>(['file', 'get', post?.data?.thumbnailFileId])?.data
+        : undefined;
+    },
+
+    getFileInfo(): Amity.File<'file'> | undefined {
+      return isAmityFilePost(post)
+        ? pullFromCache<Amity.File<'file'>>(['file', 'get', post?.data?.fileId])?.data
+        : undefined;
+    },
   };
 };

package/src/utils/postTypePredicate.ts

@@ -0,0 +1,27 @@
+export function isAmityImagePost(post: Amity.InternalPost): post is Amity.Post<'image'> {
+  return !!(
+    post.data &&
+    typeof post.data !== 'string' &&
+    'fileId' in post.data &&
+    post.dataType === 'image'
+  );
+}
+
+export function isAmityFilePost(post: Amity.InternalPost): post is Amity.Post<'file'> {
+  return !!(
+    post.data &&
+    typeof post.data !== 'string' &&
+    'fileId' in post.data &&
+    post.dataType === 'file'
+  );
+}
+
+export function isAmityVideoPost(post: Amity.InternalPost): post is Amity.Post<'video'> {
+  return !!(
+    post.data &&
+    typeof post.data !== 'string' &&
+    'videoFileId' in post.data &&
+    'thumbnailFileId' in post.data &&
+    post.dataType === 'video'
+  );
+}