nets-service-sdk 1.1.14 → 1.1.16

package/dist/index.js

@@ -6,7 +6,6 @@ var __commonJS = (cb, mod) => function __require() {
 // src/utils.helper.js
 var require_utils_helper = __commonJS({
   "src/utils.helper.js"(exports2, module2) {
-    var { SerialPort } = require("serialport");
     var crypto = require("crypto");
     var _ = require("lodash");
     module2.exports.padWithLeadingZeros = (num, totalLength) => {
@@ -53,34 +52,6 @@ var require_utils_helper = __commonJS({
         ""
       ).trim();
     };
-    SerialPort.prototype._disconnected = function(err) {
-      this.paused = true;
-      this.emit("disconnect", err);
-      if (this.closing) {
-        return;
-      }
-      if (this.fd === null) {
-        return;
-      }
-      this.closing = true;
-      if (process.platform !== "win32") {
-        this.readable = false;
-        if (this.serialPoller) {
-          this.serialPoller.close();
-        }
-      }
-      SerialPortBinding.close(
-        this.fd,
-        function(err2) {
-          this.closing = false;
-          if (err2) {
-            debug("Disconnect close completed with error: ", err2);
-          }
-          this.fd = null;
-          this.emit("close");
-        }.bind(this)
-      );
-    };
     module2.exports.generateServiceKey = (payload) => {
       const key = `${process.env.user}:${process.env.password}`;
       const algorithm = "aes256";
@@ -382,6 +353,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++) {
@@ -406,11 +411,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;
               }
@@ -494,6 +499,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;
             }
@@ -502,6 +508,7 @@ var require_parser = __commonJS({
           if (ecnnError) {
             translatedJson.status = ecnnError.status;
             translatedJson.description = ecnnError.detail;
+            translatedJson.category = ecnnError.category;
           }
           translatedJson["responsetext"] = obj[key];
         }
@@ -582,6 +589,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];
@@ -627,8 +640,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();
@@ -636,28 +660,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;
     }
@@ -799,7 +820,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",
@@ -807,15 +828,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,
@@ -832,7 +851,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",
@@ -840,15 +859,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,
@@ -950,6 +967,10 @@ var require_communication = __commonJS({
             });
             resendData();
           } else {
+            logger.log({
+              level: "warn",
+              message: `On ACK/NACK Listener: Terminal did not respond with ACK/NACK after max ${count} retries. Sending TERMINAL_ERROR to client.`
+            });
             sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
               success: true,
               action: "TERMINAL_ERROR"
@@ -1018,20 +1039,6 @@ var require_communication = __commonJS({
             });
             global.port.on("data", (data) => {
               logger.log({ level: "info", message: `Raw data: ${data.toString("hex")}` });
-              if (data.length == 1) {
-                console.log(data);
-                if (data[0] === 6 || data[0] === 6 || data[0] === 21 || data[0] === 21) {
-                  const byte = data[0];
-                  ackOrNack = Buffer.from([byte]);
-                  data = data.slice(1);
-                  logger.log({ level: "info", message: `Terminal sent ${byte === 6 ? "ACK" : "NACK"} (0x${byte.toString(16)})` });
-                  if (byte === 21 || byte === 21) {
-                    count--;
-                    if (count >= 0) resendData();
-                    else sendMessage2("clientRoom", "PAYMENT_MESSAGE", { success: true, action: "TERMINAL_ERROR" });
-                  }
-                }
-              }
               dataBuffer = Buffer.concat([dataBuffer, data]);
               exports2.processIncomingData();
             });
@@ -1060,17 +1067,42 @@ var require_communication = __commonJS({
       }
     };
     module2.exports.processIncomingData = () => {
-      while (dataBuffer.length >= 3) {
-        const stxIndex = dataBuffer.indexOf(2);
-        if (stxIndex === -1) {
-          dataBuffer = Buffer.alloc(0);
-          break;
+      while (dataBuffer.length > 0) {
+        if (dataBuffer[0] === 6 || dataBuffer[0] === 21) {
+          const byte = dataBuffer[0];
+          ackOrNack = Buffer.from([byte]);
+          dataBuffer = dataBuffer.slice(1);
+          logger.log({ level: "info", message: `Terminal sent ${byte === 6 ? "ACK" : "NACK"} (0x${byte.toString(16).padStart(2, "0")})` });
+          if (ackTimeout) {
+            clearTimeout(ackTimeout);
+            ackTimeout = null;
+          }
+          if (byte === 21) {
+            count--;
+            if (count >= 0) {
+              logger.log({ level: "info", message: `Terminal NACK received, retrying ${requestType}...` });
+              resendData();
+            } else {
+              logger.log({
+                level: "error",
+                message: `Terminal responded with NACK multiple times. Max retries reached. Sending TERMINAL_ERROR.`
+              });
+              sendMessage2("clientRoom", "PAYMENT_MESSAGE", { success: true, action: "TERMINAL_ERROR" });
+            }
+          }
+          continue;
         }
-        if (stxIndex > 0) {
-          dataBuffer = dataBuffer.slice(stxIndex);
+        if (dataBuffer[0] !== 2) {
+          const nextStart = dataBuffer.slice(1).findIndex((b) => b === 2 || b === 6 || b === 21);
+          if (nextStart === -1) {
+            dataBuffer = Buffer.alloc(0);
+            break;
+          } else {
+            dataBuffer = dataBuffer.slice(nextStart + 1);
+            continue;
+          }
         }
         if (dataBuffer.length < 3) break;
-        if (dataBuffer.length < 3) break;
         const lenBytes = dataBuffer.slice(1, 3).toString("hex");
         const bodyLen = parseInt(lenBytes, 10);
         const expectedFrameSize = 1 + 2 + bodyLen + 2;
@@ -1086,7 +1118,10 @@ var require_communication = __commonJS({
             dataBuffer = dataBuffer.slice(etxIndex + 2);
             exports2.handleFullMessage(frame);
           } else {
-            if (dataBuffer.length > 1024) dataBuffer = Buffer.alloc(0);
+            if (dataBuffer.length > 2048) {
+              logger.log({ level: "warn", message: "Stale data in buffer exceeds limit, clearing." });
+              dataBuffer = Buffer.alloc(0);
+            }
             break;
           }
         }
@@ -1119,9 +1154,51 @@ var require_communication = __commonJS({
         global.port.write(NACK);
       }
     };
-    module2.exports.sentToTerminal = (type, body) => {
+    module2.exports.checkPortConnection = async () => {
+      const portPath = config.simulation ? config.simulationPort : config.com;
+      try {
+        const ports = await SerialPort.list();
+        const availablePorts = ports.map((p) => p.path);
+        if (!availablePorts.includes(portPath)) {
+          logger.error({
+            level: "error",
+            message: `\u274C Port ${portPath} is NOT connected to the system.`
+          });
+          return { success: false, error: "PORT_DISCONNECTED" };
+        }
+        if (!global.port || !global.port.isOpen) {
+          logger.error({
+            level: "error",
+            message: `\u274C Port ${portPath} is connected but NOT open.`
+          });
+          if (config.terminal === "enable" || !config.terminal) {
+            logger.log({ level: "info", message: "Attempting to re-initialize port..." });
+            exports2.initialize();
+          }
+          return { success: false, error: "PORT_NOT_OPEN" };
+        }
+        return { success: true };
+      } catch (e) {
+        logger.error({
+          level: "error",
+          message: `Error checking port connection: ${e.message}`
+        });
+        return { success: false, error: e.message };
+      }
+    };
+    module2.exports.sentToTerminal = async (type, body) => {
       requestType = type;
       requestPayload = body;
+      const portStatus = await exports2.checkPortConnection();
+      if (!portStatus.success) {
+        const msgType = requestType === "STATUS_CHECK" ? "STATUS_MESSAGE" : requestType === "LOGON" ? "LOGON_MESSAGE" : "PAYMENT_MESSAGE";
+        sendMessage2("clientRoom", msgType, {
+          status: "FAILED",
+          action: "TERMINAL_ERROR",
+          error: portStatus.error,
+          message: "Port is not connected or not responding."
+        });
+      }
       if (requestType == "STATUS_CHECK") {
         calculated = generateStatusReq();
         sendMessage2("clientRoom", "STATUS_MESSAGE", {
@@ -1152,9 +1229,13 @@ var require_communication = __commonJS({
           lastPaymentTime = now;
         }
         exports2.reset();
-        const { setPaymentCloudUrl, setPaymentOrderId } = require_responseHandler();
+        const {
+          setPaymentCloudUrl,
+          setPaymentOrderId
+        } = require_responseHandler();
         if (body && body.cloud_url) setPaymentCloudUrl(body.cloud_url);
-        if (body && (body.reference || body.orderId)) setPaymentOrderId(body.reference || body.orderId);
+        if (body && (body.reference || body.orderId))
+          setPaymentOrderId(body.reference || body.orderId);
         calculated = generatePaymentRequest(body);
         console.log(calculated);
         sendMessage2("clientRoom", "PAYMENT_MESSAGE", {

package/package.json

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