nets-service-sdk 1.1.18 → 1.1.20

package/dist/index.js

@@ -280,6 +280,17 @@ var require_hexRequest = __commonJS({
       console.log("buffer", buffer);
       return { buffer, ecn: body.ecn, hexString };
     };
+    module2.exports.generateFunction56Request = () => {
+      const date = moment().format("DDMMYYHHmmss");
+      const paddedValue = padWithLeadingZeros(date, "12");
+      const hexValue = paddedValue.toHexString();
+      const calculated = `0018${hexValue}35363031301C03`;
+      const calculatedXor = xorCalculation(calculated);
+      const hexString = `02${calculated}` + calculatedXor;
+      console.log("Recovery Function 56 Request:", hexString);
+      const buffer = Buffer.from(hexString, "hex");
+      return { buffer, ecn: date };
+    };
   }
 });
 
@@ -502,13 +513,19 @@ var require_parser = __commonJS({
       const data = { ...obj };
       const keys = Object.keys(data);
       const translatedJson = {};
+      const ecnError = CheckECNERROR(obj["ECN"]);
+      if (ecnError) {
+        translatedJson.status = ecnError.status;
+        translatedJson.description = ecnError.detail;
+        translatedJson.category = ecnError.category;
+      }
       keys.forEach((key) => {
         if (key == "01") {
           translatedJson["approvalCode"] = obj[key];
         }
         if (key == "02") {
           const statusResponse = statusCheck(obj[key]);
-          if (statusResponse) {
+          if (statusResponse && !translatedJson.status) {
             translatedJson.status = statusResponse.status;
             translatedJson.description = statusResponse.detail;
             translatedJson.category = statusResponse.category;
@@ -516,12 +533,6 @@ var require_parser = __commonJS({
               translatedJson["balance"] = statusResponse.balance;
             }
           }
-          const ecnnError = CheckECNERROR(obj["ECN"]);
-          if (ecnnError) {
-            translatedJson.status = ecnnError.status;
-            translatedJson.description = ecnnError.detail;
-            translatedJson.category = ecnnError.category;
-          }
           translatedJson["responsetext"] = obj[key];
         }
         if (key == "03") {
@@ -602,7 +613,7 @@ var require_parser = __commonJS({
         if (key == "HC") {
           translatedJson["hostResponseCode"] = obj[key];
           const mapped = getResponseFromCode(obj[key]);
-          if (mapped) {
+          if (mapped && !translatedJson.status) {
             translatedJson.status = mapped.status;
             translatedJson.description = mapped.detail;
             translatedJson.category = mapped.category;
@@ -648,6 +659,11 @@ var require_parser = __commonJS({
           translatedJson["receiptTextFormat"] = obj[key];
         }
       });
+      if (!translatedJson.status) {
+        translatedJson.status = "UNKNOWN";
+        translatedJson.description = "NO_RESPONSE_CODE";
+        translatedJson.category = "RETRY";
+      }
       logger.log({ level: "info", message: "jsonProcessor translated terminal response into JSON format." });
       return { translated: translatedJson, raw: obj };
     };
@@ -680,6 +696,9 @@ var require_parser = __commonJS({
       if (data?.indexOf("DECLINED") > -1) {
         return { status: "DECLINED", detail: "Transaction Declined", category: "HARD_FAIL" };
       }
+      if (data?.indexOf("CANCELLED") > -1) {
+        return { status: "USER_CANCELLED", detail: "USER_CANCELLED", category: "HARD_FAIL" };
+      }
       if (data?.indexOf("CARD NOT SUPPORTED") > -1) {
         return { status: "CARD_NOT_SUPPORTED", detail: "Card not supported", category: "HARD_FAIL" };
       }
@@ -922,6 +941,32 @@ var require_responseHandler = __commonJS({
       }
       return isMatch;
     };
+    module2.exports.terminalRecovery = (hexFrame) => {
+      const ecn = activePaymentEcn;
+      const parsedValue = netsPaymentParser(hexFrame, ecn);
+      const response = jsonProcessor(parsedValue);
+      if (response.translated) {
+        activePaymentEcn = null;
+      }
+      if (response.translated && (response.translated.category == "SUCCESS" || response.translated.status == "APPROVED")) {
+        logger.log({ level: "info", message: "\u2705 Recovery SUCCESS: Last transaction was APPROVED." });
+        sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
+          success: true,
+          status: "SUCCESS",
+          response,
+          action: "COMPLETED"
+        });
+        sendPaymentResponseToCloud(response.translated);
+      } else {
+        logger.log({ level: "warn", message: "\u26A0\uFE0F Recovery FAILED: Transaction status could not be confirmed as APPROVED." });
+        sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
+          status: "FAILED",
+          action: "CANCELLED",
+          message: "Payment needs verification / Failed",
+          reason: "RECOVERY_NOT_CONFIRMED"
+        });
+      }
+    };
   }
 });
 
@@ -951,13 +996,14 @@ var require_communication = __commonJS({
     var { initialiseRequest } = require_httpRequest();
     var requestType;
     var calculated;
-    var MAX_COUNT = 3;
+    var MAX_COUNT = 2;
     var WRONG_LRC_MAX_COUNT = 3;
     var count = MAX_COUNT;
     var lrcCount = WRONG_LRC_MAX_COUNT;
     var ackOrNack = null;
     var requestPayload = null;
     var ackTimeout = null;
+    var dataTimeout = null;
     var ACK = Buffer.alloc(1, 6, "hex");
     var NACK = Buffer.alloc(1, 21, "hex");
     var dataBuffer = Buffer.alloc(0);
@@ -973,6 +1019,10 @@ var require_communication = __commonJS({
         clearTimeout(ackTimeout);
         ackTimeout = null;
       }
+      if (dataTimeout) {
+        clearTimeout(dataTimeout);
+        dataTimeout = null;
+      }
     };
     module2.exports.checkACKorNACK = () => {
       if (ackTimeout) clearTimeout(ackTimeout);
@@ -992,12 +1042,12 @@ var require_communication = __commonJS({
               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,
+              status: "FAILED",
               action: "TERMINAL_ERROR"
             });
           }
         }
-      }, 4e3);
+      }, 2e3);
     };
     var resendData = () => {
       if (requestType == "STATUS_CHECK") {
@@ -1097,6 +1147,7 @@ var require_communication = __commonJS({
             clearTimeout(ackTimeout);
             ackTimeout = null;
           }
+          exports2.startDataTimeout();
           if (byte === 21) {
             count--;
             if (count >= 0) {
@@ -1107,7 +1158,7 @@ var require_communication = __commonJS({
                 level: "error",
                 message: `Terminal responded with NACK multiple times. Max retries reached. Sending TERMINAL_ERROR.`
               });
-              sendMessage2("clientRoom", "PAYMENT_MESSAGE", { success: true, action: "TERMINAL_ERROR" });
+              sendMessage2("clientRoom", "PAYMENT_MESSAGE", { status: "FAILED", action: "TERMINAL_ERROR" });
             }
           }
           continue;
@@ -1163,18 +1214,37 @@ var require_communication = __commonJS({
         }
       }
     };
+    module2.exports.triggerRecovery = () => {
+      const { generateFunction56Request } = require_hexRequest();
+      exports2.reset();
+      lrcCount = WRONG_LRC_MAX_COUNT;
+      count = MAX_COUNT;
+      const req = generateFunction56Request();
+      requestType = "RECOVERY";
+      calculated = req;
+      logger.log({ level: "info", message: "\u{1F680} Triggering Recovery (Function 56) due to LRC failures..." });
+      global.port.write(req.buffer);
+      exports2.checkACKorNACK();
+    };
     module2.exports.handleFullMessage = (fullFrame) => {
-      const { checkLrc: checkLrc2, terminalStatus: terminalStatus2, terminalLogon: terminalLogon2, terminalPayment: terminalPayment2, terminalCreditPayment: terminalCreditPayment2 } = require_responseHandler();
+      const { checkLrc: checkLrc2, terminalStatus: terminalStatus2, terminalLogon: terminalLogon2, terminalPayment: terminalPayment2, terminalCreditPayment: terminalCreditPayment2, terminalRecovery } = require_responseHandler();
       if (ackTimeout) {
         clearTimeout(ackTimeout);
         ackTimeout = null;
       }
+      if (dataTimeout) {
+        clearTimeout(dataTimeout);
+        dataTimeout = null;
+      }
       ackOrNack = Buffer.from([6]);
       const hexFrame = fullFrame.toString("hex").toUpperCase();
       logger.log({ level: "info", message: `Full frame processed: ${hexFrame}` });
-      if (checkLrc2(hexFrame)) {
+      const isLrcCorrect = checkLrc2(hexFrame);
+      if (isLrcCorrect) {
         logger.log({ level: "info", message: `LRC Correct. Sending ACK (0x06).` });
         global.port.write(ACK);
+        lrcCount = WRONG_LRC_MAX_COUNT;
+        count = MAX_COUNT;
         logger.log({ level: "info", message: `requestType: ${requestType}` });
         if (requestType === "STATUS_CHECK") {
           terminalStatus2(calculated?.ecn, hexFrame);
@@ -1184,12 +1254,65 @@ var require_communication = __commonJS({
           terminalPayment2(hexFrame, calculated?.ecn);
         } else if (requestType === "CREDIT_PAYMENT") {
           terminalCreditPayment2(hexFrame, calculated?.ecn);
+        } else if (requestType === "RECOVERY") {
+          terminalRecovery(hexFrame);
         }
       } else {
-        logger.log({ level: "error", message: `LRC Incorrect. Sending NACK (0x15).` });
-        global.port.write(NACK);
+        lrcCount--;
+        if (lrcCount > 0) {
+          logger.log({ level: "error", message: `LRC Incorrect. Sending NACK (0x15). Retries left: ${lrcCount}` });
+          global.port.write(NACK);
+        } else {
+          if (hexFrame.indexOf("415050524F564544") > -1) {
+            logger.log({ level: "info", message: "\u2705 LRC Incorrect 3 times, but APPROVED found in hex payload. Accepting with ACK." });
+            global.port.write(ACK);
+            lrcCount = WRONG_LRC_MAX_COUNT;
+            count = MAX_COUNT;
+            if (requestType === "PAYMENT") terminalPayment2(hexFrame, calculated?.ecn);
+            else if (requestType === "CREDIT_PAYMENT") terminalCreditPayment2(hexFrame, calculated?.ecn);
+            else if (requestType === "RECOVERY") terminalRecovery(hexFrame);
+            else if (requestType === "LOGON") terminalLogon2(calculated?.ecn, hexFrame);
+            else if (requestType === "STATUS_CHECK") terminalStatus2(calculated?.ecn, hexFrame);
+          } else {
+            logger.log({ level: "warn", message: `LRC Incorrect 3 times and NO approval found. Stopping.` });
+            global.port.write(NACK);
+            if (ackTimeout) {
+              clearTimeout(ackTimeout);
+              ackTimeout = null;
+            }
+            if (requestType !== "RECOVERY") {
+              sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
+                status: "UNKNOWN",
+                action: "VERIFYING_STATUS",
+                message: "Payment status uncertain. Please wait while we verify...",
+                reason: "LRC_FAILURE"
+              });
+              setTimeout(() => exports2.triggerRecovery(), 2e3);
+            } else {
+              sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
+                status: "FAILED",
+                action: "CANCELLED",
+                message: "Payment needs manual verification / Recovery failed.",
+                reason: "RECOVERY_LRC_FAILURE"
+              });
+            }
+          }
+        }
       }
     };
+    module2.exports.startDataTimeout = () => {
+      if (dataTimeout) clearTimeout(dataTimeout);
+      dataTimeout = setTimeout(() => {
+        dataTimeout = null;
+        logger.error({ level: "error", message: `Terminal response time out (60 seconds) after ACK.` });
+        sendMessage2("clientRoom", "PAYMENT_MESSAGE", {
+          status: "FAILED",
+          action: "TERMINAL_ERROR",
+          message: "Terminal response time out (60 seconds)"
+        });
+        exports2.reset();
+      }, 6e4);
+    };
     module2.exports.checkPortConnection = async () => {
       const portPath = config.simulation ? config.simulationPort : config.com;
       try {
@@ -1292,7 +1415,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "nets-service-sdk",
-      version: "1.1.18",
+      version: "1.1.20",
       description: "Utility functions for Nets Service",
       source: "src/index.js",
       main: "dist/index.js",
@@ -1301,7 +1424,7 @@ var require_package = __commonJS({
       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'
+        test: "jest"
       },
       keywords: [
         "nets",
@@ -1327,10 +1450,12 @@ var require_package = __commonJS({
         request: "^2.88.2",
         serialport: "^10.5.0",
         "socket.io-client": "^4.7.2",
-        winston: "^3.8.2"
+        winston: "^3.8.2",
+        "winston-daily-rotate-file": "^5.0.0"
       },
       devDependencies: {
         esbuild: "^0.27.0",
+        jest: "^30.3.0",
         microbundle: "^0.15.1"
       }
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nets-service-sdk",
-  "version": "1.1.18",
+  "version": "1.1.20",
   "description": "Utility functions for Nets Service",
   "source": "src/index.js",
   "main": "dist/index.js",
@@ -9,7 +9,7 @@
   "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"
+    "test": "jest"
   },
   "keywords": [
     "nets",
@@ -35,10 +35,12 @@
     "request": "^2.88.2",
     "serialport": "^10.5.0",
     "socket.io-client": "^4.7.2",
-    "winston": "^3.8.2"
+    "winston": "^3.8.2",
+    "winston-daily-rotate-file": "^5.0.0"
   },
   "devDependencies": {
     "esbuild": "^0.27.0",
+    "jest": "^30.3.0",
     "microbundle": "^0.15.1"
   }
 }