nets-service-sdk 1.1.0 → 1.1.2

package/README.md

@@ -50,10 +50,14 @@ Handle communication with the NETS terminal.
 ```javascript
 const { communication } = require('nets-service-sdk');
 
-// Initialize the serial connection
-// Ensure your config.json has 'com' (port) and 'terminal' settings
+// Initialize WITHOUT socket (messages logged only)
 communication.initialize();
 
+// OR Initialize WITH socket (messages emitted via socket)
+const io = require('socket.io-client');
+const socket = io('http://localhost:3000');
+communication.initialize(socket);
+
 // Send a request to the terminal
 // Types: 'STATUS_CHECK', 'LOGON', 'PAYMENT', 'CREDIT_PAYMENT'
 communication.sentToTerminal('STATUS_CHECK', {});
@@ -66,6 +70,39 @@ communication.sentToTerminal('PAYMENT', {
 });
 ```
 
+### Socket.IO Integration (Optional)
+
+The SDK supports optional Socket.IO integration for real-time event broadcasting.
+
+```javascript
+const io = require('socket.io-client');
+const sdk = require('nets-service-sdk');
+
+// Connect to Socket.IO server
+const socket = io('http://localhost:3000');
+
+// Initialize with socket connection
+sdk.communication.initialize(socket);
+
+// Listen for events on client side
+socket.on('PAYMENT_MESSAGE', (data) => {
+  console.log('Payment event:', data);
+});
+
+socket.on('LOGON_MESSAGE', (data) => {
+  console.log('Logon event:', data);
+});
+```
+
+**Socket Events Emitted:**
+- `STATUS_MESSAGE` - Terminal status updates
+- `LOGON_MESSAGE` - Terminal logon results  
+- `PAYMENT_MESSAGE` - Payment transaction updates
+
+**Note:** Socket connection is **optional**. Without it, events are logged only.
+
+See [Socket Integration Guide](docs/SOCKET_INTEGRATION.md) for detailed usage.
+
 ### Transaction Storage (New in v1.1.0)
 
 All terminal requests and responses are automatically stored in a SQLite database.

package/dist/index.js

@@ -217,7 +217,18 @@ var require_sendMessage = __commonJS({
         level: "info",
         message: JSON.stringify(msg)
       });
-      global.io.emit(tag, msg);
+      if (global.io) {
+        global.io.emit(tag, msg);
+        logger.log({
+          level: "debug",
+          message: `Socket message emitted: ${tag}`
+        });
+      } else {
+        logger.log({
+          level: "debug",
+          message: `Socket not available, message logged only: ${tag}`
+        });
+      }
     };
   }
 });
@@ -1270,7 +1281,19 @@ var require_communication = __commonJS({
       global.port.write(calculated.buffer);
       exports2.checkACKorNACK();
     };
-    module2.exports.initialize = async () => {
+    module2.exports.initialize = async (socketConnection = null) => {
+      if (socketConnection) {
+        global.io = socketConnection;
+        logger.log({
+          level: "info",
+          message: "Socket connection initialized"
+        });
+      } else {
+        logger.log({
+          level: "info",
+          message: "No socket connection provided, messages will be logged only"
+        });
+      }
       if (!config.terminal || config.terminal === "enable") {
         global.port = new SerialPort({
           path: config.simulation ? config.simulationPort : config.com,
@@ -1371,6 +1394,142 @@ var require_communication = __commonJS({
   }
 });
 
+// src/db/listTransactions.js
+var require_listTransactions = __commonJS({
+  "src/db/listTransactions.js"(exports2, module2) {
+    var { getRecentTransactions, getTransactionByEcn, getTransactionsByStatus } = require_transactionStore();
+    var logger = require_winston()(module2);
+    function listRecentTransactions(limit = 10) {
+      try {
+        const transactions = getRecentTransactions(limit);
+        if (transactions.length === 0) {
+          console.log("No transactions found in database.");
+          return [];
+        }
+        console.log(`
+\u{1F4CA} Recent ${transactions.length} Transaction(s)
+`);
+        console.log("=".repeat(80));
+        transactions.forEach((txn, index) => {
+          const time = new Date(txn.request_timestamp).toLocaleString();
+          const duration = txn.response_timestamp ? `${txn.response_timestamp - txn.request_timestamp}ms` : "Pending";
+          console.log(`
+${index + 1}. ECN: ${txn.ecn}`);
+          console.log(`   Type: ${txn.request_type}`);
+          console.log(`   Status: ${txn.status}`);
+          console.log(`   Time: ${time}`);
+          console.log(`   Duration: ${duration}`);
+          if (txn.request_type === "PAYMENT" || txn.request_type === "CREDIT_PAYMENT") {
+            const amount = txn.request_payload.amount ? `$${(txn.request_payload.amount / 100).toFixed(2)}` : "N/A";
+            console.log(`   Amount: ${amount}`);
+            console.log(`   Reference: ${txn.request_payload.reference || "N/A"}`);
+          }
+        });
+        console.log("\n" + "=".repeat(80) + "\n");
+        return transactions;
+      } catch (error) {
+        if (error.code === "SQLITE_CANTOPEN") {
+          console.log("\u2139\uFE0F  Database not found. No transactions have been created yet.");
+          console.log("   Transactions will be automatically stored when you send requests to the terminal.\n");
+          return [];
+        }
+        logger.log({
+          level: "error",
+          message: `Failed to list transactions: ${error.message}`
+        });
+        throw error;
+      }
+    }
+    function listTransactionsByStatus(status, limit = 50) {
+      try {
+        const transactions = getTransactionsByStatus(status, limit);
+        if (transactions.length === 0) {
+          console.log(`No ${status} transactions found.`);
+          return [];
+        }
+        console.log(`
+\u{1F4CA} ${status} Transactions (${transactions.length})
+`);
+        console.log("=".repeat(80));
+        transactions.forEach((txn, index) => {
+          const time = new Date(txn.request_timestamp).toLocaleString();
+          console.log(`
+${index + 1}. ECN: ${txn.ecn} | ${txn.request_type} | ${time}`);
+        });
+        console.log("\n" + "=".repeat(80) + "\n");
+        return transactions;
+      } catch (error) {
+        if (error.code === "SQLITE_CANTOPEN") {
+          console.log("\u2139\uFE0F  Database not found. No transactions have been created yet.\n");
+          return [];
+        }
+        logger.log({
+          level: "error",
+          message: `Failed to list transactions: ${error.message}`
+        });
+        throw error;
+      }
+    }
+    function getTransactionDetails(ecn) {
+      try {
+        const transaction = getTransactionByEcn(ecn);
+        if (!transaction) {
+          console.log(`Transaction with ECN ${ecn} not found.`);
+          return null;
+        }
+        console.log(`
+\u{1F4C4} Transaction Details: ${ecn}
+`);
+        console.log("=".repeat(80));
+        console.log(`Type: ${transaction.request_type}`);
+        console.log(`Status: ${transaction.status}`);
+        console.log(`Request Time: ${new Date(transaction.request_timestamp).toLocaleString()}`);
+        if (transaction.response_timestamp) {
+          console.log(`Response Time: ${new Date(transaction.response_timestamp).toLocaleString()}`);
+          console.log(`Duration: ${transaction.response_timestamp - transaction.request_timestamp}ms`);
+        }
+        console.log(`
+Request Payload:`);
+        console.log(JSON.stringify(transaction.request_payload, null, 2));
+        if (transaction.response_data && Object.keys(transaction.response_data).length > 0) {
+          console.log(`
+Response Data:`);
+          console.log(JSON.stringify(transaction.response_data, null, 2));
+        }
+        console.log("\n" + "=".repeat(80) + "\n");
+        return transaction;
+      } catch (error) {
+        if (error.code === "SQLITE_CANTOPEN") {
+          console.log("\u2139\uFE0F  Database not found. No transactions have been created yet.\n");
+          return null;
+        }
+        logger.log({
+          level: "error",
+          message: `Failed to get transaction: ${error.message}`
+        });
+        throw error;
+      }
+    }
+    module2.exports = {
+      listRecentTransactions,
+      listTransactionsByStatus,
+      getTransactionDetails
+    };
+    if (require.main === module2) {
+      const args = process.argv.slice(2);
+      if (args[0] === "--status" && args[1]) {
+        const limit = args[2] ? parseInt(args[2]) : 50;
+        listTransactionsByStatus(args[1], limit);
+      } else if (args[0] === "--ecn" && args[1]) {
+        getTransactionDetails(args[1]);
+      } else {
+        const limit = args[0] ? parseInt(args[0]) : 10;
+        listRecentTransactions(limit);
+      }
+    }
+  }
+});
+
 // src/index.js
 var utilsHelper = require_utils_helper();
 var winston = require_winston();
@@ -1383,6 +1542,7 @@ var httpRequest = require_httpRequest();
 var parser = require_parser();
 var responseHandler = require_responseHandler();
 var transactionStore = require_transactionStore();
+var listTransactions = require_listTransactions();
 module.exports = {
   ...utilsHelper,
   logger: winston,
@@ -1402,5 +1562,9 @@ module.exports = {
   // Auto-purge control
   startAutoPurge: transactionStore.startAutoPurge,
   stopAutoPurge: transactionStore.stopAutoPurge,
-  isAutoPurgeRunning: transactionStore.isAutoPurgeRunning
+  isAutoPurgeRunning: transactionStore.isAutoPurgeRunning,
+  // Transaction listing functions
+  listRecentTransactions: listTransactions.listRecentTransactions,
+  listTransactionsByStatus: listTransactions.listTransactionsByStatus,
+  getTransactionDetails: listTransactions.getTransactionDetails
 };

package/package.json

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