@gofynd/fdk-client-javascript 1.1.6 → 1.3.0

package/sdk/application/FileStorage/FileStorageApplicationClient.js

@@ -2,8 +2,8 @@ const ApplicationAPIClient = require("../ApplicationAPIClient");
 const { FDKClientValidationError } = require("../../common/FDKError");
 const constructUrl = require("../constructUrl");
 const Paginator = require("../../common/Paginator");
-const FileStorageValidator = require("./FileStorageApplicationValidator");
-const FileStorageModel = require("./FileStorageApplicationModel");
+const FileStorageApplicationValidator = require("./FileStorageApplicationValidator");
+const FileStorageApplicationModel = require("./FileStorageApplicationModel");
 const { Logger } = require("./../../common/Logger");
 const Joi = require("joi");
 const axios = require("axios");
@@ -35,13 +35,11 @@ class FileStorage {
   }
 
   /**
-   * @param {Object} arg - Arg object.
-   * @param {string} arg.namespace - Segregation of different types of
-   *   files(products, orders, logistics etc), Required for validating the
-   *   data of the file being uploaded, decides where exactly the file will be
-   *   stored inside the storage bucket.
-   * @param {StartResponse} arg.body
-   * @returns {Promise<CompleteResponse>} - Success response
+   * @param {FileStorageApplicationValidator.CompleteUploadParam} arg - Arg object.
+   * @param {object} [arg.requestHeaders={}] - Request headers. Default is `{}`
+   * @param {import("../ApplicationAPIClient").Options} - Options
+   * @returns {Promise<FileStorageApplicationModel.CompleteResponse>} - Success response
+   * @name completeUpload
    * @summary: Completes the upload process. After successfully uploading a file, call this API to finish the upload process.
    * @description: Use this API to perform the third step of uploading (i.e. **Complete**) an arbitrarily sized buffer or blob.
    *
@@ -61,9 +59,13 @@ class FileStorage {
    * ### Complete
    * After successfully upload, call the `completeUpload` API to finish the upload process.
    * This operation will return the URL of the uploaded file.
+   *  - Check out [method documentation](https://partners.fynd.com/help/docs/sdk/application/filestorage/completeUpload/).
    */
-  async completeUpload({ namespace, body } = {}) {
-    const { error } = FileStorageValidator.completeUpload().validate(
+  async completeUpload(
+    { namespace, body, requestHeaders } = { requestHeaders: {} },
+    { responseHeaders } = { responseHeaders: false }
+  ) {
+    const { error } = FileStorageApplicationValidator.completeUpload().validate(
       { namespace, body },
       { abortEarly: false, allowUnknown: true }
     );
@@ -72,16 +74,17 @@ class FileStorage {
     }
 
     // Showing warrnings if extra unknown parameters are found
-    const { error: warrning } = FileStorageValidator.completeUpload().validate(
+    const {
+      error: warrning,
+    } = FileStorageApplicationValidator.completeUpload().validate(
       { namespace, body },
       { abortEarly: false, allowUnknown: false }
     );
     if (warrning) {
       Logger({
         level: "WARN",
-        message: "Parameter Validation warrnings for completeUpload",
+        message: `Parameter Validation warrnings for application > FileStorage > completeUpload \n ${warrning}`,
       });
-      Logger({ level: "WARN", message: warrning });
     }
 
     const query_params = {};
@@ -97,12 +100,18 @@ class FileStorage {
       }),
       query_params,
       body,
-      xHeaders
+      { ...xHeaders, ...requestHeaders },
+      { responseHeaders }
     );
 
+    let responseData = response;
+    if (responseHeaders) {
+      responseData = response[0];
+    }
+
     const {
       error: res_error,
-    } = FileStorageModel.CompleteResponse().validate(response, {
+    } = FileStorageApplicationModel.CompleteResponse().validate(responseData, {
       abortEarly: false,
       allowUnknown: false,
     });
@@ -110,23 +119,27 @@ class FileStorage {
     if (res_error) {
       Logger({
         level: "WARN",
-        message: "Response Validation Warnnings for completeUpload",
+        message: `Response Validation Warnnings for application > FileStorage > completeUpload \n ${res_error}`,
       });
-      Logger({ level: "WARN", message: res_error });
     }
 
     return response;
   }
 
   /**
-   * @param {Object} arg - Arg object.
-   * @param {SignUrlRequest} arg.body
-   * @returns {Promise<SignUrlResponse>} - Success response
+   * @param {FileStorageApplicationValidator.SignUrlsParam} arg - Arg object.
+   * @param {object} [arg.requestHeaders={}] - Request headers. Default is `{}`
+   * @param {import("../ApplicationAPIClient").Options} - Options
+   * @returns {Promise<FileStorageApplicationModel.SignUrlResponse>} - Success response
+   * @name signUrls
    * @summary: Explain here
-   * @description: Describe here
+   * @description: Describe here - Check out [method documentation](https://partners.fynd.com/help/docs/sdk/application/filestorage/signUrls/).
    */
-  async signUrls({ body } = {}) {
-    const { error } = FileStorageValidator.signUrls().validate(
+  async signUrls(
+    { body, requestHeaders } = { requestHeaders: {} },
+    { responseHeaders } = { responseHeaders: false }
+  ) {
+    const { error } = FileStorageApplicationValidator.signUrls().validate(
       { body },
       { abortEarly: false, allowUnknown: true }
     );
@@ -135,16 +148,17 @@ class FileStorage {
     }
 
     // Showing warrnings if extra unknown parameters are found
-    const { error: warrning } = FileStorageValidator.signUrls().validate(
+    const {
+      error: warrning,
+    } = FileStorageApplicationValidator.signUrls().validate(
       { body },
       { abortEarly: false, allowUnknown: false }
     );
     if (warrning) {
       Logger({
         level: "WARN",
-        message: "Parameter Validation warrnings for signUrls",
+        message: `Parameter Validation warrnings for application > FileStorage > signUrls \n ${warrning}`,
       });
-      Logger({ level: "WARN", message: warrning });
     }
 
     const query_params = {};
@@ -160,12 +174,18 @@ class FileStorage {
       }),
       query_params,
       body,
-      xHeaders
+      { ...xHeaders, ...requestHeaders },
+      { responseHeaders }
     );
 
+    let responseData = response;
+    if (responseHeaders) {
+      responseData = response[0];
+    }
+
     const {
       error: res_error,
-    } = FileStorageModel.SignUrlResponse().validate(response, {
+    } = FileStorageApplicationModel.SignUrlResponse().validate(responseData, {
       abortEarly: false,
       allowUnknown: false,
     });
@@ -173,22 +193,19 @@ class FileStorage {
     if (res_error) {
       Logger({
         level: "WARN",
-        message: "Response Validation Warnnings for signUrls",
+        message: `Response Validation Warnnings for application > FileStorage > signUrls \n ${res_error}`,
       });
-      Logger({ level: "WARN", message: res_error });
     }
 
     return response;
   }
 
   /**
-   * @param {Object} arg - Arg object.
-   * @param {string} arg.namespace - Segregation of different types of
-   *   files(products, orders, logistics etc), Required for validating the
-   *   data of the file being uploaded, decides where exactly the file will be
-   *   stored inside the storage bucket.
-   * @param {StartRequest} arg.body
-   * @returns {Promise<StartResponse>} - Success response
+   * @param {FileStorageApplicationValidator.StartUploadParam} arg - Arg object.
+   * @param {object} [arg.requestHeaders={}] - Request headers. Default is `{}`
+   * @param {import("../ApplicationAPIClient").Options} - Options
+   * @returns {Promise<FileStorageApplicationModel.StartResponse>} - Success response
+   * @name startUpload
    * @summary: Initiates an upload and returns a storage link that is valid for 30 minutes. You can use the storage link to make subsequent upload request with file buffer or blob.
    * @description: Use this API to perform the first step of uploading (i.e. **Start**) an arbitrarily sized buffer or blob.
    *
@@ -208,9 +225,13 @@ class FileStorage {
    * ### Complete
    * After successfully upload, call the `completeUpload` API to finish the upload process.
    * This operation will return the URL of the uploaded file.
+   *  - Check out [method documentation](https://partners.fynd.com/help/docs/sdk/application/filestorage/startUpload/).
    */
-  async startUpload({ namespace, body } = {}) {
-    const { error } = FileStorageValidator.startUpload().validate(
+  async startUpload(
+    { namespace, body, requestHeaders } = { requestHeaders: {} },
+    { responseHeaders } = { responseHeaders: false }
+  ) {
+    const { error } = FileStorageApplicationValidator.startUpload().validate(
       { namespace, body },
       { abortEarly: false, allowUnknown: true }
     );
@@ -219,16 +240,17 @@ class FileStorage {
     }
 
     // Showing warrnings if extra unknown parameters are found
-    const { error: warrning } = FileStorageValidator.startUpload().validate(
+    const {
+      error: warrning,
+    } = FileStorageApplicationValidator.startUpload().validate(
       { namespace, body },
       { abortEarly: false, allowUnknown: false }
     );
     if (warrning) {
       Logger({
         level: "WARN",
-        message: "Parameter Validation warrnings for startUpload",
+        message: `Parameter Validation warrnings for application > FileStorage > startUpload \n ${warrning}`,
       });
-      Logger({ level: "WARN", message: warrning });
     }
 
     const query_params = {};
@@ -244,12 +266,18 @@ class FileStorage {
       }),
       query_params,
       body,
-      xHeaders
+      { ...xHeaders, ...requestHeaders },
+      { responseHeaders }
     );
 
+    let responseData = response;
+    if (responseHeaders) {
+      responseData = response[0];
+    }
+
     const {
       error: res_error,
-    } = FileStorageModel.StartResponse().validate(response, {
+    } = FileStorageApplicationModel.StartResponse().validate(responseData, {
       abortEarly: false,
       allowUnknown: false,
     });
@@ -257,9 +285,8 @@ class FileStorage {
     if (res_error) {
       Logger({
         level: "WARN",
-        message: "Response Validation Warnnings for startUpload",
+        message: `Response Validation Warnnings for application > FileStorage > startUpload \n ${res_error}`,
       });
-      Logger({ level: "WARN", message: res_error });
     }
 
     return response;

package/sdk/application/FileStorage/FileStorageApplicationModel.d.ts

@@ -1,21 +1,149 @@
-export = FileStorageModel;
-declare class FileStorageModel {
-    static BrowseResponse(): any;
-    static BulkRequest(): any;
-    static BulkUploadResponse(): any;
-    static CDN(): any;
-    static CompleteResponse(): any;
-    static CopyFileTask(): any;
-    static DbRecord(): any;
-    static Destination(): any;
-    static FailedResponse(): any;
-    static Opts(): any;
-    static Page(): any;
-    static ReqConfiguration(): any;
-    static SignUrlRequest(): any;
-    static SignUrlResponse(): any;
-    static StartRequest(): any;
-    static StartResponse(): any;
-    static Upload(): any;
-    static Urls(): any;
+export = FileStorageApplicationModel;
+/**
+ * @typedef CDN
+ * @property {string} absolute_url
+ * @property {string} relative_url
+ * @property {string} url
+ */
+/**
+ * @typedef CompleteResponse
+ * @property {string} _id
+ * @property {CDN} cdn
+ * @property {string} content_type
+ * @property {string} created_on
+ * @property {string} file_name
+ * @property {string} file_path
+ * @property {string} modified_on
+ * @property {string} namespace
+ * @property {string} operation
+ * @property {number} size
+ * @property {boolean} success
+ * @property {string[]} [tags]
+ * @property {Upload} upload
+ */
+/**
+ * @typedef FailedResponse
+ * @property {string} message
+ */
+/**
+ * @typedef SignUrlRequest
+ * @property {number} expiry
+ * @property {string[]} urls
+ */
+/**
+ * @typedef SignUrlResponse
+ * @property {Urls[]} urls
+ */
+/**
+ * @typedef StartRequest
+ * @property {string} content_type
+ * @property {string} file_name
+ * @property {Object} [params]
+ * @property {number} size
+ * @property {string[]} [tags]
+ */
+/**
+ * @typedef StartResponse
+ * @property {CDN} cdn
+ * @property {string} content_type
+ * @property {string} file_name
+ * @property {string} file_path
+ * @property {string} [method]
+ * @property {string} namespace
+ * @property {string} operation
+ * @property {number} size
+ * @property {string[]} [tags]
+ * @property {Upload} upload
+ */
+/**
+ * @typedef Upload
+ * @property {number} expiry
+ * @property {string} url
+ */
+/**
+ * @typedef Urls
+ * @property {number} expiry
+ * @property {string} signed_url
+ * @property {string} url
+ */
+declare class FileStorageApplicationModel {
 }
+declare namespace FileStorageApplicationModel {
+    export { CDN, CompleteResponse, FailedResponse, SignUrlRequest, SignUrlResponse, StartRequest, StartResponse, Upload, Urls };
+}
+/** @returns {CDN} */
+declare function CDN(): CDN;
+type CDN = {
+    absolute_url: string;
+    relative_url: string;
+    url: string;
+};
+/** @returns {CompleteResponse} */
+declare function CompleteResponse(): CompleteResponse;
+type CompleteResponse = {
+    _id: string;
+    cdn: CDN;
+    content_type: string;
+    created_on: string;
+    file_name: string;
+    file_path: string;
+    modified_on: string;
+    namespace: string;
+    operation: string;
+    size: number;
+    success: boolean;
+    tags?: string[];
+    upload: Upload;
+};
+/** @returns {FailedResponse} */
+declare function FailedResponse(): FailedResponse;
+type FailedResponse = {
+    message: string;
+};
+/** @returns {SignUrlRequest} */
+declare function SignUrlRequest(): SignUrlRequest;
+type SignUrlRequest = {
+    expiry: number;
+    urls: string[];
+};
+/** @returns {SignUrlResponse} */
+declare function SignUrlResponse(): SignUrlResponse;
+type SignUrlResponse = {
+    urls: Urls[];
+};
+/** @returns {StartRequest} */
+declare function StartRequest(): StartRequest;
+type StartRequest = {
+    content_type: string;
+    file_name: string;
+    params?: any;
+    size: number;
+    tags?: string[];
+};
+/** @returns {StartResponse} */
+declare function StartResponse(): StartResponse;
+type StartResponse = {
+    cdn: CDN;
+    content_type: string;
+    file_name: string;
+    file_path: string;
+    method?: string;
+    namespace: string;
+    operation: string;
+    size: number;
+    tags?: string[];
+    upload: Upload;
+};
+/** @returns {Upload} */
+declare function Upload(): Upload;
+type Upload = {
+    expiry: number;
+    url: string;
+};
+/** @returns {Urls} */
+declare function Urls(): Urls;
+type Urls = {
+    expiry: number;
+    signed_url: string;
+    url: string;
+};

package/sdk/application/FileStorage/FileStorageApplicationModel.js

@@ -1,25 +1,83 @@
 const Joi = require("joi");
 
-class FileStorageModel {
-  static BrowseResponse() {
-    return Joi.object({
-      items: Joi.array().items(FileStorageModel.DbRecord()).required(),
-      page: FileStorageModel.Page().required(),
-    });
-  }
-  static BulkRequest() {
-    return Joi.object({
-      configuration: FileStorageModel.ReqConfiguration(),
-      destination: FileStorageModel.Destination().required(),
-      urls: Joi.array().items(Joi.string().allow("")).required(),
-    });
-  }
-  static BulkUploadResponse() {
-    return Joi.object({
-      task: FileStorageModel.CopyFileTask().required(),
-      tracking_url: Joi.string().allow("").required(),
-    });
-  }
+/**
+ * @typedef CDN
+ * @property {string} absolute_url
+ * @property {string} relative_url
+ * @property {string} url
+ */
+
+/**
+ * @typedef CompleteResponse
+ * @property {string} _id
+ * @property {CDN} cdn
+ * @property {string} content_type
+ * @property {string} created_on
+ * @property {string} file_name
+ * @property {string} file_path
+ * @property {string} modified_on
+ * @property {string} namespace
+ * @property {string} operation
+ * @property {number} size
+ * @property {boolean} success
+ * @property {string[]} [tags]
+ * @property {Upload} upload
+ */
+
+/**
+ * @typedef FailedResponse
+ * @property {string} message
+ */
+
+/**
+ * @typedef SignUrlRequest
+ * @property {number} expiry
+ * @property {string[]} urls
+ */
+
+/**
+ * @typedef SignUrlResponse
+ * @property {Urls[]} urls
+ */
+
+/**
+ * @typedef StartRequest
+ * @property {string} content_type
+ * @property {string} file_name
+ * @property {Object} [params]
+ * @property {number} size
+ * @property {string[]} [tags]
+ */
+
+/**
+ * @typedef StartResponse
+ * @property {CDN} cdn
+ * @property {string} content_type
+ * @property {string} file_name
+ * @property {string} file_path
+ * @property {string} [method]
+ * @property {string} namespace
+ * @property {string} operation
+ * @property {number} size
+ * @property {string[]} [tags]
+ * @property {Upload} upload
+ */
+
+/**
+ * @typedef Upload
+ * @property {number} expiry
+ * @property {string} url
+ */
+
+/**
+ * @typedef Urls
+ * @property {number} expiry
+ * @property {string} signed_url
+ * @property {string} url
+ */
+
+class FileStorageApplicationModel {
+  /** @returns {CDN} */
   static CDN() {
     return Joi.object({
       absolute_url: Joi.string().allow("").required(),
@@ -27,10 +85,12 @@ class FileStorageModel {
       url: Joi.string().allow("").required(),
     });
   }
+
+  /** @returns {CompleteResponse} */
   static CompleteResponse() {
     return Joi.object({
       _id: Joi.string().allow("").required(),
-      cdn: FileStorageModel.CDN().required(),
+      cdn: FileStorageApplicationModel.CDN().required(),
       content_type: Joi.string().allow("").required(),
       created_on: Joi.string().allow("").required(),
       file_name: Joi.string().allow("").required(),
@@ -41,86 +101,33 @@ class FileStorageModel {
       size: Joi.number().required(),
       success: Joi.boolean().required(),
       tags: Joi.array().items(Joi.string().allow("")),
-      upload: FileStorageModel.Upload().required(),
-    });
-  }
-  static CopyFileTask() {
-    return Joi.object({
-      attempts_made: Joi.number().required(),
-      data: FileStorageModel.BulkRequest().required(),
-      delay: Joi.number().required(),
-      finished_on: Joi.number().required(),
-      id: Joi.string().allow("").required(),
-      name: Joi.string().allow("").required(),
-      opts: FileStorageModel.Opts().required(),
-      processed_on: Joi.number().required(),
-      progress: Joi.number().required(),
-      stacktrace: Joi.array().items(Joi.string().allow("")),
-      timestamp: Joi.number().required(),
-    });
-  }
-  static DbRecord() {
-    return Joi.object({
-      _id: Joi.string().allow("").required(),
-      cdn: FileStorageModel.CDN().required(),
-      content_type: Joi.string().allow("").required(),
-      created_on: Joi.string().allow("").required(),
-      file_name: Joi.string().allow("").required(),
-      file_path: Joi.string().allow("").required(),
-      modified_on: Joi.string().allow("").required(),
-      namespace: Joi.string().allow("").required(),
-      operation: Joi.string().allow(""),
-      success: Joi.boolean().required(),
-      tags: Joi.array().items(Joi.string().allow("")).required(),
-      upload: FileStorageModel.Upload().required(),
-    });
-  }
-  static Destination() {
-    return Joi.object({
-      basepath: Joi.string().allow(""),
-      namespace: Joi.string().allow("").required(),
-      rewrite: Joi.string().allow("").required(),
+      upload: FileStorageApplicationModel.Upload().required(),
     });
   }
+
+  /** @returns {FailedResponse} */
   static FailedResponse() {
     return Joi.object({
       message: Joi.string().allow("").required(),
     });
   }
-  static Opts() {
-    return Joi.object({
-      attempts: Joi.number(),
-      delay: Joi.number(),
-      timestamp: Joi.number(),
-    });
-  }
-  static Page() {
-    return Joi.object({
-      current: Joi.number(),
-      has_next: Joi.boolean(),
-      has_previous: Joi.boolean(),
-      item_total: Joi.number(),
-      next_id: Joi.string().allow(""),
-      size: Joi.number(),
-      type: Joi.string().allow("").required(),
-    });
-  }
-  static ReqConfiguration() {
-    return Joi.object({
-      concurrency: Joi.number(),
-    });
-  }
+
+  /** @returns {SignUrlRequest} */
   static SignUrlRequest() {
     return Joi.object({
       expiry: Joi.number().required(),
       urls: Joi.array().items(Joi.string().allow("")).required(),
     });
   }
+
+  /** @returns {SignUrlResponse} */
   static SignUrlResponse() {
     return Joi.object({
-      urls: Joi.array().items(FileStorageModel.Urls()).required(),
+      urls: Joi.array().items(FileStorageApplicationModel.Urls()).required(),
     });
   }
+
+  /** @returns {StartRequest} */
   static StartRequest() {
     return Joi.object({
       content_type: Joi.string().allow("").required(),
@@ -130,9 +137,11 @@ class FileStorageModel {
       tags: Joi.array().items(Joi.string().allow("")),
     });
   }
+
+  /** @returns {StartResponse} */
   static StartResponse() {
     return Joi.object({
-      cdn: FileStorageModel.CDN().required(),
+      cdn: FileStorageApplicationModel.CDN().required(),
       content_type: Joi.string().allow("").required(),
       file_name: Joi.string().allow("").required(),
       file_path: Joi.string().allow("").required(),
@@ -141,15 +150,19 @@ class FileStorageModel {
       operation: Joi.string().allow("").required(),
       size: Joi.number().required(),
       tags: Joi.array().items(Joi.string().allow("")),
-      upload: FileStorageModel.Upload().required(),
+      upload: FileStorageApplicationModel.Upload().required(),
     });
   }
+
+  /** @returns {Upload} */
   static Upload() {
     return Joi.object({
       expiry: Joi.number().required(),
       url: Joi.string().allow("").required(),
     });
   }
+
+  /** @returns {Urls} */
   static Urls() {
     return Joi.object({
       expiry: Joi.number().required(),
@@ -158,4 +171,4 @@ class FileStorageModel {
     });
   }
 }
-module.exports = FileStorageModel;
+module.exports = FileStorageApplicationModel;