zudello-integration-sdk 1.0.14 → 1.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "zudello-integration-sdk",
-	"version": "1.0.14",
+	"version": "1.0.16",
 	"description": "Zudello Integrations SDK",
 	"main": "./src/index.js",
 	"repository": {

package/src/index.js

@@ -1,64 +1,68 @@
-'use strict'
+"use strict";
 
-const Auth = require('./sdk/Auth')
-const ZudelloSDK = require('./sdk/Zudello')
-const NetsuiteSDK = require('./sdk/Netsuite')
-const NetsuiteSoapSDK = require('./sdk/NetsuiteSOAP')
-const IntacctSDK = require('./sdk/Intacct')
-const BusinessCentralSDK = require('./sdk/BusinessCentral')
-const ZenotiSDK = require('./sdk/Zenoti')
-const DearSDK = require('./sdk/Dear')
-const NexviaSDK = require('./sdk/Nexvia')
-const FoSDK = require('./sdk/Fo')
-const RetailExpressSDK = require('./sdk/RetailExpress')
-const MYOBAcumaticaSDK = require('./sdk/MYOBAcumatica')
-const SybizSDK = require('./sdk/Sybiz')
-const JobReadySDK = require('./sdk/JobReady')
+const Auth = require("./sdk/Auth");
+const ZudelloSDK = require("./sdk/Zudello");
+const NetsuiteSDK = require("./sdk/Netsuite");
+const NetsuiteSoapSDK = require("./sdk/NetsuiteSOAP");
+const IntacctSDK = require("./sdk/Intacct");
+const BusinessCentralSDK = require("./sdk/BusinessCentral");
+const ZenotiSDK = require("./sdk/Zenoti");
+const DearSDK = require("./sdk/Dear");
+const NexviaSDK = require("./sdk/Nexvia");
+const FoSDK = require("./sdk/Fo");
+const RetailExpressSDK = require("./sdk/RetailExpress");
+const MYOBAcumaticaSDK = require("./sdk/MYOBAcumatica");
+const SybizSDK = require("./sdk/Sybiz");
+const XeroSDK = require("./sdk/Xero");
+const JobReadySDK = require("./sdk/JobReady");
 
-const Logger = require('./utils/logger')
-const Metadata = require('./utils/metadata')
-const Tags = require('./utils/tags')
-const Trigger = require('./utils/trigger')
-const Properties = require('./utils/properties')
-const MiscHelper = require('./utils/miscHelper')
-const ModelHelper = require('./utils/modelHelper')
+const Logger = require("./utils/logger");
+const Metadata = require("./utils/metadata");
+const Tags = require("./utils/tags");
+const Trigger = require("./utils/trigger");
+const Properties = require("./utils/properties");
+const MiscHelper = require("./utils/miscHelper");
+const ModelHelper = require("./utils/modelHelper");
+const DatasetHelper = require("./utils/datasetHelper");
 const {
-  getFileContent,
-  uploadFile,
-  listFiles,
-  deleteFile,
-  deleteFiles
-} = require('./utils/s3Client')
+	getFileContent,
+	uploadFile,
+	listFiles,
+	deleteFile,
+	deleteFiles,
+} = require("./utils/s3Client");
 
 const S3Client = {
-  getFileContent,
-  uploadFile,
-  listFiles,
-  deleteFile,
-  deleteFiles
-}
+	getFileContent,
+	uploadFile,
+	listFiles,
+	deleteFile,
+	deleteFiles,
+};
 
 module.exports = {
-  Auth,
-  ZudelloSDK,
-  NetsuiteSDK,
-  NetsuiteSoapSDK,
-  IntacctSDK,
-  BusinessCentralSDK,
-  ZenotiSDK,
-  DearSDK,
-  NexviaSDK,
-  FoSDK,
-  RetailExpressSDK,
-  MYOBAcumaticaSDK,
-  SybizSDK,
-  JobReadySDK,
-  Logger,
-  Metadata,
-  Tags,
-  Trigger,
-  Properties,
-  MiscHelper,
-  ModelHelper,
-  S3Client
-}
+	Auth,
+	ZudelloSDK,
+	NetsuiteSDK,
+	NetsuiteSoapSDK,
+	IntacctSDK,
+	BusinessCentralSDK,
+	ZenotiSDK,
+	DearSDK,
+	NexviaSDK,
+	FoSDK,
+	RetailExpressSDK,
+	MYOBAcumaticaSDK,
+	SybizSDK,
+	XeroSDK,
+	JobReadySDK,
+	Logger,
+	Metadata,
+	Tags,
+	Trigger,
+	Properties,
+	MiscHelper,
+	ModelHelper,
+	DatasetHelper,
+	S3Client,
+};

package/src/sdk/Xero.js

@@ -0,0 +1,31 @@
+"use strict";
+
+const BaseSDK = require("./Base");
+const UniversalModule = require("./submodules/xero/Universal");
+
+class Xero extends BaseSDK {
+	/**
+	 * Constructor.
+	 * @param {class} auth Auth class object with authorized api instance.
+	 * @param {string} connectionUUID The UUID of the Connection we're working on.
+	 */
+	constructor(auth, connectionUUID, organizationUUID, apiURL, apiVersion, loggerClass = null) {
+		super({
+			auth,
+			connectionUUID,
+			organizationUUID,
+			apiURL,
+			apiVersion,
+			appUUIDKey: "xero",
+			integrationName: "xero",
+			loggerClass,
+		});
+
+		/**
+		 * Create submodule instances.
+		 */
+		this.universal = new UniversalModule(this);
+	}
+}
+
+module.exports = Xero;

package/src/sdk/submodules/xero/Universal.js

@@ -0,0 +1,135 @@
+"use strict";
+
+class UniversalModule {
+	/**
+	 * Constructor.
+	 * @param {class} parentModule Object of Xero class.
+	 */
+	constructor(parentModule) {
+		this.module = parentModule;
+	}
+
+	/**
+	 * Universal Request By URL and Method.
+	 * @param {string} url URL of request.
+	 * @param {string} method Method of request.
+	 * @param {object} header Headers to pass to the block
+	 * @param {object} qs Some available filters inside: offset, limit.
+	 * @param {object} body Some available data inside.
+	 * @returns {object} Universal Request Response.
+	 */
+	async request({ url, method, header = {}, qs = {}, body = {} }) {
+		const validateIsEmpty = this.module.validator.isEmpty({ url, method });
+
+		if (!validateIsEmpty.valid) {
+			return this.module.responseHandler.error(validateIsEmpty.errors);
+		}
+
+		return await this.module.makeRequest(
+			"POST",
+			`${this.module.apiURL}/zintegrations/action/9939030a-2670-4b80-a4fb-6ca030d26043`,
+			{
+				mappable_parameters: {
+					url: {
+						value: url,
+					},
+					method: {
+						value: method,
+					},
+					header: {
+						value: JSON.stringify(header),
+					},
+					qs: {
+						isMap: true,
+						value: JSON.stringify(qs),
+					},
+					body: {
+						isMap: true,
+						value: JSON.stringify(body),
+					},
+				},
+			}
+		);
+	}
+
+	/**
+	 * Universal List By URL and Method.
+	 * @param {string} url URL of listed data.
+	 * @param {string} method Method of listed data.
+	 * @param {object} header Headers to pass to the block
+	 * @param {object} qs Some available filters inside: Page, Limit.
+	 * @param {object} body Some available data inside.
+	 * @returns {object} Universal List Response.
+	 */
+	async list({ url, method, header = {}, qs = {}, body = {} }) {
+		const validateIsEmpty = this.module.validator.isEmpty({ url, method });
+
+		if (!validateIsEmpty.valid) {
+			return this.module.responseHandler.error(validateIsEmpty.errors);
+		}
+
+		if (!qs.page) {
+			qs.page = 1;
+		}
+
+		return await this.request({ url, method, header, qs, body });
+	}
+
+	/**
+	 * Universal Auto Pagination Listing By URL and Method.
+	 * @param {string} url URL of listed data.
+	 * @param {string} method Method of listed data.
+	 * @param {object} header Headers to pass to the block
+	 * @param {object} qs Some available filters inside: Page, Limit.
+	 * @param {object} body Some available data inside.
+	 * @returns {object} Auto Pagination responses.
+	 */
+	async *autoPaginationList({ url, method, header = {}, qs = {}, body = {} }) {
+		if (!qs.page) {
+			qs.page = 1;
+		}
+
+		let response = await this.list({ url, method, header, qs, body });
+		let currentPageCount = response?.data?.length;
+
+		yield response;
+
+		if (currentPageCount && currentPageCount === qs.limit) {
+			while (currentPageCount === qs.limit) {
+				qs.page = qs.page + 1;
+
+				response = await this.list({ url, method, header, qs, body });
+				currentPageCount = response?.data?.length;
+
+				yield response;
+			}
+		}
+	}
+
+	/**
+	 * Upload Attachment
+	 * @param {object} header Headers to pass to the block
+	 * @param {object} qs Some available filters inside: Page, Limit.
+	 * @param {object} body Some available data inside.
+	 * @returns {object} Universal List Response.
+	 */
+	async addAttachment({ header = {}, qs = {}, body = {} }) {
+		return await this.module.makeRequest(
+			"POST",
+			`${this.module.apiURL}/zintegrations/action/2e52bb12-dcee-4011-848c-b1828182fbcf`,
+			{
+				mappable_parameters: {
+					header: {
+						value: JSON.stringify(header),
+					},
+					body: {
+						isMap: true,
+						value: JSON.stringify(body),
+					},
+				},
+			}
+		);
+	}
+}
+
+module.exports = UniversalModule;

package/src/utils/apiInstance.js

@@ -9,6 +9,7 @@ class ApiInstance {
    */
   constructor () {
     this.bearerToken = null
+    this.retryStatuses = [502, 504]
 
     this.responseHandler = new ResponseHandler()
 
@@ -39,7 +40,7 @@ class ApiInstance {
    * @param {object} headers Request Headers.
    * @returns {object} Response Data.
    */
-  async get (url, params, headers, returnHeaders = false, callback = () => {}) {
+  async get (url, params, headers, returnHeaders = false, callback = () => {}, retryCount = 0) {
     try {
       const requestBody = { params, headers }
 
@@ -67,6 +68,11 @@ class ApiInstance {
         headers
       })
 
+      if (this.retryStatuses.includes(error?.response?.status) && retryCount === 0) {
+        await this.sleep(20000)
+        return await this.get(url, params, headers, returnHeaders, callback, retryCount + 1)
+      }
+
       if (error?.response?.status === 302) {
         return this.responseHandler.success(error?.response?.headers?.location)
       }
@@ -93,7 +99,7 @@ class ApiInstance {
    * @param {object} params Request Params.
    * @returns {object} Response Data.
    */
-  async post (url, data, headers, params = {}, callback = () => {}) {
+  async post (url, data, headers, params = {}, callback = () => {}, retryCount = 0) {
     try {
       const response = await this.axiosInstance.post(url, data, { headers, params })
 
@@ -119,6 +125,11 @@ class ApiInstance {
         body: data
       })
 
+      if (this.retryStatuses.includes(error?.response?.status) && retryCount === 0) {
+        await this.sleep(20000)
+        return await this.post(url, data, headers, params, callback, retryCount + 1)
+      }
+
       if (error?.response?.status === 500) {
         return this.responseHandler.error(['Something went wrong.'])
       }
@@ -135,7 +146,7 @@ class ApiInstance {
    * @param {object} data PUT Data.
    * @returns {object} Response Data.
    */
-  async put (url, data, headers, params = {}, callback = () => {}) {
+  async put (url, data, headers, params = {}, callback = () => {}, retryCount = 0) {
     try {
       const response = await this.axiosInstance.put(url, data, { headers, params })
 
@@ -157,6 +168,11 @@ class ApiInstance {
         body: data
       })
 
+      if (this.retryStatuses.includes(error?.response?.status) && retryCount === 0) {
+        await this.sleep(20000)
+        return await this.put(url, data, headers, params, callback, retryCount + 1)
+      }
+
       if (error?.response?.data) {
         return this.responseHandler.error([error?.response?.data])
       }
@@ -170,7 +186,7 @@ class ApiInstance {
    * @param {string} url Request URL.
    * @returns {object} Response Data.
    */
-  async delete (url, callback = () => {}) {
+  async delete (url, callback = () => {}, retryCount = 0) {
     try {
       const response = await this.axiosInstance.delete(url)
 
@@ -186,6 +202,11 @@ class ApiInstance {
         response: error?.response?.data
       })
 
+      if (this.retryStatuses.includes(error?.response?.status) && retryCount === 0) {
+        await this.sleep(20000)
+        return await this.delete(url, callback, retryCount + 1)
+      }
+
       if (error?.response?.data) {
         return this.responseHandler.error([error?.response?.data])
       }
@@ -193,6 +214,10 @@ class ApiInstance {
       return this.responseHandler.error(['Something went wrong.'])
     }
   }
+
+  async sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms))
+  }
 }
 
 module.exports = ApiInstance

package/src/utils/config.js

@@ -1,18 +1,19 @@
-'use strict'
+"use strict";
 
 module.exports = {
-  appUUIDs: {
-    zudello: 'c698c4a5-ee07-44cb-a0e0-a3a1d0e683ec',
-    netsuite: '010d0262-fa01-43eb-9e35-1b49e131c1ba',
-    intacct: 'a8bbbc60-2409-49e8-adfb-72fc79658dd6',
-    bc: 'ee6f62f5-9dda-48aa-bb8d-44c8b8455472',
-    zenoti: '967a0844-6a9d-4979-a298-427259eafad8',
-    dear: '0e456359-fe0d-4b01-9662-08bba1bdce63',
-    nexvia: '5f693545-3be0-4798-bb3b-3af0b7ee2e96',
-    fo: '524e1173-6d73-42ea-9d9c-0c728c6f24ea',
-    retailExpress: '49584664-65a5-4b76-ba62-a73f7b7b3885',
-    myobAcumatica: '8fd5015c-a200-4675-9e03-2047807c5693',
-    sybiz: 'ead57add-301e-4b29-881b-1bc331c101a5',
-    jobready: '14d16371-3e56-40c8-9efa-8578a8f334fc'
-  }
-}
+	appUUIDs: {
+		zudello: "c698c4a5-ee07-44cb-a0e0-a3a1d0e683ec",
+		netsuite: "010d0262-fa01-43eb-9e35-1b49e131c1ba",
+		intacct: "a8bbbc60-2409-49e8-adfb-72fc79658dd6",
+		bc: "ee6f62f5-9dda-48aa-bb8d-44c8b8455472",
+		zenoti: "967a0844-6a9d-4979-a298-427259eafad8",
+		dear: "0e456359-fe0d-4b01-9662-08bba1bdce63",
+		nexvia: "5f693545-3be0-4798-bb3b-3af0b7ee2e96",
+		fo: "524e1173-6d73-42ea-9d9c-0c728c6f24ea",
+		retailExpress: "49584664-65a5-4b76-ba62-a73f7b7b3885",
+		myobAcumatica: "8fd5015c-a200-4675-9e03-2047807c5693",
+		sybiz: "ead57add-301e-4b29-881b-1bc331c101a5",
+		xero: "71648f29-7867-40d8-ac68-651b53cb3c49",
+		jobready: "14d16371-3e56-40c8-9efa-8578a8f334fc",
+	},
+};

package/src/utils/datasetHelper.js

@@ -0,0 +1,81 @@
+'use strict'
+
+const _ = require('lodash')
+
+class DatasetHelper {
+  constructor(zudello, logger, data = null, uuid = null) {
+    this.zudello = zudello
+    this.logger = logger
+
+    this.data = data
+    this.uuid = uuid
+  }
+
+  async load(uuid, failCallback) {
+    failCallback = failCallback || ((data) => this.defaultFailCallback(data))
+
+    this.logger.info('DatasetUUID', uuid)
+
+    return await this.get(uuid, failCallback)
+  }
+
+  async get(uuid, failCallback) {
+    failCallback = failCallback || ((data) => this.defaultFailCallback(data))
+
+    if (!uuid) {
+      return failCallback({ uuid })
+    }
+
+    const fetchedDataset = await this.zudello.search({
+      model: 'DataSetRow',
+      offset: 0,
+      limit: 10000000,
+      select: ['uuid', 'custom'],
+      order_by: ['ordering'],
+      filter: {
+        dataset_uuid: uuid
+      }
+    })
+
+    this.logger.debug('Fetched Dataset', fetchedDataset)
+
+    if (fetchedDataset && fetchedDataset.data) {
+      const data = fetchedDataset.data?.data || null
+
+      if (data) {
+        return new DatasetHelper(this.zudello, this.logger, data, uuid)
+      }
+    }
+
+    return failCallback({ uuid })
+  }
+
+  length() {
+    return this.data ? this.data.length : 0
+  }
+
+  rows(mapping = null, filter = null) {
+    let data = this.data
+
+    if (!data) {
+      return []
+    }
+
+    if (filter) {
+      data = _.filter(data, filter)
+    }
+
+    if (mapping) {
+      data = _.map(data, mapping)
+    }
+
+    return data
+  }
+
+  defaultFailCallback(data) {
+    this.logger.error('Unable to find Dataset', data)
+    throw new Error('Unable to find Dataset')
+  }
+}
+
+module.exports = DatasetHelper