box-ui-elements 16.0.0-beta.8 → 16.0.0

package/es/api/Annotations.js.flow

@@ -2,16 +2,21 @@
 import merge from 'lodash/merge';
 import {
     ERROR_CODE_CREATE_ANNOTATION,
+    ERROR_CODE_CREATE_REPLY,
     ERROR_CODE_DELETE_ANNOTATION,
     ERROR_CODE_EDIT_ANNOTATION,
     ERROR_CODE_FETCH_ANNOTATION,
     ERROR_CODE_FETCH_ANNOTATIONS,
+    ERROR_CODE_FETCH_REPLIES,
     PERMISSION_CAN_CREATE_ANNOTATIONS,
     PERMISSION_CAN_DELETE,
     PERMISSION_CAN_EDIT,
     PERMISSION_CAN_VIEW_ANNOTATIONS,
+    PERMISSION_CAN_RESOLVE,
 } from '../constants';
 import MarkerBasedApi from './MarkerBasedAPI';
+import { formatComment } from './utils';
+
 import type {
     Annotation,
     AnnotationPermission,
@@ -20,8 +25,64 @@ import type {
 } from '../common/types/annotations';
 import type { BoxItemPermission } from '../common/types/core';
 import type { ElementsXhrError } from '../common/types/api';
+import type { Comment, FeedItemStatus, ThreadedComments } from '../common/types/feed';
 
 export default class Annotations extends MarkerBasedApi {
+    /**
+     * Formats annotation replies' comment data for use in components.
+     *
+     * @param {Annotation} annotation - An individual annotation entry from the API
+     * @return {Annotation} Updated annotation
+     */
+    formatReplies(annotation: Annotation): Annotation {
+        if (!annotation.replies || !annotation.replies.length) {
+            return annotation;
+        }
+
+        return {
+            ...annotation,
+            replies: annotation.replies.map(formatComment),
+        };
+    }
+
+    /**
+     * Formats the annotations api response to usable data
+     * @param {Object} data the api response data
+     */
+    successHandler = (data: Object): void => {
+        if (this.isDestroyed() || typeof this.successCallback !== 'function') {
+            return;
+        }
+
+        // There is no response data when deleting an annotation
+        if (!data) {
+            this.successCallback();
+            return;
+        }
+
+        // We don't have entries when updating/creating an annotation
+        if (!data.entries) {
+            // Check if the response is a comment (result of createAnnotationReply)
+            if (data.type && data.type === 'comment') {
+                this.successCallback(formatComment(data));
+                return;
+            }
+
+            this.successCallback(this.formatReplies(data));
+            return;
+        }
+
+        // Check if the response is the replies of an annotation (result of getAnnotationReplies)
+        if (data.entries.length && data.entries[0].type === 'comment') {
+            const replies = data.entries.map(formatComment);
+            this.successCallback({ ...data, entries: replies });
+            return;
+        }
+
+        const annotations = data.entries.map(this.formatReplies);
+        this.successCallback({ ...data, entries: annotations });
+    };
+
     getUrl() {
         return `${this.getBaseApiUrl()}/undoc/annotations`;
     }
@@ -30,6 +91,10 @@ export default class Annotations extends MarkerBasedApi {
         return `${this.getUrl()}/${annotationId}`;
     }
 
+    getUrlWithRepliesForId(annotationId: string) {
+        return `${this.getUrlForId(annotationId)}/replies`;
+    }
+
     createAnnotation(
         fileId: string,
         fileVersionId: string,
@@ -55,8 +120,6 @@ export default class Annotations extends MarkerBasedApi {
                 id: fileVersionId,
                 type: 'file_version',
             },
-            status: 'open',
-            type: 'annotation',
         };
 
         this.post({
@@ -74,24 +137,39 @@ export default class Annotations extends MarkerBasedApi {
         fileId: string,
         annotationId: string,
         permissions: AnnotationPermission,
-        message: string,
+        payload: { message?: string, status?: FeedItemStatus },
         successCallback: (annotation: Annotation) => void,
         errorCallback: (e: ElementsXhrError, code: string) => void,
     ): void {
         this.errorCode = ERROR_CODE_EDIT_ANNOTATION;
+        const { message, status } = payload;
 
-        try {
-            this.checkApiCallValidity(PERMISSION_CAN_EDIT, permissions, fileId);
-        } catch (e) {
-            errorCallback(e, this.errorCode);
-            return;
+        if (message) {
+            try {
+                this.checkApiCallValidity(PERMISSION_CAN_EDIT, permissions, fileId);
+            } catch (e) {
+                errorCallback(e, this.errorCode);
+                return;
+            }
         }
 
-        const requestData = { data: { description: { message } } };
+        if (status) {
+            try {
+                this.checkApiCallValidity(PERMISSION_CAN_RESOLVE, permissions, fileId);
+            } catch (e) {
+                errorCallback(e, this.errorCode);
+                return;
+            }
+        }
 
         this.put({
             id: fileId,
-            data: requestData,
+            data: {
+                data: {
+                    description: message ? { message } : undefined,
+                    status,
+                },
+            },
             errorCallback,
             successCallback,
             url: this.getUrlForId(annotationId),
@@ -128,6 +206,7 @@ export default class Annotations extends MarkerBasedApi {
         permissions: BoxItemPermission,
         successCallback: (annotation: Annotation) => void,
         errorCallback: (e: ElementsXhrError, code: string) => void,
+        shouldFetchReplies?: boolean,
     ): void {
         this.errorCode = ERROR_CODE_FETCH_ANNOTATION;
 
@@ -138,11 +217,14 @@ export default class Annotations extends MarkerBasedApi {
             return;
         }
 
+        const requestData = shouldFetchReplies ? { params: { fields: 'replies' } } : undefined;
+
         this.get({
             id: fileId,
             errorCallback,
             successCallback,
             url: this.getUrlForId(annotationId),
+            requestData,
         });
     }
 
@@ -154,6 +236,7 @@ export default class Annotations extends MarkerBasedApi {
         errorCallback: (e: ElementsXhrError, code: string) => void,
         limit?: number,
         shouldFetchAll?: boolean,
+        shouldFetchReplies?: boolean,
     ): void {
         this.errorCode = ERROR_CODE_FETCH_ANNOTATIONS;
 
@@ -164,16 +247,69 @@ export default class Annotations extends MarkerBasedApi {
             return;
         }
 
+        const requestData = {
+            file_id: fileId,
+            file_version_id: fileVersionId,
+            ...(shouldFetchReplies ? { fields: 'replies' } : null),
+        };
+
         this.markerGet({
             id: fileId,
             errorCallback,
             limit,
-            requestData: {
-                file_id: fileId,
-                file_version_id: fileVersionId,
-            },
+            requestData,
             shouldFetchAll,
             successCallback,
         });
     }
+
+    getAnnotationReplies(
+        fileId: string,
+        annotationId: string,
+        permissions: BoxItemPermission,
+        successCallback: (comments: ThreadedComments) => void,
+        errorCallback: (e: ElementsXhrError, code: string) => void,
+    ): void {
+        this.errorCode = ERROR_CODE_FETCH_REPLIES;
+
+        try {
+            this.checkApiCallValidity(PERMISSION_CAN_VIEW_ANNOTATIONS, permissions, fileId);
+        } catch (e) {
+            errorCallback(e, this.errorCode);
+            return;
+        }
+
+        this.get({
+            id: fileId,
+            errorCallback,
+            successCallback,
+            url: this.getUrlWithRepliesForId(annotationId),
+        });
+    }
+
+    createAnnotationReply(
+        fileId: string,
+        annotationId: string,
+        permissions: BoxItemPermission,
+        message: string,
+        successCallback: (comment: Comment) => void,
+        errorCallback: (e: ElementsXhrError, code: string) => void,
+    ): void {
+        this.errorCode = ERROR_CODE_CREATE_REPLY;
+
+        try {
+            this.checkApiCallValidity(PERMISSION_CAN_CREATE_ANNOTATIONS, permissions, fileId);
+        } catch (e) {
+            errorCallback(e, this.errorCode);
+            return;
+        }
+
+        this.post({
+            id: fileId,
+            data: { data: { message } },
+            errorCallback,
+            successCallback,
+            url: this.getUrlWithRepliesForId(annotationId),
+        });
+    }
 }

package/es/api/Annotations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/api/Annotations.js"],"names":["merge","ERROR_CODE_CREATE_ANNOTATION","ERROR_CODE_DELETE_ANNOTATION","ERROR_CODE_EDIT_ANNOTATION","ERROR_CODE_FETCH_ANNOTATION","ERROR_CODE_FETCH_ANNOTATIONS","PERMISSION_CAN_CREATE_ANNOTATIONS","PERMISSION_CAN_DELETE","PERMISSION_CAN_EDIT","PERMISSION_CAN_VIEW_ANNOTATIONS","MarkerBasedApi","Annotations","getBaseApiUrl","annotationId","getUrl","fileId","fileVersionId","payload","permissions","successCallback","errorCallback","errorCode","checkApiCallValidity","e","defaults","description","type","file_version","id","status","post","data","url","message","requestData","put","getUrlForId","delete","get","limit","shouldFetchAll","markerGet","file_id","file_version_id"],"mappings":"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","sourcesContent":["// @flow\nimport merge from 'lodash/merge';\nimport {\n    ERROR_CODE_CREATE_ANNOTATION,\n    ERROR_CODE_DELETE_ANNOTATION,\n    ERROR_CODE_EDIT_ANNOTATION,\n    ERROR_CODE_FETCH_ANNOTATION,\n    ERROR_CODE_FETCH_ANNOTATIONS,\n    PERMISSION_CAN_CREATE_ANNOTATIONS,\n    PERMISSION_CAN_DELETE,\n    PERMISSION_CAN_EDIT,\n    PERMISSION_CAN_VIEW_ANNOTATIONS,\n} from '../constants';\nimport MarkerBasedApi from './MarkerBasedAPI';\nimport type {\n    Annotation,\n    AnnotationPermission,\n    Annotations as AnnotationsType,\n    NewAnnotation,\n} from '../common/types/annotations';\nimport type { BoxItemPermission } from '../common/types/core';\nimport type { ElementsXhrError } from '../common/types/api';\n\nexport default class Annotations extends MarkerBasedApi {\n    getUrl() {\n        return `${this.getBaseApiUrl()}/undoc/annotations`;\n    }\n\n    getUrlForId(annotationId: string) {\n        return `${this.getUrl()}/${annotationId}`;\n    }\n\n    createAnnotation(\n        fileId: string,\n        fileVersionId: string,\n        payload: NewAnnotation,\n        permissions: BoxItemPermission,\n        successCallback: (annotation: Annotation) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_CREATE_ANNOTATION;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_CREATE_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const defaults = {\n            description: {\n                type: 'reply',\n            },\n            file_version: {\n                id: fileVersionId,\n                type: 'file_version',\n            },\n            status: 'open',\n            type: 'annotation',\n        };\n\n        this.post({\n            id: fileId,\n            data: {\n                data: merge(defaults, payload),\n            },\n            errorCallback,\n            successCallback,\n            url: this.getUrl(),\n        });\n    }\n\n    updateAnnotation(\n        fileId: string,\n        annotationId: string,\n        permissions: AnnotationPermission,\n        message: string,\n        successCallback: (annotation: Annotation) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_EDIT_ANNOTATION;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_EDIT, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const requestData = { data: { description: { message } } };\n\n        this.put({\n            id: fileId,\n            data: requestData,\n            errorCallback,\n            successCallback,\n            url: this.getUrlForId(annotationId),\n        });\n    }\n\n    deleteAnnotation(\n        fileId: string,\n        annotationId: string,\n        permissions: AnnotationPermission,\n        successCallback: () => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_DELETE_ANNOTATION;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_DELETE, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.delete({\n            id: fileId,\n            errorCallback,\n            successCallback,\n            url: this.getUrlForId(annotationId),\n        });\n    }\n\n    getAnnotation(\n        fileId: string,\n        annotationId: string,\n        permissions: BoxItemPermission,\n        successCallback: (annotation: Annotation) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_FETCH_ANNOTATION;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_VIEW_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.get({\n            id: fileId,\n            errorCallback,\n            successCallback,\n            url: this.getUrlForId(annotationId),\n        });\n    }\n\n    getAnnotations(\n        fileId: string,\n        fileVersionId?: string,\n        permissions: BoxItemPermission,\n        successCallback: (annotations: AnnotationsType) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n        limit?: number,\n        shouldFetchAll?: boolean,\n    ): void {\n        this.errorCode = ERROR_CODE_FETCH_ANNOTATIONS;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_VIEW_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.markerGet({\n            id: fileId,\n            errorCallback,\n            limit,\n            requestData: {\n                file_id: fileId,\n                file_version_id: fileVersionId,\n            },\n            shouldFetchAll,\n            successCallback,\n        });\n    }\n}\n"],"file":"Annotations.js"}
+{"version":3,"sources":["../../src/api/Annotations.js"],"names":["merge","ERROR_CODE_CREATE_ANNOTATION","ERROR_CODE_CREATE_REPLY","ERROR_CODE_DELETE_ANNOTATION","ERROR_CODE_EDIT_ANNOTATION","ERROR_CODE_FETCH_ANNOTATION","ERROR_CODE_FETCH_ANNOTATIONS","ERROR_CODE_FETCH_REPLIES","PERMISSION_CAN_CREATE_ANNOTATIONS","PERMISSION_CAN_DELETE","PERMISSION_CAN_EDIT","PERMISSION_CAN_VIEW_ANNOTATIONS","PERMISSION_CAN_RESOLVE","MarkerBasedApi","formatComment","Annotations","data","isDestroyed","successCallback","entries","type","formatReplies","length","replies","map","annotations","annotation","getBaseApiUrl","annotationId","getUrl","getUrlForId","fileId","fileVersionId","payload","permissions","errorCallback","errorCode","checkApiCallValidity","e","defaults","description","file_version","id","post","url","message","status","put","undefined","delete","shouldFetchReplies","requestData","params","fields","get","limit","shouldFetchAll","file_id","file_version_id","markerGet","getUrlWithRepliesForId"],"mappings":"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","sourcesContent":["// @flow\nimport merge from 'lodash/merge';\nimport {\n    ERROR_CODE_CREATE_ANNOTATION,\n    ERROR_CODE_CREATE_REPLY,\n    ERROR_CODE_DELETE_ANNOTATION,\n    ERROR_CODE_EDIT_ANNOTATION,\n    ERROR_CODE_FETCH_ANNOTATION,\n    ERROR_CODE_FETCH_ANNOTATIONS,\n    ERROR_CODE_FETCH_REPLIES,\n    PERMISSION_CAN_CREATE_ANNOTATIONS,\n    PERMISSION_CAN_DELETE,\n    PERMISSION_CAN_EDIT,\n    PERMISSION_CAN_VIEW_ANNOTATIONS,\n    PERMISSION_CAN_RESOLVE,\n} from '../constants';\nimport MarkerBasedApi from './MarkerBasedAPI';\nimport { formatComment } from './utils';\n\nimport type {\n    Annotation,\n    AnnotationPermission,\n    Annotations as AnnotationsType,\n    NewAnnotation,\n} from '../common/types/annotations';\nimport type { BoxItemPermission } from '../common/types/core';\nimport type { ElementsXhrError } from '../common/types/api';\nimport type { Comment, FeedItemStatus, ThreadedComments } from '../common/types/feed';\n\nexport default class Annotations extends MarkerBasedApi {\n    /**\n     * Formats annotation replies' comment data for use in components.\n     *\n     * @param {Annotation} annotation - An individual annotation entry from the API\n     * @return {Annotation} Updated annotation\n     */\n    formatReplies(annotation: Annotation): Annotation {\n        if (!annotation.replies || !annotation.replies.length) {\n            return annotation;\n        }\n\n        return {\n            ...annotation,\n            replies: annotation.replies.map(formatComment),\n        };\n    }\n\n    /**\n     * Formats the annotations api response to usable data\n     * @param {Object} data the api response data\n     */\n    successHandler = (data: Object): void => {\n        if (this.isDestroyed() || typeof this.successCallback !== 'function') {\n            return;\n        }\n\n        // There is no response data when deleting an annotation\n        if (!data) {\n            this.successCallback();\n            return;\n        }\n\n        // We don't have entries when updating/creating an annotation\n        if (!data.entries) {\n            // Check if the response is a comment (result of createAnnotationReply)\n            if (data.type && data.type === 'comment') {\n                this.successCallback(formatComment(data));\n                return;\n            }\n\n            this.successCallback(this.formatReplies(data));\n            return;\n        }\n\n        // Check if the response is the replies of an annotation (result of getAnnotationReplies)\n        if (data.entries.length && data.entries[0].type === 'comment') {\n            const replies = data.entries.map(formatComment);\n            this.successCallback({ ...data, entries: replies });\n            return;\n        }\n\n        const annotations = data.entries.map(this.formatReplies);\n        this.successCallback({ ...data, entries: annotations });\n    };\n\n    getUrl() {\n        return `${this.getBaseApiUrl()}/undoc/annotations`;\n    }\n\n    getUrlForId(annotationId: string) {\n        return `${this.getUrl()}/${annotationId}`;\n    }\n\n    getUrlWithRepliesForId(annotationId: string) {\n        return `${this.getUrlForId(annotationId)}/replies`;\n    }\n\n    createAnnotation(\n        fileId: string,\n        fileVersionId: string,\n        payload: NewAnnotation,\n        permissions: BoxItemPermission,\n        successCallback: (annotation: Annotation) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_CREATE_ANNOTATION;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_CREATE_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const defaults = {\n            description: {\n                type: 'reply',\n            },\n            file_version: {\n                id: fileVersionId,\n                type: 'file_version',\n            },\n        };\n\n        this.post({\n            id: fileId,\n            data: {\n                data: merge(defaults, payload),\n            },\n            errorCallback,\n            successCallback,\n            url: this.getUrl(),\n        });\n    }\n\n    updateAnnotation(\n        fileId: string,\n        annotationId: string,\n        permissions: AnnotationPermission,\n        payload: { message?: string, status?: FeedItemStatus },\n        successCallback: (annotation: Annotation) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_EDIT_ANNOTATION;\n        const { message, status } = payload;\n\n        if (message) {\n            try {\n                this.checkApiCallValidity(PERMISSION_CAN_EDIT, permissions, fileId);\n            } catch (e) {\n                errorCallback(e, this.errorCode);\n                return;\n            }\n        }\n\n        if (status) {\n            try {\n                this.checkApiCallValidity(PERMISSION_CAN_RESOLVE, permissions, fileId);\n            } catch (e) {\n                errorCallback(e, this.errorCode);\n                return;\n            }\n        }\n\n        this.put({\n            id: fileId,\n            data: {\n                data: {\n                    description: message ? { message } : undefined,\n                    status,\n                },\n            },\n            errorCallback,\n            successCallback,\n            url: this.getUrlForId(annotationId),\n        });\n    }\n\n    deleteAnnotation(\n        fileId: string,\n        annotationId: string,\n        permissions: AnnotationPermission,\n        successCallback: () => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_DELETE_ANNOTATION;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_DELETE, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.delete({\n            id: fileId,\n            errorCallback,\n            successCallback,\n            url: this.getUrlForId(annotationId),\n        });\n    }\n\n    getAnnotation(\n        fileId: string,\n        annotationId: string,\n        permissions: BoxItemPermission,\n        successCallback: (annotation: Annotation) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n        shouldFetchReplies?: boolean,\n    ): void {\n        this.errorCode = ERROR_CODE_FETCH_ANNOTATION;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_VIEW_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const requestData = shouldFetchReplies ? { params: { fields: 'replies' } } : undefined;\n\n        this.get({\n            id: fileId,\n            errorCallback,\n            successCallback,\n            url: this.getUrlForId(annotationId),\n            requestData,\n        });\n    }\n\n    getAnnotations(\n        fileId: string,\n        fileVersionId?: string,\n        permissions: BoxItemPermission,\n        successCallback: (annotations: AnnotationsType) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n        limit?: number,\n        shouldFetchAll?: boolean,\n        shouldFetchReplies?: boolean,\n    ): void {\n        this.errorCode = ERROR_CODE_FETCH_ANNOTATIONS;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_VIEW_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const requestData = {\n            file_id: fileId,\n            file_version_id: fileVersionId,\n            ...(shouldFetchReplies ? { fields: 'replies' } : null),\n        };\n\n        this.markerGet({\n            id: fileId,\n            errorCallback,\n            limit,\n            requestData,\n            shouldFetchAll,\n            successCallback,\n        });\n    }\n\n    getAnnotationReplies(\n        fileId: string,\n        annotationId: string,\n        permissions: BoxItemPermission,\n        successCallback: (comments: ThreadedComments) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_FETCH_REPLIES;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_VIEW_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.get({\n            id: fileId,\n            errorCallback,\n            successCallback,\n            url: this.getUrlWithRepliesForId(annotationId),\n        });\n    }\n\n    createAnnotationReply(\n        fileId: string,\n        annotationId: string,\n        permissions: BoxItemPermission,\n        message: string,\n        successCallback: (comment: Comment) => void,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n    ): void {\n        this.errorCode = ERROR_CODE_CREATE_REPLY;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_CREATE_ANNOTATIONS, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.post({\n            id: fileId,\n            data: { data: { message } },\n            errorCallback,\n            successCallback,\n            url: this.getUrlWithRepliesForId(annotationId),\n        });\n    }\n}\n"],"file":"Annotations.js"}

package/es/api/Comments.js

@@ -184,7 +184,7 @@ function (_OffsetBasedAPI) {
      * @param {BoxItem} file - File object for which we are updating a comment
      * @param {string} commentId - Comment to be edited
      * @param {string} message - Comment message
-     * @param {BoxItemPermission} permissions - The known permissions of the comment we're updating
+     * @param {BoxCommentPermission} permissions - The known permissions of the comment we're updating
      * @param {Function} successCallback - Success callback
      * @param {Function} errorCallback - Error callback
      * @return {void}
@@ -230,7 +230,7 @@ function (_OffsetBasedAPI) {
      *
      * @param {BoxItem} file - File object for which we are deleting a comment
      * @param {string} commentId - Id of the comment we are deleting
-     * @param {BoxItemPermission} permissions - The known permissions of the comment we're deleting
+     * @param {BoxCommentPermission} permissions - The known permissions of the comment we're deleting
      * @param {Function} successCallback - Success callback
      * @param {Function} errorCallback - Error callback
      * @return {void}

package/es/api/Comments.js.flow

@@ -17,6 +17,7 @@ import {
 } from '../constants';
 import type { ElementsXhrError, ElementsErrorCallback } from '../common/types/api';
 import type { BoxItem, BoxItemPermission } from '../common/types/core';
+import type { BoxCommentPermission } from '../common/types/feed';
 
 class Comments extends OffsetBasedAPI {
     /**
@@ -144,7 +145,7 @@ class Comments extends OffsetBasedAPI {
      * @param {BoxItem} file - File object for which we are updating a comment
      * @param {string} commentId - Comment to be edited
      * @param {string} message - Comment message
-     * @param {BoxItemPermission} permissions - The known permissions of the comment we're updating
+     * @param {BoxCommentPermission} permissions - The known permissions of the comment we're updating
      * @param {Function} successCallback - Success callback
      * @param {Function} errorCallback - Error callback
      * @return {void}
@@ -162,7 +163,7 @@ class Comments extends OffsetBasedAPI {
         errorCallback: ElementsErrorCallback,
         file: BoxItem,
         message: string,
-        permissions: BoxItemPermission,
+        permissions: BoxCommentPermission,
         successCallback: Function,
         tagged_message?: string,
     }): void {
@@ -194,7 +195,7 @@ class Comments extends OffsetBasedAPI {
      *
      * @param {BoxItem} file - File object for which we are deleting a comment
      * @param {string} commentId - Id of the comment we are deleting
-     * @param {BoxItemPermission} permissions - The known permissions of the comment we're deleting
+     * @param {BoxCommentPermission} permissions - The known permissions of the comment we're deleting
      * @param {Function} successCallback - Success callback
      * @param {Function} errorCallback - Error callback
      * @return {void}
@@ -209,7 +210,7 @@ class Comments extends OffsetBasedAPI {
         commentId: string,
         errorCallback: ElementsErrorCallback,
         file: BoxItem,
-        permissions: BoxItemPermission,
+        permissions: BoxCommentPermission,
         successCallback: Function,
     }): void {
         this.errorCode = ERROR_CODE_DELETE_COMMENT;

package/es/api/Comments.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/api/Comments.js"],"names":["COMMENTS_FIELDS_TO_FETCH","OffsetBasedAPI","PERMISSION_CAN_COMMENT","PERMISSION_CAN_DELETE","PERMISSION_CAN_EDIT","ERROR_CODE_CREATE_COMMENT","ERROR_CODE_UPDATE_COMMENT","ERROR_CODE_DELETE_COMMENT","ERROR_CODE_FETCH_COMMENTS","Comments","data","isDestroyed","successCallback","entries","format","comments","map","id","Error","getBaseApiUrl","baseUrl","comment","tagged_message","message","file","taggedMessage","errorCallback","errorCode","permissions","checkApiCallValidity","e","requestData","item","type","params","fields","toString","post","url","commentsUrl","commentId","put","delete","fileId","offset","limit","shouldFetchAll","offsetGet"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAMA,SAASA,wBAAT,QAAyC,iBAAzC;AACA,OAAOC,cAAP,MAA2B,kBAA3B;AACA,SACIC,sBADJ,EAEIC,qBAFJ,EAGIC,mBAHJ,EAIIC,yBAJJ,EAKIC,yBALJ,EAMIC,yBANJ,EAOIC,yBAPJ,QAQO,cARP;;IAYMC,Q;;;;;;;;;;;;;;;;;;qEA2Ce,UAACC,IAAD,EAAwB;AACrC,UAAI,MAAKC,WAAL,MAAsB,OAAO,MAAKC,eAAZ,KAAgC,UAA1D,EAAsE;AAClE;AACH,OAHoC,CAKrC;;;AACA,UAAI,CAACF,IAAL,EAAW;AACP,cAAKE,eAAL;;AACA;AACH,OAToC,CAWrC;;;AACA,UAAI,CAACF,IAAI,CAACG,OAAV,EAAmB;AACf,cAAKD,eAAL,CAAqB,MAAKE,MAAL,CAAYJ,IAAZ,CAArB;;AACA;AACH;;AAED,UAAMK,QAAQ,GAAGL,IAAI,CAACG,OAAL,CAAaG,GAAb,CAAiB,MAAKF,MAAtB,CAAjB;;AACA,YAAKF,eAAL,mBAA0BF,IAA1B;AAAgCG,QAAAA,OAAO,EAAEE;AAAzC;AACH,K;;;;;;;;AA7DD;;;;;;2BAMOE,E,EAAqB;AACxB,UAAI,CAACA,EAAL,EAAS;AACL,cAAM,IAAIC,KAAJ,CAAU,kBAAV,CAAN;AACH;;AAED,uBAAU,KAAKC,aAAL,EAAV,oBAAwCF,EAAxC;AACH;AAED;;;;;;;;;gCAMYA,E,EAAqB;AAC7B,UAAMG,OAAO,aAAM,KAAKD,aAAL,EAAN,cAAb;AACA,aAAOF,EAAE,aAAMG,OAAN,cAAiBH,EAAjB,IAAwBG,OAAjC;AACH;AAED;;;;;;;;;2BAMOC,O,EAA0B;AAC7B,+BACOA,OADP;AAEIC,QAAAA,cAAc,EAAED,OAAO,CAACC,cAAR,KAA2B,EAA3B,GAAgCD,OAAO,CAACC,cAAxC,GAAyDD,OAAO,CAACE;AAFrF;AAIH;AAED;;;;;;;;AAyBA;;;;;;;;;;wCAsBS;AAAA,UAXLC,IAWK,QAXLA,IAWK;AAAA,UAVLD,OAUK,QAVLA,OAUK;AAAA,UATLE,aASK,QATLA,aASK;AAAA,UARLb,eAQK,QARLA,eAQK;AAAA,UAPLc,aAOK,QAPLA,aAOK;AACL,WAAKC,SAAL,GAAiBtB,yBAAjB;AADK,qBAE4BmB,IAF5B,CAEGP,EAFH;AAAA,UAEGA,EAFH,yBAEQ,EAFR;AAAA,UAEYW,WAFZ,GAE4BJ,IAF5B,CAEYI,WAFZ;;AAIL,UAAI;AACA,aAAKC,oBAAL,CAA0B3B,sBAA1B,EAAkD0B,WAAlD,EAA+DX,EAA/D;AACH,OAFD,CAEE,OAAOa,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,UAAMI,WAAW,GAAG;AAChBrB,QAAAA,IAAI,EAAE;AACFsB,UAAAA,IAAI,EAAE;AACFf,YAAAA,EAAE,EAAFA,EADE;AAEFgB,YAAAA,IAAI,EAAE;AAFJ,WADJ;AAKFV,UAAAA,OAAO,EAAPA,OALE;AAMFD,UAAAA,cAAc,EAAEG;AANd,SADU;AAShBS,QAAAA,MAAM,EAAE;AACJC,UAAAA,MAAM,EAAEnC,wBAAwB,CAACoC,QAAzB;AADJ;AATQ,OAApB;AAcA,WAAKC,IAAL,CAAU;AACNpB,QAAAA,EAAE,EAAFA,EADM;AAENqB,QAAAA,GAAG,EAAE,KAAKC,WAAL,EAFC;AAGN7B,QAAAA,IAAI,EAAEqB,WAHA;AAINnB,QAAAA,eAAe,EAAfA,eAJM;AAKNc,QAAAA,aAAa,EAAbA;AALM,OAAV;AAOH;AAED;;;;;;;;;;;;;;yCA2BS;AAAA,UAfLF,IAeK,SAfLA,IAeK;AAAA,UAdLgB,SAcK,SAdLA,SAcK;AAAA,UAbLjB,OAaK,SAbLA,OAaK;AAAA,UAZLD,cAYK,SAZLA,cAYK;AAAA,UAXLM,WAWK,SAXLA,WAWK;AAAA,UAVLhB,eAUK,SAVLA,eAUK;AAAA,UATLc,aASK,SATLA,aASK;AACL,WAAKC,SAAL,GAAiBrB,yBAAjB;AADK,sBAEekB,IAFf,CAEGP,EAFH;AAAA,UAEGA,EAFH,0BAEQ,EAFR;;AAIL,UAAI;AACA,aAAKY,oBAAL,CAA0BzB,mBAA1B,EAA+CwB,WAA/C,EAA4DX,EAA5D;AACH,OAFD,CAEE,OAAOa,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,UAAMI,WAAW,GAAG;AAChBrB,QAAAA,IAAI,EAAE;AAAEa,UAAAA,OAAO,EAAPA,OAAF;AAAWD,UAAAA,cAAc,EAAdA;AAAX;AADU,OAApB;AAIA,WAAKmB,GAAL,CAAS;AACLxB,QAAAA,EAAE,EAAFA,EADK;AAELqB,QAAAA,GAAG,EAAE,KAAKC,WAAL,CAAiBC,SAAjB,CAFA;AAGL9B,QAAAA,IAAI,EAAEqB,WAHD;AAILnB,QAAAA,eAAe,EAAfA,eAJK;AAKLc,QAAAA,aAAa,EAAbA;AALK,OAAT;AAOH;AAED;;;;;;;;;;;;;yCAsBS;AAAA,UAXLF,IAWK,SAXLA,IAWK;AAAA,UAVLgB,SAUK,SAVLA,SAUK;AAAA,UATLZ,WASK,SATLA,WASK;AAAA,UARLhB,eAQK,SARLA,eAQK;AAAA,UAPLc,aAOK,SAPLA,aAOK;AACL,WAAKC,SAAL,GAAiBpB,yBAAjB;AADK,sBAEeiB,IAFf,CAEGP,EAFH;AAAA,UAEGA,EAFH,0BAEQ,EAFR;;AAIL,UAAI;AACA,aAAKY,oBAAL,CAA0B1B,qBAA1B,EAAiDyB,WAAjD,EAA8DX,EAA9D;AACH,OAFD,CAEE,OAAOa,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,WAAKe,MAAL,CAAY;AACRzB,QAAAA,EAAE,EAAFA,EADQ;AAERqB,QAAAA,GAAG,EAAE,KAAKC,WAAL,CAAiBC,SAAjB,CAFG;AAGR5B,QAAAA,eAAe,EAAfA,eAHQ;AAIRc,QAAAA,aAAa,EAAbA;AAJQ,OAAZ;AAMH;AAED;;;;;;;;;;;;;;;;gCAcIiB,M,EACAf,W,EACAhB,e,EACAc,a,EAKI;AAAA,UAJJS,MAII,uEAJoBnC,wBAIpB;AAAA,UAHJ4C,MAGI;AAAA,UAFJC,KAEI;AAAA,UADJC,cACI;AACJ,WAAKnB,SAAL,GAAiBnB,yBAAjB;;AACA,UAAI;AACA,aAAKqB,oBAAL,CAA0B3B,sBAA1B,EAAkD0B,WAAlD,EAA+De,MAA/D;AACH,OAFD,CAEE,OAAOb,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,WAAKoB,SAAL,CAAeJ,MAAf,EAAuB/B,eAAvB,EAAwCc,aAAxC,EAAuDkB,MAAvD,EAA+DC,KAA/D,EAAsEV,MAAtE,EAA8EW,cAA9E;AACH;;;;EApPkB7C,c;;AAuPvB,eAAeQ,QAAf","sourcesContent":["/**\n * @flow\n * @file Helper for the box comments API\n * @author Box\n */\n\nimport { COMMENTS_FIELDS_TO_FETCH } from '../utils/fields';\nimport OffsetBasedAPI from './OffsetBasedAPI';\nimport {\n    PERMISSION_CAN_COMMENT,\n    PERMISSION_CAN_DELETE,\n    PERMISSION_CAN_EDIT,\n    ERROR_CODE_CREATE_COMMENT,\n    ERROR_CODE_UPDATE_COMMENT,\n    ERROR_CODE_DELETE_COMMENT,\n    ERROR_CODE_FETCH_COMMENTS,\n} from '../constants';\nimport type { ElementsXhrError, ElementsErrorCallback } from '../common/types/api';\nimport type { BoxItem, BoxItemPermission } from '../common/types/core';\n\nclass Comments extends OffsetBasedAPI {\n    /**\n     * API URL for comments on a file\n     *\n     * @param {string} id - A box file id\n     * @return {string} base url for files\n     */\n    getUrl(id?: string): string {\n        if (!id) {\n            throw new Error('Missing file id!');\n        }\n\n        return `${this.getBaseApiUrl()}/files/${id}/comments`;\n    }\n\n    /**\n     * API URL for comments endpoint\n     *\n     * @param {string} [id] - A box comment id\n     * @return {string} base url for comments\n     */\n    commentsUrl(id?: string): string {\n        const baseUrl = `${this.getBaseApiUrl()}/comments`;\n        return id ? `${baseUrl}/${id}` : baseUrl;\n    }\n\n    /**\n     * Formats comment data for use in components.\n     *\n     * @param {string} [id] - An individual comment entry from the API\n     * @return {Task} A task\n     */\n    format(comment: Object): Comment {\n        return {\n            ...comment,\n            tagged_message: comment.tagged_message !== '' ? comment.tagged_message : comment.message,\n        };\n    }\n\n    /**\n     * Formats the comments api response to usable data\n     * @param {Object} data the api response data\n     */\n    successHandler = (data: Object): void => {\n        if (this.isDestroyed() || typeof this.successCallback !== 'function') {\n            return;\n        }\n\n        // There is no response data when deleting a comment\n        if (!data) {\n            this.successCallback();\n            return;\n        }\n\n        // We don't have entries when updating/creating a comment\n        if (!data.entries) {\n            this.successCallback(this.format(data));\n            return;\n        }\n\n        const comments = data.entries.map(this.format);\n        this.successCallback({ ...data, entries: comments });\n    };\n\n    /**\n     * API for creating a comment on a file\n     *\n     * @param {BoxItem} file - File object for which we are creating a comment\n     * @param {string} message - Comment message\n     * @param {string} taggedMessage - Comment message with @mentions\n     * @param {Function} successCallback - Success callback\n     * @param {Function} errorCallback - Error callback\n     * @return {void}\n     */\n    createComment({\n        file,\n        message,\n        taggedMessage,\n        successCallback,\n        errorCallback,\n    }: {\n        errorCallback: ElementsErrorCallback,\n        file: BoxItem,\n        message?: string,\n        successCallback: Function,\n        taggedMessage?: string,\n    }): void {\n        this.errorCode = ERROR_CODE_CREATE_COMMENT;\n        const { id = '', permissions } = file;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_COMMENT, permissions, id);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const requestData = {\n            data: {\n                item: {\n                    id,\n                    type: 'file',\n                },\n                message,\n                tagged_message: taggedMessage,\n            },\n            params: {\n                fields: COMMENTS_FIELDS_TO_FETCH.toString(),\n            },\n        };\n\n        this.post({\n            id,\n            url: this.commentsUrl(),\n            data: requestData,\n            successCallback,\n            errorCallback,\n        });\n    }\n\n    /**\n     * API for updating a comment on a file\n     *\n     * @param {BoxItem} file - File object for which we are updating a comment\n     * @param {string} commentId - Comment to be edited\n     * @param {string} message - Comment message\n     * @param {BoxItemPermission} permissions - The known permissions of the comment we're updating\n     * @param {Function} successCallback - Success callback\n     * @param {Function} errorCallback - Error callback\n     * @return {void}\n     */\n    updateComment({\n        file,\n        commentId,\n        message,\n        tagged_message,\n        permissions,\n        successCallback,\n        errorCallback,\n    }: {\n        commentId: string,\n        errorCallback: ElementsErrorCallback,\n        file: BoxItem,\n        message: string,\n        permissions: BoxItemPermission,\n        successCallback: Function,\n        tagged_message?: string,\n    }): void {\n        this.errorCode = ERROR_CODE_UPDATE_COMMENT;\n        const { id = '' } = file;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_EDIT, permissions, id);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const requestData = {\n            data: { message, tagged_message },\n        };\n\n        this.put({\n            id,\n            url: this.commentsUrl(commentId),\n            data: requestData,\n            successCallback,\n            errorCallback,\n        });\n    }\n\n    /**\n     * API for deleting a comment on a file\n     *\n     * @param {BoxItem} file - File object for which we are deleting a comment\n     * @param {string} commentId - Id of the comment we are deleting\n     * @param {BoxItemPermission} permissions - The known permissions of the comment we're deleting\n     * @param {Function} successCallback - Success callback\n     * @param {Function} errorCallback - Error callback\n     * @return {void}\n     */\n    deleteComment({\n        file,\n        commentId,\n        permissions,\n        successCallback,\n        errorCallback,\n    }: {\n        commentId: string,\n        errorCallback: ElementsErrorCallback,\n        file: BoxItem,\n        permissions: BoxItemPermission,\n        successCallback: Function,\n    }): void {\n        this.errorCode = ERROR_CODE_DELETE_COMMENT;\n        const { id = '' } = file;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_DELETE, permissions, id);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.delete({\n            id,\n            url: this.commentsUrl(commentId),\n            successCallback,\n            errorCallback,\n        });\n    }\n\n    /**\n     * API for fetching comments on a file\n     *\n     * @param {string} fileId - the file id\n     * @param {BoxItemPermission} permissions - the permissions for the file\n     * @param {Function} successCallback - the success callback\n     * @param {Function} errorCallback - the error callback\n     * @param {array} fields - the fields to fetch\n     * @param {number} offset - the offset from the start to start fetching at\n     * @param {number} limit - the number of items to fetch\n     * @param {boolean} shouldFetchAll - true if should get all the pages before calling the sucessCallback\n     * @returns {void}\n     */\n    getComments(\n        fileId: string,\n        permissions: BoxItemPermission,\n        successCallback: Function,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n        fields: Array<string> = COMMENTS_FIELDS_TO_FETCH,\n        offset?: number,\n        limit?: number,\n        shouldFetchAll?: boolean,\n    ): void {\n        this.errorCode = ERROR_CODE_FETCH_COMMENTS;\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_COMMENT, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.offsetGet(fileId, successCallback, errorCallback, offset, limit, fields, shouldFetchAll);\n    }\n}\n\nexport default Comments;\n"],"file":"Comments.js"}
+{"version":3,"sources":["../../src/api/Comments.js"],"names":["COMMENTS_FIELDS_TO_FETCH","OffsetBasedAPI","PERMISSION_CAN_COMMENT","PERMISSION_CAN_DELETE","PERMISSION_CAN_EDIT","ERROR_CODE_CREATE_COMMENT","ERROR_CODE_UPDATE_COMMENT","ERROR_CODE_DELETE_COMMENT","ERROR_CODE_FETCH_COMMENTS","Comments","data","isDestroyed","successCallback","entries","format","comments","map","id","Error","getBaseApiUrl","baseUrl","comment","tagged_message","message","file","taggedMessage","errorCallback","errorCode","permissions","checkApiCallValidity","e","requestData","item","type","params","fields","toString","post","url","commentsUrl","commentId","put","delete","fileId","offset","limit","shouldFetchAll","offsetGet"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAMA,SAASA,wBAAT,QAAyC,iBAAzC;AACA,OAAOC,cAAP,MAA2B,kBAA3B;AACA,SACIC,sBADJ,EAEIC,qBAFJ,EAGIC,mBAHJ,EAIIC,yBAJJ,EAKIC,yBALJ,EAMIC,yBANJ,EAOIC,yBAPJ,QAQO,cARP;;IAaMC,Q;;;;;;;;;;;;;;;;;;qEA2Ce,UAACC,IAAD,EAAwB;AACrC,UAAI,MAAKC,WAAL,MAAsB,OAAO,MAAKC,eAAZ,KAAgC,UAA1D,EAAsE;AAClE;AACH,OAHoC,CAKrC;;;AACA,UAAI,CAACF,IAAL,EAAW;AACP,cAAKE,eAAL;;AACA;AACH,OAToC,CAWrC;;;AACA,UAAI,CAACF,IAAI,CAACG,OAAV,EAAmB;AACf,cAAKD,eAAL,CAAqB,MAAKE,MAAL,CAAYJ,IAAZ,CAArB;;AACA;AACH;;AAED,UAAMK,QAAQ,GAAGL,IAAI,CAACG,OAAL,CAAaG,GAAb,CAAiB,MAAKF,MAAtB,CAAjB;;AACA,YAAKF,eAAL,mBAA0BF,IAA1B;AAAgCG,QAAAA,OAAO,EAAEE;AAAzC;AACH,K;;;;;;;;AA7DD;;;;;;2BAMOE,E,EAAqB;AACxB,UAAI,CAACA,EAAL,EAAS;AACL,cAAM,IAAIC,KAAJ,CAAU,kBAAV,CAAN;AACH;;AAED,uBAAU,KAAKC,aAAL,EAAV,oBAAwCF,EAAxC;AACH;AAED;;;;;;;;;gCAMYA,E,EAAqB;AAC7B,UAAMG,OAAO,aAAM,KAAKD,aAAL,EAAN,cAAb;AACA,aAAOF,EAAE,aAAMG,OAAN,cAAiBH,EAAjB,IAAwBG,OAAjC;AACH;AAED;;;;;;;;;2BAMOC,O,EAA0B;AAC7B,+BACOA,OADP;AAEIC,QAAAA,cAAc,EAAED,OAAO,CAACC,cAAR,KAA2B,EAA3B,GAAgCD,OAAO,CAACC,cAAxC,GAAyDD,OAAO,CAACE;AAFrF;AAIH;AAED;;;;;;;;AAyBA;;;;;;;;;;wCAsBS;AAAA,UAXLC,IAWK,QAXLA,IAWK;AAAA,UAVLD,OAUK,QAVLA,OAUK;AAAA,UATLE,aASK,QATLA,aASK;AAAA,UARLb,eAQK,QARLA,eAQK;AAAA,UAPLc,aAOK,QAPLA,aAOK;AACL,WAAKC,SAAL,GAAiBtB,yBAAjB;AADK,qBAE4BmB,IAF5B,CAEGP,EAFH;AAAA,UAEGA,EAFH,yBAEQ,EAFR;AAAA,UAEYW,WAFZ,GAE4BJ,IAF5B,CAEYI,WAFZ;;AAIL,UAAI;AACA,aAAKC,oBAAL,CAA0B3B,sBAA1B,EAAkD0B,WAAlD,EAA+DX,EAA/D;AACH,OAFD,CAEE,OAAOa,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,UAAMI,WAAW,GAAG;AAChBrB,QAAAA,IAAI,EAAE;AACFsB,UAAAA,IAAI,EAAE;AACFf,YAAAA,EAAE,EAAFA,EADE;AAEFgB,YAAAA,IAAI,EAAE;AAFJ,WADJ;AAKFV,UAAAA,OAAO,EAAPA,OALE;AAMFD,UAAAA,cAAc,EAAEG;AANd,SADU;AAShBS,QAAAA,MAAM,EAAE;AACJC,UAAAA,MAAM,EAAEnC,wBAAwB,CAACoC,QAAzB;AADJ;AATQ,OAApB;AAcA,WAAKC,IAAL,CAAU;AACNpB,QAAAA,EAAE,EAAFA,EADM;AAENqB,QAAAA,GAAG,EAAE,KAAKC,WAAL,EAFC;AAGN7B,QAAAA,IAAI,EAAEqB,WAHA;AAINnB,QAAAA,eAAe,EAAfA,eAJM;AAKNc,QAAAA,aAAa,EAAbA;AALM,OAAV;AAOH;AAED;;;;;;;;;;;;;;yCA2BS;AAAA,UAfLF,IAeK,SAfLA,IAeK;AAAA,UAdLgB,SAcK,SAdLA,SAcK;AAAA,UAbLjB,OAaK,SAbLA,OAaK;AAAA,UAZLD,cAYK,SAZLA,cAYK;AAAA,UAXLM,WAWK,SAXLA,WAWK;AAAA,UAVLhB,eAUK,SAVLA,eAUK;AAAA,UATLc,aASK,SATLA,aASK;AACL,WAAKC,SAAL,GAAiBrB,yBAAjB;AADK,sBAEekB,IAFf,CAEGP,EAFH;AAAA,UAEGA,EAFH,0BAEQ,EAFR;;AAIL,UAAI;AACA,aAAKY,oBAAL,CAA0BzB,mBAA1B,EAA+CwB,WAA/C,EAA4DX,EAA5D;AACH,OAFD,CAEE,OAAOa,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,UAAMI,WAAW,GAAG;AAChBrB,QAAAA,IAAI,EAAE;AAAEa,UAAAA,OAAO,EAAPA,OAAF;AAAWD,UAAAA,cAAc,EAAdA;AAAX;AADU,OAApB;AAIA,WAAKmB,GAAL,CAAS;AACLxB,QAAAA,EAAE,EAAFA,EADK;AAELqB,QAAAA,GAAG,EAAE,KAAKC,WAAL,CAAiBC,SAAjB,CAFA;AAGL9B,QAAAA,IAAI,EAAEqB,WAHD;AAILnB,QAAAA,eAAe,EAAfA,eAJK;AAKLc,QAAAA,aAAa,EAAbA;AALK,OAAT;AAOH;AAED;;;;;;;;;;;;;yCAsBS;AAAA,UAXLF,IAWK,SAXLA,IAWK;AAAA,UAVLgB,SAUK,SAVLA,SAUK;AAAA,UATLZ,WASK,SATLA,WASK;AAAA,UARLhB,eAQK,SARLA,eAQK;AAAA,UAPLc,aAOK,SAPLA,aAOK;AACL,WAAKC,SAAL,GAAiBpB,yBAAjB;AADK,sBAEeiB,IAFf,CAEGP,EAFH;AAAA,UAEGA,EAFH,0BAEQ,EAFR;;AAIL,UAAI;AACA,aAAKY,oBAAL,CAA0B1B,qBAA1B,EAAiDyB,WAAjD,EAA8DX,EAA9D;AACH,OAFD,CAEE,OAAOa,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,WAAKe,MAAL,CAAY;AACRzB,QAAAA,EAAE,EAAFA,EADQ;AAERqB,QAAAA,GAAG,EAAE,KAAKC,WAAL,CAAiBC,SAAjB,CAFG;AAGR5B,QAAAA,eAAe,EAAfA,eAHQ;AAIRc,QAAAA,aAAa,EAAbA;AAJQ,OAAZ;AAMH;AAED;;;;;;;;;;;;;;;;gCAcIiB,M,EACAf,W,EACAhB,e,EACAc,a,EAKI;AAAA,UAJJS,MAII,uEAJoBnC,wBAIpB;AAAA,UAHJ4C,MAGI;AAAA,UAFJC,KAEI;AAAA,UADJC,cACI;AACJ,WAAKnB,SAAL,GAAiBnB,yBAAjB;;AACA,UAAI;AACA,aAAKqB,oBAAL,CAA0B3B,sBAA1B,EAAkD0B,WAAlD,EAA+De,MAA/D;AACH,OAFD,CAEE,OAAOb,CAAP,EAAU;AACRJ,QAAAA,aAAa,CAACI,CAAD,EAAI,KAAKH,SAAT,CAAb;AACA;AACH;;AAED,WAAKoB,SAAL,CAAeJ,MAAf,EAAuB/B,eAAvB,EAAwCc,aAAxC,EAAuDkB,MAAvD,EAA+DC,KAA/D,EAAsEV,MAAtE,EAA8EW,cAA9E;AACH;;;;EApPkB7C,c;;AAuPvB,eAAeQ,QAAf","sourcesContent":["/**\n * @flow\n * @file Helper for the box comments API\n * @author Box\n */\n\nimport { COMMENTS_FIELDS_TO_FETCH } from '../utils/fields';\nimport OffsetBasedAPI from './OffsetBasedAPI';\nimport {\n    PERMISSION_CAN_COMMENT,\n    PERMISSION_CAN_DELETE,\n    PERMISSION_CAN_EDIT,\n    ERROR_CODE_CREATE_COMMENT,\n    ERROR_CODE_UPDATE_COMMENT,\n    ERROR_CODE_DELETE_COMMENT,\n    ERROR_CODE_FETCH_COMMENTS,\n} from '../constants';\nimport type { ElementsXhrError, ElementsErrorCallback } from '../common/types/api';\nimport type { BoxItem, BoxItemPermission } from '../common/types/core';\nimport type { BoxCommentPermission } from '../common/types/feed';\n\nclass Comments extends OffsetBasedAPI {\n    /**\n     * API URL for comments on a file\n     *\n     * @param {string} id - A box file id\n     * @return {string} base url for files\n     */\n    getUrl(id?: string): string {\n        if (!id) {\n            throw new Error('Missing file id!');\n        }\n\n        return `${this.getBaseApiUrl()}/files/${id}/comments`;\n    }\n\n    /**\n     * API URL for comments endpoint\n     *\n     * @param {string} [id] - A box comment id\n     * @return {string} base url for comments\n     */\n    commentsUrl(id?: string): string {\n        const baseUrl = `${this.getBaseApiUrl()}/comments`;\n        return id ? `${baseUrl}/${id}` : baseUrl;\n    }\n\n    /**\n     * Formats comment data for use in components.\n     *\n     * @param {string} [id] - An individual comment entry from the API\n     * @return {Task} A task\n     */\n    format(comment: Object): Comment {\n        return {\n            ...comment,\n            tagged_message: comment.tagged_message !== '' ? comment.tagged_message : comment.message,\n        };\n    }\n\n    /**\n     * Formats the comments api response to usable data\n     * @param {Object} data the api response data\n     */\n    successHandler = (data: Object): void => {\n        if (this.isDestroyed() || typeof this.successCallback !== 'function') {\n            return;\n        }\n\n        // There is no response data when deleting a comment\n        if (!data) {\n            this.successCallback();\n            return;\n        }\n\n        // We don't have entries when updating/creating a comment\n        if (!data.entries) {\n            this.successCallback(this.format(data));\n            return;\n        }\n\n        const comments = data.entries.map(this.format);\n        this.successCallback({ ...data, entries: comments });\n    };\n\n    /**\n     * API for creating a comment on a file\n     *\n     * @param {BoxItem} file - File object for which we are creating a comment\n     * @param {string} message - Comment message\n     * @param {string} taggedMessage - Comment message with @mentions\n     * @param {Function} successCallback - Success callback\n     * @param {Function} errorCallback - Error callback\n     * @return {void}\n     */\n    createComment({\n        file,\n        message,\n        taggedMessage,\n        successCallback,\n        errorCallback,\n    }: {\n        errorCallback: ElementsErrorCallback,\n        file: BoxItem,\n        message?: string,\n        successCallback: Function,\n        taggedMessage?: string,\n    }): void {\n        this.errorCode = ERROR_CODE_CREATE_COMMENT;\n        const { id = '', permissions } = file;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_COMMENT, permissions, id);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const requestData = {\n            data: {\n                item: {\n                    id,\n                    type: 'file',\n                },\n                message,\n                tagged_message: taggedMessage,\n            },\n            params: {\n                fields: COMMENTS_FIELDS_TO_FETCH.toString(),\n            },\n        };\n\n        this.post({\n            id,\n            url: this.commentsUrl(),\n            data: requestData,\n            successCallback,\n            errorCallback,\n        });\n    }\n\n    /**\n     * API for updating a comment on a file\n     *\n     * @param {BoxItem} file - File object for which we are updating a comment\n     * @param {string} commentId - Comment to be edited\n     * @param {string} message - Comment message\n     * @param {BoxCommentPermission} permissions - The known permissions of the comment we're updating\n     * @param {Function} successCallback - Success callback\n     * @param {Function} errorCallback - Error callback\n     * @return {void}\n     */\n    updateComment({\n        file,\n        commentId,\n        message,\n        tagged_message,\n        permissions,\n        successCallback,\n        errorCallback,\n    }: {\n        commentId: string,\n        errorCallback: ElementsErrorCallback,\n        file: BoxItem,\n        message: string,\n        permissions: BoxCommentPermission,\n        successCallback: Function,\n        tagged_message?: string,\n    }): void {\n        this.errorCode = ERROR_CODE_UPDATE_COMMENT;\n        const { id = '' } = file;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_EDIT, permissions, id);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        const requestData = {\n            data: { message, tagged_message },\n        };\n\n        this.put({\n            id,\n            url: this.commentsUrl(commentId),\n            data: requestData,\n            successCallback,\n            errorCallback,\n        });\n    }\n\n    /**\n     * API for deleting a comment on a file\n     *\n     * @param {BoxItem} file - File object for which we are deleting a comment\n     * @param {string} commentId - Id of the comment we are deleting\n     * @param {BoxCommentPermission} permissions - The known permissions of the comment we're deleting\n     * @param {Function} successCallback - Success callback\n     * @param {Function} errorCallback - Error callback\n     * @return {void}\n     */\n    deleteComment({\n        file,\n        commentId,\n        permissions,\n        successCallback,\n        errorCallback,\n    }: {\n        commentId: string,\n        errorCallback: ElementsErrorCallback,\n        file: BoxItem,\n        permissions: BoxCommentPermission,\n        successCallback: Function,\n    }): void {\n        this.errorCode = ERROR_CODE_DELETE_COMMENT;\n        const { id = '' } = file;\n\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_DELETE, permissions, id);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.delete({\n            id,\n            url: this.commentsUrl(commentId),\n            successCallback,\n            errorCallback,\n        });\n    }\n\n    /**\n     * API for fetching comments on a file\n     *\n     * @param {string} fileId - the file id\n     * @param {BoxItemPermission} permissions - the permissions for the file\n     * @param {Function} successCallback - the success callback\n     * @param {Function} errorCallback - the error callback\n     * @param {array} fields - the fields to fetch\n     * @param {number} offset - the offset from the start to start fetching at\n     * @param {number} limit - the number of items to fetch\n     * @param {boolean} shouldFetchAll - true if should get all the pages before calling the sucessCallback\n     * @returns {void}\n     */\n    getComments(\n        fileId: string,\n        permissions: BoxItemPermission,\n        successCallback: Function,\n        errorCallback: (e: ElementsXhrError, code: string) => void,\n        fields: Array<string> = COMMENTS_FIELDS_TO_FETCH,\n        offset?: number,\n        limit?: number,\n        shouldFetchAll?: boolean,\n    ): void {\n        this.errorCode = ERROR_CODE_FETCH_COMMENTS;\n        try {\n            this.checkApiCallValidity(PERMISSION_CAN_COMMENT, permissions, fileId);\n        } catch (e) {\n            errorCallback(e, this.errorCode);\n            return;\n        }\n\n        this.offsetGet(fileId, successCallback, errorCallback, offset, limit, fields, shouldFetchAll);\n    }\n}\n\nexport default Comments;\n"],"file":"Comments.js"}