zudello-integration-sdk 1.0.72 → 1.0.74

package/package.json

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

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

@@ -1,12 +1,12 @@
-'use strict'
+"use strict";
 
 class UniversalModule {
   /**
    * Constructor.
    * @param {class} parentModule Object of MSSQL class.
    */
-  constructor (parentModule) {
-    this.module = parentModule
+  constructor(parentModule) {
+    this.module = parentModule;
   }
 
   /**
@@ -15,27 +15,92 @@ class UniversalModule {
    * @param {string} queryParams Query .
    * @returns {object} Universal Request Response.
    */
-  async query ({ sql, queryParams = {} }) {
-    const validateIsEmpty = this.module.validator.isEmpty({ sql })
+  async query({ sql, queryParams = {} }) {
+    const validateIsEmpty = this.module.validator.isEmpty({ sql });
 
     if (!validateIsEmpty.valid) {
-      return this.module.responseHandler.error(validateIsEmpty.errors)
+      return this.module.responseHandler.error(validateIsEmpty.errors);
     }
 
     const mappableParams = {
       sql: {
-        value: path
+        value: sql,
       },
       queryParams: {
         isMap: true,
-        value: JSON.stringify(queryParams)
+        value: JSON.stringify(queryParams),
+      },
+    };
+
+    return await this.module.makeRequest(
+      "POST",
+      `${this.module.apiURL}/zintegrations/action/d133d755-a201-4e43-8ac1-2f124074e357`,
+      {
+        mappable_parameters: mappableParams,
       }
+    );
+  }
+
+  /**
+   * Execute cursor-based paginated query (recommended for large datasets).
+   * @param {string} sql Base SQL Query with WHERE clause.
+   * @param {object} options Cursor options: { cursorField, cursorValue, limit, orderBy }.
+   * @param {object} queryParams Query parameters.
+   * @returns {object} Cursor-based query response.
+   */
+  async cursorQuery({ sql, options = {}, queryParams = {} }) {
+    const { cursorField, cursorValue, limit = 100, orderBy } = options;
+
+    const validateIsEmpty = this.module.validator.isEmpty({ sql, cursorField });
+
+    if (!validateIsEmpty.valid) {
+      return this.module.responseHandler.error(validateIsEmpty.errors);
+    }
+
+    let cursorSql = sql;
+
+    if (cursorField && cursorValue) {
+      const whereClause = sql.toLowerCase().includes("where") ? "AND" : "WHERE";
+      cursorSql += ` ${whereClause} ${cursorField} > '${cursorValue}'`;
     }
 
-    return await this.module.makeRequest('POST', `${this.module.apiURL}/zintegrations/action/d133d755-a201-4e43-8ac1-2f124074e357`, {
-      mappable_parameters: mappableParams
-    })
+    if (orderBy) cursorSql += ` ORDER BY ${orderBy}`;
+
+    cursorSql = cursorSql.replace(/^SELECT/i, `SELECT TOP ${limit}`);
+
+    return await this.query({ sql: cursorSql, queryParams });
+  }
+
+  /**
+   * Auto-pagination generator using cursor-based pagination (recommended).
+   * @param {string} sql Base SQL Query.
+   * @param {object} options Cursor options: { cursorField, limit, orderBy }.
+   * @param {object} queryParams Query parameters.
+   * @returns {AsyncGenerator} Yields cursor-based responses.
+   */
+  async *autoCursorQuery({ sql, options = {}, queryParams = {} }) {
+    const { cursorField, limit = 100, orderBy } = options;
+
+    let cursorValue = null;
+    let hasMoreData = true;
+
+    while (hasMoreData) {
+      const response = await this.cursorQuery({
+        sql,
+        options: { cursorField, cursorValue, limit, orderBy },
+        queryParams,
+      });
+
+      yield response;
+
+      const records = response?.data?.recordset || [];
+      if (records.length > 0 && cursorField) {
+        cursorValue = records[records.length - 1][cursorField];
+      }
+
+      hasMoreData = records.length === limit;
+    }
   }
 }
 
-module.exports = UniversalModule
+module.exports = UniversalModule;