zudello-integration-sdk 1.0.0

package/src/sdk/submodules/zudello/SupplierGroup.js

@@ -0,0 +1,63 @@
+'use strict'
+
+class SupplierGroupModule {
+  /**
+   * Constructor.
+   * @param {class} parentModule Object of ZudelloV3 class.
+   */
+  constructor (parentModule) {
+    this.module = parentModule
+
+    this.staticFields = {
+      model: 'SupplierGroup',
+      module: 'DIMENSIONS',
+      submodule: 'SUPPLIER_GROUP',
+      documentType: 'SUPPLIER_GROUP',
+      enrich: false,
+      extractedEvent: false,
+      update: true,
+      create: true
+    }
+  }
+
+  async fetch ({ uuid, fetchDetails = true, simplified = true }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ uuid })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    return await this.module.fetch({
+      model: this.staticFields.model,
+      uuid,
+      fetchDetails,
+      simplified
+    })
+  }
+
+  async updateOrCreate ({ data, clearNulls = true, simplified = false, submit = false, updateStatus = false }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ data })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    this.module.logger.log(`[UPDATE OR CREATE]: ZudelloV3 [model - ${this.staticFields.model}]`)
+    this.module.logger.log('[PAGE DATA]:')
+    this.module.logger.log(data)
+
+    data = this.module.mapUpdateOrCreateData({
+      data,
+      staticFields: this.staticFields,
+      submit,
+      updateStatus
+    })
+
+    this.module.logger.log('[MAPPED PAGE DATA]:')
+    this.module.logger.log(data)
+
+    return await this.module.updateOrCreate({ data, clearNulls, simplified })
+  }
+}
+
+module.exports = SupplierGroupModule

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

@@ -0,0 +1,31 @@
+'use strict'
+
+class UniversalModule {
+  /**
+   * Constructor.
+   * @param {class} parentModule Object of Zudello 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} qs Some available filters inside: offset, limit.
+   * @param {object} body Some available data inside.
+   * @returns {object} Universal Request Response.
+   */
+  async request ({ url, method, 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(method, `${this.module.apiURL}/${url}`, body, qs)
+  }
+}
+
+module.exports = UniversalModule

package/src/sdk/submodules/zudello/Uom.js

@@ -0,0 +1,63 @@
+'use strict'
+
+class UomModule {
+  /**
+   * Constructor.
+   * @param {class} parentModule Object of ZudelloV3 class.
+   */
+  constructor (parentModule) {
+    this.module = parentModule
+
+    this.staticFields = {
+      model: 'UnitOfMeasure',
+      module: 'DIMENSIONS',
+      submodule: 'UNIT_OF_MEASURE',
+      documentType: 'UNIT_OF_MEASURE',
+      enrich: false,
+      extractedEvent: false,
+      update: true,
+      create: true
+    }
+  }
+
+  async fetch ({ uuid, fetchDetails = true, simplified = true }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ uuid })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    return await this.module.fetch({
+      model: this.staticFields.model,
+      uuid,
+      fetchDetails,
+      simplified
+    })
+  }
+
+  async updateOrCreate ({ data, clearNulls = true, simplified = false, submit = false, updateStatus = false }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ data })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    this.module.logger.log(`[UPDATE OR CREATE]: ZudelloV3 [model - ${this.staticFields.model}]`)
+    this.module.logger.log('[PAGE DATA]:')
+    this.module.logger.log(data)
+
+    data = this.module.mapUpdateOrCreateData({
+      data,
+      staticFields: this.staticFields,
+      submit,
+      updateStatus
+    })
+
+    this.module.logger.log('[MAPPED PAGE DATA]:')
+    this.module.logger.log(data)
+
+    return await this.module.updateOrCreate({ data, clearNulls, simplified })
+  }
+}
+
+module.exports = UomModule

package/src/sdk/submodules/zudello/Warehouse.js

@@ -0,0 +1,63 @@
+'use strict'
+
+class WarehouseModule {
+  /**
+   * Constructor.
+   * @param {class} parentModule Object of ZudelloV3 class.
+   */
+  constructor (parentModule) {
+    this.module = parentModule
+
+    this.staticFields = {
+      model: 'Warehouse',
+      module: 'DIMENSIONS',
+      submodule: 'WAREHOUSE',
+      documentType: 'WAREHOUSE',
+      enrich: false,
+      extractedEvent: false,
+      update: true,
+      create: true
+    }
+  }
+
+  async fetch ({ uuid, fetchDetails = true, simplified = true }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ uuid })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    return await this.module.fetch({
+      model: this.staticFields.model,
+      uuid,
+      fetchDetails,
+      simplified
+    })
+  }
+
+  async updateOrCreate ({ data, clearNulls = true, simplified = false, submit = false, updateStatus = false }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ data })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    this.module.logger.log(`[UPDATE OR CREATE]: ZudelloV3 [model - ${this.staticFields.model}]`)
+    this.module.logger.log('[PAGE DATA]:')
+    this.module.logger.log(data)
+
+    data = this.module.mapUpdateOrCreateData({
+      data,
+      staticFields: this.staticFields,
+      submit,
+      updateStatus
+    })
+
+    this.module.logger.log('[MAPPED PAGE DATA]:')
+    this.module.logger.log(data)
+
+    return await this.module.updateOrCreate({ data, clearNulls, simplified })
+  }
+}
+
+module.exports = WarehouseModule

package/src/sdk/submodules/zudello/Zone.js

@@ -0,0 +1,63 @@
+'use strict'
+
+class ZoneModule {
+  /**
+   * Constructor.
+   * @param {class} parentModule Object of ZudelloV3 class.
+   */
+  constructor (parentModule) {
+    this.module = parentModule
+
+    this.staticFields = {
+      model: 'Zone',
+      module: 'DIMENSIONS',
+      submodule: 'ZONE',
+      documentType: 'ZONE',
+      enrich: false,
+      extractedEvent: false,
+      update: true,
+      create: true
+    }
+  }
+
+  async fetch ({ uuid, fetchDetails = true, simplified = true }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ uuid })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    return await this.module.fetch({
+      model: this.staticFields.model,
+      uuid,
+      fetchDetails,
+      simplified
+    })
+  }
+
+  async updateOrCreate ({ data, clearNulls = true, simplified = false, submit = false, updateStatus = false }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ data })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    this.module.logger.log(`[UPDATE OR CREATE]: ZudelloV3 [model - ${this.staticFields.model}]`)
+    this.module.logger.log('[PAGE DATA]:')
+    this.module.logger.log(data)
+
+    data = this.module.mapUpdateOrCreateData({
+      data,
+      staticFields: this.staticFields,
+      submit,
+      updateStatus
+    })
+
+    this.module.logger.log('[MAPPED PAGE DATA]:')
+    this.module.logger.log(data)
+
+    return await this.module.updateOrCreate({ data, clearNulls, simplified })
+  }
+}
+
+module.exports = ZoneModule

package/src/sdk/submodules/zudello/tax/Rate.js

@@ -0,0 +1,63 @@
+'use strict'
+
+class TaxRateModule {
+  /**
+   * Constructor.
+   * @param {class} parentModule Object of ZudelloV3 class.
+   */
+  constructor (parentModule) {
+    this.module = parentModule
+
+    this.staticFields = {
+      model: 'TaxRate',
+      module: 'DIMENSIONS',
+      submodule: 'TAX_RATE',
+      documentType: 'TAX_RATE',
+      enrich: false,
+      extractedEvent: false,
+      update: true,
+      create: true
+    }
+  }
+
+  async fetch ({ uuid, fetchDetails = true, simplified = true }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ uuid })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    return await this.module.fetch({
+      model: this.staticFields.model,
+      uuid,
+      fetchDetails,
+      simplified
+    })
+  }
+
+  async updateOrCreate ({ data, clearNulls = true, simplified = false, submit = false, updateStatus = false }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ data })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    this.module.logger.log(`[UPDATE OR CREATE]: ZudelloV3 [model - ${this.staticFields.model}]`)
+    this.module.logger.log('[PAGE DATA]:')
+    this.module.logger.log(data)
+
+    data = this.module.mapUpdateOrCreateData({
+      data,
+      staticFields: this.staticFields,
+      submit,
+      updateStatus
+    })
+
+    this.module.logger.log('[MAPPED PAGE DATA]:')
+    this.module.logger.log(data)
+
+    return await this.module.updateOrCreate({ data, clearNulls, simplified })
+  }
+}
+
+module.exports = TaxRateModule

package/src/sdk/submodules/zudello/tax/Solution.js

@@ -0,0 +1,63 @@
+'use strict'
+
+class TaxSolutionModule {
+  /**
+   * Constructor.
+   * @param {class} parentModule Object of ZudelloV3 class.
+   */
+  constructor (parentModule) {
+    this.module = parentModule
+
+    this.staticFields = {
+      model: 'TaxSolution',
+      module: 'DIMENSIONS',
+      submodule: 'TAX_SOLUTION',
+      documentType: 'TAX_SOLUTION',
+      enrich: false,
+      extractedEvent: false,
+      update: true,
+      create: true
+    }
+  }
+
+  async fetch ({ uuid, fetchDetails = true, simplified = true }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ uuid })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    return await this.module.fetch({
+      model: this.staticFields.model,
+      uuid,
+      fetchDetails,
+      simplified
+    })
+  }
+
+  async updateOrCreate ({ data, clearNulls = true, simplified = false, submit = false, updateStatus = false }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ data })
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors)
+    }
+
+    this.module.logger.log(`[UPDATE OR CREATE]: ZudelloV3 [model - ${this.staticFields.model}]`)
+    this.module.logger.log('[PAGE DATA]:')
+    this.module.logger.log(data)
+
+    data = this.module.mapUpdateOrCreateData({
+      data,
+      staticFields: this.staticFields,
+      submit,
+      updateStatus
+    })
+
+    this.module.logger.log('[MAPPED PAGE DATA]:')
+    this.module.logger.log(data)
+
+    return await this.module.updateOrCreate({ data, clearNulls, simplified })
+  }
+}
+
+module.exports = TaxSolutionModule

package/src/utils/apiInstance.js

@@ -0,0 +1,198 @@
+'use strict'
+
+const axios = require('axios')
+const ResponseHandler = require('./responseHandler')
+
+class ApiInstance {
+  /**
+   * Constructor.
+   */
+  constructor () {
+    this.bearerToken = null
+
+    this.responseHandler = new ResponseHandler()
+
+    this.axiosInstance = axios.create()
+    this.axiosInstance.interceptors.request.use((config) => {
+      if (this.bearerToken) {
+        config.headers.Authorization = `Bearer ${this.bearerToken}`
+      }
+
+      return config
+    }, (error) => {
+      return Promise.reject(error)
+    })
+  }
+
+  /**
+   * Setter function for bearer token.
+   * @param {string} bearerToken Bearer Auth Token.
+   */
+  setBearerToken (bearerToken) {
+    this.bearerToken = bearerToken
+  }
+
+  /**
+   * Send axios request (method: GET).
+   * @param {string} url Request URL.
+   * @param {object} params GET Params.
+   * @param {object} headers Request Headers.
+   * @returns {object} Response Data.
+   */
+  async get (url, params, headers, returnHeaders = false, callback = () => {}) {
+    try {
+      const requestBody = { params, headers }
+
+      if (returnHeaders) {
+        requestBody.maxRedirects = 0
+      }
+
+      const response = await this.axiosInstance.get(url, requestBody)
+
+      callback({
+        status: 200,
+        response: returnHeaders ? response.headers : response.data,
+        params,
+        headers
+      })
+
+      return returnHeaders
+        ? this.responseHandler.success(response.headers || null)
+        : this.responseHandler.success(response.data || null)
+    } catch (error) {
+      callback({
+        status: error?.response?.status,
+        response: error?.response?.data,
+        params,
+        headers
+      })
+
+      if (error?.response?.status === 302) {
+        return this.responseHandler.success(error?.response?.headers?.location)
+      }
+
+      if (error?.response?.status === 500) {
+        return this.responseHandler.error(['Something went wrong.'])
+      }
+
+      if (error?.response?.data?.error?.message?.message) {
+        return this.responseHandler.error([error?.response?.data?.error?.message?.message])
+      }
+
+      if (error?.response?.data?.error?.message) {
+        return this.responseHandler.error([error?.response?.data?.error?.message])
+      }
+    }
+  }
+
+  /**
+   * Send axios request (method: POST).
+   * @param {string} url Request URL.
+   * @param {object} data POST Data.
+   * @param {object} headers Request Headers.
+   * @param {object} params Request Params.
+   * @returns {object} Response Data.
+   */
+  async post (url, data, headers, params = {}, callback = () => {}) {
+    try {
+      const response = await this.axiosInstance.post(url, data, { headers, params })
+
+      callback({
+        status: 200,
+        response: response.data,
+        params,
+        headers,
+        body: data
+      })
+
+      if (Object.prototype.hasOwnProperty.call(params, '_debug') && params._debug) {
+        return this.responseHandler.success(response?.data?._resp?.body || null)
+      }
+
+      return this.responseHandler.success(response.data || null)
+    } catch (error) {
+      callback({
+        status: error?.response?.status,
+        response: error?.response?.data,
+        params,
+        headers,
+        body: data
+      })
+
+      if (error?.response?.status === 500) {
+        return this.responseHandler.error(['Something went wrong.'])
+      }
+
+      if (error?.response?.data) {
+        return this.responseHandler.error([error?.response?.data])
+      }
+    }
+  }
+
+  /**
+   * Send axios request (method: PUT).
+   * @param {string} url Request URL.
+   * @param {object} data PUT Data.
+   * @returns {object} Response Data.
+   */
+  async put (url, data, headers, params = {}, callback = () => {}) {
+    try {
+      const response = await this.axiosInstance.put(url, data, { headers, params })
+
+      callback({
+        status: 200,
+        response: response.data,
+        params,
+        headers,
+        body: data
+      })
+
+      return this.responseHandler.success(response.data || null)
+    } catch (error) {
+      callback({
+        status: error?.response?.status,
+        response: error?.response?.data,
+        params,
+        headers,
+        body: data
+      })
+
+      if (error?.response?.data) {
+        return this.responseHandler.error([error?.response?.data])
+      }
+
+      return this.responseHandler.error(['Something went wrong.'])
+    }
+  }
+
+  /**
+   * Send axios request (method: DELETE).
+   * @param {string} url Request URL.
+   * @returns {object} Response Data.
+   */
+  async delete (url, callback = () => {}) {
+    try {
+      const response = await this.axiosInstance.delete(url)
+
+      callback({
+        status: 200,
+        response: response.data
+      })
+
+      return response.data
+    } catch (error) {
+      callback({
+        status: error?.response?.status,
+        response: error?.response?.data
+      })
+
+      if (error?.response?.data) {
+        return this.responseHandler.error([error?.response?.data])
+      }
+
+      return this.responseHandler.error(['Something went wrong.'])
+    }
+  }
+}
+
+module.exports = ApiInstance

package/src/utils/config.js

@@ -0,0 +1,18 @@
+'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'
+  }
+}