zudello-integration-sdk 1.0.85 → 1.0.87

package/package.json

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

package/src/index.js

@@ -49,6 +49,8 @@ const DatasetHelper = require('./utils/datasetHelper')
 const FormHelper = require('./utils/formHelper')
 const ResponseHelper = require('./utils/responseHelper')
 const Context = require('./utils/context')
+const GlobalState = require('./utils/globalState')
+const ResumePayload = require('./utils/resumePayload')
 const {
   getFileContent,
   uploadFile,
@@ -116,5 +118,7 @@ module.exports = {
   FormHelper,
   ResponseHelper,
   Context,
+  GlobalState,
+  ResumePayload,
   S3Client,
 }

package/src/sdk/SFTP.js

@@ -3,7 +3,7 @@
 const BaseSDK = require('./Base')
 const UniversalModule = require('./submodules/sftp/Universal')
 
-class SharepointSDK extends BaseSDK {
+class SFTPSDK extends BaseSDK {
   /**
    * Constructor.
    * @param {string} connectionUUID The UUID of the Connection we're working on.
@@ -22,4 +22,4 @@ class SharepointSDK extends BaseSDK {
   }
 }
 
-module.exports = SharepointSDK
+module.exports = SFTPSDK

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

@@ -93,7 +93,7 @@ class UniversalModule {
 		}
 
 		let response = await this.list({ url, method, header, qs, body });
-		let currentPageCount = response?.data?.length;
+		let currentPageCount = response?.data?.data?.length || 0;
 
 		yield response;
 
@@ -102,7 +102,7 @@ class UniversalModule {
 				qs.page = qs.page + 1;
 
 				response = await this.list({ url, method, header, qs, body });
-				currentPageCount = response?.data?.length;
+				currentPageCount = response?.data?.data?.length || 0;
 
 				yield response;
 			}

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

@@ -77,12 +77,12 @@ class UniversalModule {
   /**
    * Auto-pagination generator using cursor-based pagination (recommended).
    * @param {string} sql Base SQL Query.
-   * @param {object} options Cursor options: { cursorField, limit, orderBy }.
+   * @param {object} options Cursor options: { cursorField, cursorFieldAlias, limit, orderBy }.
    * @param {object} queryParams Query parameters.
    * @returns {AsyncGenerator} Yields cursor-based responses.
    */
   async *autoCursorQuery({ sql, options = {}, queryParams = {} }) {
-    const { cursorField, limit = 100, orderBy } = options;
+    const { cursorField, cursorFieldAlias, limit = 100, orderBy } = options;
 
     let cursorValue = null;
     let hasMoreData = true;
@@ -98,7 +98,8 @@ class UniversalModule {
 
       const records = response?.data || [];
       if (records.length > 0 && cursorField) {
-        cursorValue = records[records.length - 1][cursorField];
+        const fieldToExtract = cursorFieldAlias || cursorField;
+        cursorValue = records[records.length - 1][fieldToExtract];
       }
 
       hasMoreData = records.length === limit;

package/src/utils/config.js

@@ -36,16 +36,22 @@ module.exports = {
     AUTH_API_URL: process.env.AUTH_API_URL,
     ORGANIZATION_UUID: process.env.ORGANIZATION_UUID,
     TEAM_UUID: process.env.TEAM_UUID,
+    TRIGGER_UUID: process.env.TRIGGER_UUID,
     EXECUTION_UUID: process.env.EXECUTION_UUID,
     MODE: process.env.MODE,
-    CONTEXT_DATA: process.env.CONTEXT_DATA,
 
     // GLOBAL ENVS
     ZUDELLO_API_URL: process.env.ZUDELLO_API_URL,
+    PAUSE_PROCESS_EXIT_CODE: process.env.PAUSE_PROCESS_EXIT_CODE,
 
     // AWS ENVS
     AWS_ACCESS_KEY_ID: process.env.AWS_ACCESS_KEY_ID,
     AWS_SECRET_ACCESS_KEY: process.env.AWS_SECRET_ACCESS_KEY,
-    AWS_REGION: process.env.AWS_REGION
+    AWS_REGION: process.env.AWS_REGION,
+    AWS_BUCKET: process.env.AWS_BUCKET,
+
+    CONTEXT_DATA: process.env.CONTEXT_DATA,
+    GLOBAL_STATE: process.env.GLOBAL_STATE,
+    RESUME_PAYLOAD: process.env.RESUME_PAYLOAD,
   }
 }

package/src/utils/globalState.js

@@ -0,0 +1,63 @@
+'use strict'
+
+const ApiInstance = require('./apiInstance')
+const config = require('./config')
+
+class GlobalState {
+  /**
+   * Constructor.
+   */
+  constructor() {
+    this.apiInstance = new ApiInstance()
+
+    this.globalState = {}
+
+    this._synced = false
+
+    this._loadState()
+    this._registerAutoSync()
+  }
+
+  _loadState () {
+    try {
+      this.globalState = JSON.parse(config.envs.GLOBAL_STATE || '{}')
+    } catch (err) {
+      this.globalState = {}
+    }
+  }
+
+  _registerAutoSync () {
+    const syncOnExit = async () => {
+      if (this._synced) {
+        return
+      }
+
+      try {
+        await this.sync()
+        this._synced = true
+      } catch (err) {
+        console.error('Failed to sync global state on exit:', err)
+      }
+    }
+
+    process.on('beforeExit', syncOnExit)
+  }
+
+  pause () {
+    process.exitCode = config.envs.PAUSE_PROCESS_EXIT_CODE
+  }
+
+  async sync () {
+    if (this._synced) {
+      return
+    }
+
+    return await this.apiInstance.post(`${config.envs.ZUDELLO_API_URL}/execution/state/${config.envs.EXECUTION_UUID}`, {
+      global_state: this.globalState
+    }, {
+      'x-team': config.envs.TEAM_UUID
+    })
+  }
+}
+
+module.exports = GlobalState

package/src/utils/logger.js

@@ -1,6 +1,8 @@
 'use strict'
 
 const config = require('./config')
+const GlobalState = require('./globalState')
+const { appendJsonArray } = require('./s3Client')
 
 class Logger {
   /**
@@ -10,6 +12,26 @@ class Logger {
     this.mode = config.envs.MODE || 'PRODUCTION'
     this.productionMode = 'PRODUCTION'
     this.logs = []
+    this._synced = false
+
+    this._registerAutoSync()
+  }
+
+  _registerAutoSync() {
+    const syncOnExit = async () => {
+      if (this._synced) {
+        return
+      }
+
+      try {
+        await this.sync()
+        this._synced = true
+      } catch (err) {
+        console.error('Failed to sync logs on exit:', err)
+      }
+    }
+
+    process.on('beforeExit', syncOnExit)
   }
 
   /**
@@ -127,6 +149,15 @@ class Logger {
   setLogs(logs = []) {
     this.logs = logs
   }
+
+  async sync() {
+    if (this._synced) {
+      return
+    }
+
+    const globalStateClass = new GlobalState()
+    await appendJsonArray(config.envs.AWS_BUCKET, globalStateClass.globalState.logFilePath, this.getLogs())
+  }
 }
 
 module.exports = Logger

package/src/utils/metadata.js

@@ -1,5 +1,8 @@
 'use strict'
 
+const ApiInstance = require('./apiInstance')
+const config = require('./config')
+
 /**
  * Metadata class to handle operations on metadata and global metadata.
  * This class provides methods to get, set, and delete metadata properties.
@@ -11,9 +14,34 @@ class Metadata {
    * @param {Array} metadata - Array of metadata objects (each object should have `property` and `value`).
    * @param {Array} globalMetadata - Array of global metadata objects (each object should have `property` and `value`).
    */
-  constructor(metadata = [], globalMetadata = []) {
+  constructor(connectionUUID = null, metadata = [], globalMetadata = []) {
+    this.apiInstance = new ApiInstance()
+
+    this.connectionUUID = connectionUUID
+
     this.metadata = metadata
     this.globalMetadata = globalMetadata
+
+    this._synced = false
+
+    this._registerAutoSync()
+  }
+
+  _registerAutoSync() {
+    const syncOnExit = async () => {
+      if (this._synced) {
+        return
+      }
+
+      try {
+        await this.sync()
+        this._synced = true
+      } catch (err) {
+        console.error('Failed to sync metadata on exit:', err)
+      }
+    }
+
+    process.on('beforeExit', syncOnExit)
   }
 
   /**
@@ -108,6 +136,21 @@ class Metadata {
       this.metadata = this.metadata.filter(obj => obj.property !== key)
     }
   }
+
+  async sync() {
+    if (this._synced) {
+      return
+    }
+
+    return await this.apiInstance.post(`${config.envs.ZUDELLO_API_URL}/trigger/metadata/sync`, {
+      metas: this.getAll(),
+      connection_uuid: this.connectionUUID,
+      trigger_uuid: config.envs.TRIGGER_UUID,
+      team_uuid: config.envs.TEAM_UUID
+    }, {
+      'x-team': config.envs.TEAM_UUID
+    })
+  }
 }
 
 module.exports = Metadata

package/src/utils/resumePayload.js

@@ -0,0 +1,15 @@
+'use strict'
+
+const config = require('./config')
+
+class ResumePayload {
+  static load () {
+    try {
+      return JSON.parse(config.envs.RESUME_PAYLOAD || '{}')
+    } catch (err) {
+      return {}
+    }
+  }
+}
+
+module.exports = ResumePayload

package/src/utils/tags.js

@@ -1,5 +1,8 @@
 'use strict'
 
+const config = require('./config')
+const ApiInstance = require('./apiInstance')
+
 /**
  * Class representing a collection of tags.
  */
@@ -10,6 +13,27 @@ class Tags {
    */
   constructor(tags = []) {
     this.tags = tags
+    this.apiInstance = new ApiInstance()
+    this._synced = false
+
+    this._registerAutoSync()
+  }
+
+  _registerAutoSync() {
+    const syncOnExit = async () => {
+      if (this._synced) {
+        return
+      }
+
+      try {
+        await this.sync()
+        this._synced = true
+      } catch (err) {
+        console.error('Failed to sync tags on exit:', err)
+      }
+    }
+
+    process.on('beforeExit', syncOnExit)
   }
 
   /**
@@ -35,6 +59,18 @@ class Tags {
   setAll(tags = []) {
     this.tags = tags
   }
+
+  async sync() {
+    if (this._synced) {
+      return
+    }
+
+    return await this.apiInstance.post(`${config.envs.ZUDELLO_API_URL}/execution/tags/${config.envs.EXECUTION_UUID}`, {
+      tags: this.getAll()
+    }, {
+      'x-team': config.envs.TEAM_UUID
+    })
+  }
 }
 
 module.exports = Tags