Merge pull request #98 from imagekit-developer/IK-1499

added checks paramter

README.md

@@ -350,7 +350,8 @@ imagekit.upload({
                 value: 'w-100'
             }
         ]
-    }
+    },
+    checks={`"file.size" < "1mb"`} // To run server side checks before uploading files. Notice the quotes around file.size and 1mb.
 }, function(error, result) {
     if(error) console.log(error);
     else console.log(result);
@@ -376,7 +377,8 @@ imagekit.upload({
                 value: 'w-100'
             }
         ]
-    }
+    },
+    checks={`"file.size" < "1mb"`}
 }).then(response => {
     console.log(response);
 }).catch(error => {

libs/interfaces/UploadOptions.ts

@@ -108,4 +108,8 @@ export interface UploadOptions {
     [key: string]: string | number | boolean | Array<string | number | boolean>;
   },
   transformation?: Transformation
+  /**
+   * Optional `checks` parameters can be used to run server-side checks before files are uploaded to the Media Library.
+   */
+  checks?: string
 }

libs/upload/index.ts

@@ -92,6 +92,8 @@ export default function (
       } else if (key === "transformation" && typeof uploadOptions.transformation === "object" &&
         uploadOptions.transformation !== null) {
         form.append(key, JSON.stringify(uploadOptions.transformation));
+      } else if (key === "checks" && uploadOptions.checks) {
+        form.append(key, uploadOptions.checks);
       } else {
         form.append(key, String(uploadOptions[key]));
       }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "imagekit",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "description": "Offical NodeJS SDK for ImageKit.io integration",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

tests/upload.js

@@ -548,4 +548,28 @@ describe("File upload", function () {
       expect(callback.calledOnce).to.be.true;
       sinon.assert.calledWith(callback, errRes, null);
     });
+
+    it("With checks option", function (done) {
+      const fileOptions = {
+        fileName: "test_file_name",
+        file: "test_file_content",
+        checks: "'request.folder' : '/'",
+      };
+
+      var callback = sinon.spy();
+
+      const scope = nock("https://upload.imagekit.io/api")
+        .post("/v1/files/upload")
+        .basicAuth({ user: initializationParams.privateKey, pass: "" })
+        .reply(200, function (uri, requestBody) {
+          expect(this.req.headers["content-type"]).include("multipart/form-data; boundary=---------------------");
+          var boundary = this.req.headers["content-type"].replace("multipart/form-data; boundary=", "");
+          checkFormData({ requestBody, boundary, fieldName: "fileName", fieldValue: fileOptions.fileName });
+          checkFormData({ requestBody, boundary, fieldName: "file", fieldValue: fileOptions.file });
+          checkFormData({ requestBody, boundary, fieldName: "checks", fieldValue: fileOptions.checks });
+          done();
+        });
+
+      imagekit.upload(fileOptions, callback);
+    });
 });