nets-service-sdk 1.1.15 → 1.1.17

package/dist/index.js

@@ -12,16 +12,15 @@ var require_utils_helper = __commonJS({
       return String(num).padStart(totalLength, "0");
     };
     module2.exports.xorCalculation = (value) => {
-      const splitted_arr = value.match(/[\w]{2}/g);
-      let response = "";
-      _.map(splitted_arr, (value2, i) => {
-        if (i == 0) {
-          response = value2;
-        } else {
-          response = xor(response, value2);
-        }
-      });
-      return response.toUpperCase();
+      if (!value) return "00";
+      const splitted_arr = value.match(/[0-9A-Fa-f]{2}/g);
+      if (!splitted_arr) return "00";
+      let res = Buffer.from(splitted_arr[0], "hex");
+      for (let i = 1; i < splitted_arr.length; i++) {
+        const nextByte = Buffer.from(splitted_arr[i], "hex");
+        res[0] ^= nextByte[0];
+      }
+      return res.toString("hex").toUpperCase();
     };
     String.prototype.toHexString = function() {
       var res = [];
@@ -32,12 +31,6 @@ var require_utils_helper = __commonJS({
       }
       return res.join("").toUpperCase();
     };
-    function xor(hex1, hex2) {
-      const buf1 = Buffer.from(hex1, "hex");
-      const buf2 = Buffer.from(hex2, "hex");
-      const bufResult = buf1.map((b, i) => b ^ buf2[i]);
-      return bufResult.toString("hex");
-    }
     String.prototype.toAsciiString = function() {
       return this.match(/.{1,2}/g).map(function(v) {
         return String.fromCharCode(parseInt(v, 16));
@@ -190,7 +183,22 @@ var require_queue = __commonJS({
 var require_sendMessage = __commonJS({
   "src/sendMessage.js"(exports2, module2) {
     var logger = require_winston()(module2);
+    var path = require("path");
+    var fs = require("fs");
+    var sdkVersion = "unknown";
+    try {
+      const pkgPath = path.resolve(__dirname, "../package.json");
+      if (fs.existsSync(pkgPath)) {
+        const pkg2 = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        sdkVersion = pkg2.version;
+      }
+    } catch (err) {
+      logger.error({ level: "error", message: `Error reading SDK package.json: ${err.message}` });
+    }
     module2.exports.sendMessage = (room = "clientRoom", tag, msg) => {
+      if (typeof msg === "object" && msg !== null) {
+        msg.sdkVersion = sdkVersion;
+      }
       logger.log({
         level: "info",
         message: JSON.stringify(msg)
@@ -353,6 +361,40 @@ var require_httpRequest = __commonJS({
 var require_parser = __commonJS({
   "src/payment/parser.js"(exports2, module2) {
     var logger = require_winston()(module2);
+    var RESPONSE_CODES = {
+      "00": { status: "APPROVED", detail: "SUCCESS", category: "SUCCESS" },
+      "04": { status: "DECLINED", detail: "PICKUP_CARD", category: "HARD_FAIL" },
+      "05": { status: "DECLINED", detail: "DO_NOT_HONOUR", category: "HARD_FAIL" },
+      "07": { status: "DECLINED", detail: "PICKUP_CARD_SPECIAL", category: "HARD_FAIL" },
+      "12": { status: "DECLINED", detail: "INVALID_TRANSACTION", category: "HARD_FAIL" },
+      "13": { status: "DECLINED", detail: "INVALID_AMOUNT", category: "HARD_FAIL" },
+      "14": { status: "DECLINED", detail: "INVALID_CARD", category: "HARD_FAIL" },
+      "30": { status: "DECLINED", detail: "FORMAT_ERROR", category: "HARD_FAIL" },
+      "41": { status: "DECLINED", detail: "LOST_CARD", category: "HARD_FAIL" },
+      "43": { status: "DECLINED", detail: "STOLEN_CARD", category: "HARD_FAIL" },
+      "51": { status: "DECLINED", detail: "INSUFFICIENT_FUNDS", category: "HARD_FAIL" },
+      "54": { status: "DECLINED", detail: "EXPIRED_CARD", category: "HARD_FAIL" },
+      "55": { status: "DECLINED", detail: "WRONG_PIN", category: "HARD_FAIL" },
+      "57": { status: "DECLINED", detail: "NOT_PERMITTED", category: "HARD_FAIL" },
+      "58": { status: "DECLINED", detail: "TERMINAL_NOT_ALLOWED", category: "HARD_FAIL" },
+      "61": { status: "DECLINED", detail: "LIMIT_EXCEEDED", category: "HARD_FAIL" },
+      "62": { status: "DECLINED", detail: "RESTRICTED_CARD", category: "HARD_FAIL" },
+      "63": { status: "DECLINED", detail: "SECURITY_ISSUE", category: "HARD_FAIL" },
+      "65": { status: "DECLINED", detail: "FREQUENCY_LIMIT", category: "HARD_FAIL" },
+      "68": { status: "RETRY", detail: "RESPONSE_RECEIVED_TOO_LATE", category: "RETRY" },
+      "75": { status: "DECLINED", detail: "PIN_LOCKED", category: "HARD_FAIL" },
+      "91": { status: "RETRY", detail: "ISSUER_UNAVAILABLE", category: "RETRY" },
+      "96": { status: "DECLINED", detail: "SYSTEM_ERROR", category: "HARD_FAIL" },
+      "TO": { status: "TIME_OUT", detail: "TIMEOUT", category: "RETRY" },
+      "CE": { status: "RETRY", detail: "COMMUNICATION_ERROR", category: "RETRY" },
+      "PE": { status: "DECLINED", detail: "PROTOCOL_ERROR", category: "HARD_FAIL" },
+      "NA": { status: "RETRY", detail: "NO_ACKNOWLEDGEMENT", category: "RETRY" },
+      "US": { status: "USER_CANCELLED", detail: "USER_CANCELLED", category: "HARD_FAIL" },
+      "GX": { status: "OUT_OF_PAPER", detail: "OUT_OF_PAPER", category: "HARD_FAIL" }
+    };
+    function getResponseFromCode(code) {
+      return RESPONSE_CODES[code] || null;
+    }
     module2.exports.statusParser = (hexCode, ecn) => {
       const splitted = hexCode.split("1C");
       for (let i = 0; i < splitted.length; i++) {
@@ -377,11 +419,11 @@ var require_parser = __commonJS({
           } else {
             const subStringArray = ascii.splitAtIndex(2);
             if (subStringArray.length > 0) {
-              if (subStringArray.length > 2 && subStringArray[0] == "02" && subStringArray[0]?.indexOf("APPROVED") > -1) {
+              if (subStringArray.length > 1 && subStringArray[0].cleanUp() == "02" && subStringArray[1].cleanUp()?.indexOf("APPROVED") > -1) {
                 status = true;
               }
               const identifier = subStringArray[0].cleanUp();
-              const value = subStringArray[1].cleanUp();
+              const value = subStringArray[1]?.cleanUp();
               if (identifier && value) {
                 json[identifier] = value;
               }
@@ -465,6 +507,7 @@ var require_parser = __commonJS({
           if (statusResponse) {
             translatedJson.status = statusResponse.status;
             translatedJson.description = statusResponse.detail;
+            translatedJson.category = statusResponse.category;
             if (statusResponse.balance) {
               translatedJson["balance"] = statusResponse.balance;
             }
@@ -473,6 +516,7 @@ var require_parser = __commonJS({
           if (ecnnError) {
             translatedJson.status = ecnnError.status;
             translatedJson.description = ecnnError.detail;
+            translatedJson.category = ecnnError.category;
           }
           translatedJson["responsetext"] = obj[key];
         }
@@ -553,6 +597,12 @@ var require_parser = __commonJS({
         }
         if (key == "HC") {
           translatedJson["hostResponseCode"] = obj[key];
+          const mapped = getResponseFromCode(obj[key]);
+          if (mapped) {
+            translatedJson.status = mapped.status;
+            translatedJson.description = mapped.detail;
+            translatedJson.category = mapped.category;
+          }
         }
         if (key == "HD") {
           translatedJson["enhancedECRReferenceNumber"] = obj[key];
@@ -598,8 +648,19 @@ var require_parser = __commonJS({
       return { translated: translatedJson, raw: obj };
     };
     function statusCheck(data) {
+      if (!data) return null;
+      const code = data.substring(0, 2);
+      const mapped = getResponseFromCode(code);
+      if (mapped) {
+        const result = { ...mapped };
+        if (code === "00" && data.indexOf("BAL:") > -1) {
+          const balance = data.split("BAL:");
+          result.balance = balance[1].trim();
+        }
+        return result;
+      }
       if (data?.indexOf("APPROVED") > -1) {
-        const response = { status: "APPROVED", detail: "Payment Succeed" };
+        const response = { status: "APPROVED", detail: "Payment Succeed", category: "SUCCESS" };
         if (data?.indexOf("BAL:") > -1) {
           const balance = data.split("BAL:");
           response.balance = balance[1].trim();
@@ -607,28 +668,25 @@ var require_parser = __commonJS({
         return response;
       }
       if (data?.indexOf("INVALID CARD") > -1) {
-        return { status: "INVALID_CARD", detail: "Invalid Card" };
+        return { status: "INVALID_CARD", detail: "Invalid Card", category: "HARD_FAIL" };
       }
       if (data?.indexOf("F3905-Parameter") > -1) {
-        return { status: "INVALID_CARD", detail: "Invalid Card" };
+        return { status: "INVALID_CARD", detail: "Invalid Card", category: "HARD_FAIL" };
       }
       if (data?.indexOf("DECLINED") > -1) {
-        return { status: "DECLINED", detail: "Transaction Declined" };
+        return { status: "DECLINED", detail: "Transaction Declined", category: "HARD_FAIL" };
       }
       if (data?.indexOf("CARD NOT SUPPORTED") > -1) {
-        return { status: "CARD_NOT_SUPPORTED", detail: "Card not supported" };
+        return { status: "CARD_NOT_SUPPORTED", detail: "Card not supported", category: "HARD_FAIL" };
       }
       return null;
     }
     function CheckECNERROR(data) {
-      if (data?.indexOf("US") > -1) {
-        return { status: "USER_CANCELLED", detail: "User Cancelled" };
-      }
-      if (data?.indexOf("GX") > -1) {
-        return { status: "OUT_OF_PAPER", detail: "Out of Paper" };
-      }
-      if (data?.indexOf("TO") > -1) {
-        return { status: "TIME_OUT", detail: "Time Out" };
+      if (!data) return null;
+      for (const code of ["US", "GX", "TO"]) {
+        if (data.indexOf(code) > -1) {
+          return getResponseFromCode(code);
+        }
       }
       return null;
     }
@@ -770,7 +828,7 @@ var require_responseHandler = __commonJS({
         activePaymentEcn = null;
       }
       if (response.translated) {
-        if (response.translated.status == "APPROVED") {
+        if (response.translated.category == "SUCCESS" || response.translated.status == "APPROVED") {
           sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
             success: true,
             status: "SUCCESS",
@@ -778,15 +836,13 @@ var require_responseHandler = __commonJS({
             action: "COMPLETED"
           });
           sendPaymentResponseToCloud(response.translated);
-        }
-        if (response.translated.status == "TIME_OUT") {
+        } else if (response.translated.category == "RETRY" || response.translated.status == "TIME_OUT") {
           sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
             status: "RETRY",
             response,
             action: "RETRY"
           });
-        }
-        if (response.translated.status == "USER_CANCELLED" || response.translated.status == "OUT_OF_PAPER" || response.translated.status == "INVALID_CARD" || response.translated.status == "DECLINED" || response.translated.status == "CARD_NOT_SUPPORTED") {
+        } else {
           sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
             status: "CANCELLED",
             response,
@@ -803,7 +859,7 @@ var require_responseHandler = __commonJS({
         activePaymentEcn = null;
       }
       if (response.translated) {
-        if (response.translated.status == "APPROVED") {
+        if (response.translated.category == "SUCCESS" || response.translated.status == "APPROVED") {
           sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
             success: true,
             status: "SUCCESS",
@@ -811,15 +867,13 @@ var require_responseHandler = __commonJS({
             action: "COMPLETED"
           });
           sendPaymentResponseToCloud(response.translated);
-        }
-        if (response.translated.status == "TIME_OUT") {
+        } else if (response.translated.category == "RETRY" || response.translated.status == "TIME_OUT") {
           sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
             status: "RETRY",
             response,
             action: "RETRY"
           });
-        }
-        if (response.translated.status == "USER_CANCELLED" || response.translated.status == "OUT_OF_PAPER" || response.translated.status == "INVALID_CARD" || response.translated.status == "DECLINED" || response.translated.status == "CARD_NOT_SUPPORTED") {
+        } else {
           sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
             status: "CANCELLED",
             response,
@@ -852,9 +906,17 @@ var require_responseHandler = __commonJS({
       if (!hexValue || hexValue.length < 4) return false;
       const value = hexValue.substring(2, hexValue.length - 2);
       const xor = xorCalculation(value).toUpperCase();
-      const lrcCheck = hexValue.substring(hexValue.length - 2, hexValue.length).toUpperCase();
-      logger.info({ level: "info", message: `LRC Check: Calculated ${xor} vs Received ${lrcCheck}` });
-      return xor === lrcCheck;
+      const lrcReceived = hexValue.substring(hexValue.length - 2, hexValue.length).toUpperCase();
+      const isMatch = xor === lrcReceived;
+      if (!isMatch) {
+        logger.error({
+          level: "error",
+          message: `LRC Mismatch! Calculated: ${xor}, Received: ${lrcReceived}. Checked range (hex): ${value.substring(0, 20)}...${value.substring(value.length - 10)}`
+        });
+      } else {
+        logger.info({ level: "info", message: `LRC Correct: ${xor}` });
+      }
+      return isMatch;
     };
   }
 });
@@ -1022,7 +1084,7 @@ var require_communication = __commonJS({
     };
     module2.exports.processIncomingData = () => {
       while (dataBuffer.length > 0) {
-        if (dataBuffer[0] === 6 || dataBuffer[0] === 21) {
+        if ((dataBuffer[0] === 6 || dataBuffer[0] === 21) && (dataBuffer.length === 1 || dataBuffer[1] !== 2)) {
           const byte = dataBuffer[0];
           ackOrNack = Buffer.from([byte]);
           dataBuffer = dataBuffer.slice(1);
@@ -1057,10 +1119,26 @@ var require_communication = __commonJS({
           }
         }
         if (dataBuffer.length < 3) break;
-        const lenBytes = dataBuffer.slice(1, 3).toString("hex");
-        const bodyLen = parseInt(lenBytes, 10);
-        const expectedFrameSize = 1 + 2 + bodyLen + 2;
-        if (dataBuffer.length < expectedFrameSize) break;
+        const bcdLenStr = dataBuffer.slice(1, 3).toString("hex");
+        const bcdLen = parseInt(bcdLenStr, 10);
+        const binLen = dataBuffer.readUInt16BE(1);
+        let bodyLen = bcdLen;
+        let expectedFrameSize = 1 + 2 + bodyLen + 2;
+        if (dataBuffer.length >= expectedFrameSize && dataBuffer[3 + bodyLen] === 3) {
+        } else if (dataBuffer.length >= 1 + 2 + binLen + 2 && dataBuffer[3 + binLen] === 3) {
+          bodyLen = binLen;
+          expectedFrameSize = 1 + 2 + bodyLen + 2;
+        }
+        if (dataBuffer.length < expectedFrameSize) {
+          const etxIndex = dataBuffer.indexOf(3, 3);
+          if (etxIndex !== -1 && dataBuffer.length > etxIndex + 1) {
+            const frame = dataBuffer.slice(0, etxIndex + 2);
+            dataBuffer = dataBuffer.slice(etxIndex + 2);
+            exports2.handleFullMessage(frame);
+            continue;
+          }
+          break;
+        }
         if (dataBuffer[3 + bodyLen] === 3) {
           const frame = dataBuffer.slice(0, expectedFrameSize);
           dataBuffer = dataBuffer.slice(expectedFrameSize);
@@ -1205,6 +1283,56 @@ var require_communication = __commonJS({
   }
 });
 
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "nets-service-sdk",
+      version: "1.1.17",
+      description: "Utility functions for Nets Service",
+      source: "src/index.js",
+      main: "dist/index.js",
+      module: "dist/index.module.js",
+      unpkg: "dist/index.umd.js",
+      scripts: {
+        build: "esbuild src/index.js --bundle --platform=node --packages=external --outfile=dist/index.js",
+        watch: "microbundle watch",
+        test: 'echo "Error: no test specified" && exit 1'
+      },
+      keywords: [
+        "nets",
+        "payment",
+        "terminal",
+        "pos",
+        "sqlite",
+        "transaction",
+        "serial",
+        "payment-gateway"
+      ],
+      author: "dineshhv",
+      license: "ISC",
+      files: [
+        "dist"
+      ],
+      dependencies: {
+        "better-sqlite3": "^12.5.0",
+        "dollars-to-cents": "^1.0.3",
+        lodash: "^4.17.21",
+        moment: "^2.29.4",
+        "node-cron": "^4.2.1",
+        request: "^2.88.2",
+        serialport: "^10.5.0",
+        "socket.io-client": "^4.7.2",
+        winston: "^3.8.2"
+      },
+      devDependencies: {
+        esbuild: "^0.27.0",
+        microbundle: "^0.15.1"
+      }
+    };
+  }
+});
+
 // src/index.js
 var utilsHelper = require_utils_helper();
 var winston = require_winston();
@@ -1216,7 +1344,9 @@ var hexRequest = require_hexRequest();
 var httpRequest = require_httpRequest();
 var parser = require_parser();
 var responseHandler = require_responseHandler();
+var pkg = require_package();
 module.exports = {
+  version: pkg.version,
   ...utilsHelper,
   logger: winston,
   manageConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nets-service-sdk",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "description": "Utility functions for Nets Service",
   "source": "src/index.js",
   "main": "dist/index.js",