feat: file censor (#656)

Author: sdjdd

src/file.js

@@ -3,7 +3,7 @@ const cos = require('./uploader/cos');
 const qiniu = require('./uploader/qiniu');
 const s3 = require('./uploader/s3');
 const AVError = require('./error');
-const AVRequest = require('./request')._request;
+const { request, _request: AVRequest } = require('./request');
 const { tap, transformFetchOptions } = require('./utils');
 const debug = require('debug')('leancloud:file');
 const parseBase64 = require('./utils/parse-base64');
@@ -196,6 +196,23 @@ module.exports = function(AV) {
     return file;
   };
 
+  /**
+   * Request file censor.
+   * @since 4.13.0
+   * @param {String} objectId
+   * @return {Promise.<string>}
+   */
+  AV.File.censor = function(objectId) {
+    if (!AV._config.masterKey) {
+      throw new Error('Cannot censor a file without masterKey');
+    }
+    return request({
+      method: 'POST',
+      path: `/files/${objectId}/censor`,
+      authOptions: { useMasterKey: true },
+    }).then(res => res.censorResult);
+  };
+
   _.extend(
     AV.File.prototype,
     /** @lends AV.File.prototype */ {
@@ -652,6 +669,18 @@ module.exports = function(AV) {
         _.extend(this, value);
         return this;
       },
+
+      /**
+       * Request file censor
+       * @since 4.13.0
+       * @return {Promise.<string>}
+       */
+      censor() {
+        if (!this.id) {
+          throw new Error('Cannot censor an unsaved file');
+        }
+        return AV.File.censor(this.id);
+      },
     }
   );
 };

storage.d.ts

@@ -150,6 +150,10 @@ export class ACL extends BaseObject {
   getWriteAccess(userId: string): boolean;
 }
 
+export namespace File {
+  export type CensorResult = 'rejected' | 'passed' | 'review';
+}
+
 /**
  * A AV.File is a local representation of a file that is saved to the AV
  * cloud.
@@ -187,6 +191,7 @@ export class File extends BaseObject {
   constructor(name: string, data: any, type?: string);
   static withURL(name: string, url: string): File;
   static createWithoutData(objectId: string): File;
+  static censor(objectId: string): Promise<File.CensorResult>;
 
   destroy(options?: AuthOptions): Promise<void>;
   fetch(fetchOptions?: FetchOptions, options?: AuthOptions): Promise<this>;
@@ -205,6 +210,7 @@ export class File extends BaseObject {
   setUploadHeader(key: string, value: string): this;
   size(): any;
   thumbnailURL(width: number, height: number): string;
+  censor(): Promise<File.CensorResult>;
   toFullJSON(): any;
 }