aba-pos-sdk-node 1.0.2 → 1.0.4

package/README.md

@@ -1,6 +1,6 @@
 # ABA POS SDK for Node.js
 
-An official Node.js Addons for ABA POS SDK developed by ABA Bank (Advanced Bank of Asia Ltd.). This package allows you to connect with the ABA POS terminal from these supported platforms: Windows (x64), macOS (x64, arm64), and Linux (x64).
+An official Node.js Addons for ABA POS SDK developed by ABA Bank (Advanced Bank of Asia Ltd.). This package allows you to connect with the ABA POS terminal from these supported platforms: Windows (x64, arm64), macOS (x64, arm64), and Linux (x64, arm64).
 
 ## Driver Installation
 The driver might already come with Windows Update if you use Windows 10 or 11. To verify if you have
@@ -11,16 +11,21 @@ the driver installed, you need to:
   * Prolific USB-to-Serial Comm Port
   * Prolific PL2303GT USB Serial COM Port
   * Prolific PL2303GC USB Serial COM Port
+  * USB Serial Device (COMXX)
   * Or something similar.
 If you cannot find the USB device after you plug in the ABA POS USB cable, you can get the latest official
-USB driver from the Prolific website here.
-https://www.prolific.com.tw/US/ShowProduct.aspx?p_id=223&pcid=126
+USB driver from:
+    * WizarPOS Q2, Q2P: https://www.prolific.com.tw/en/portfolio-item/pl2303gs/
+    * WizarPOS Q2Pro: https://smartpossdk.gitbook.io/cloudpossdk/faq/usb-serial-port/install-terminal-usb-drivers
 
 * On macOS, you need to install the official driver from AppStore here:
 https://apps.apple.com/us/app/pl2303-serial/id1624835354
 
 * On Linux, please contact our ABA Terminal Integration Team via any channel (Telegram, Email, etc)
 
+## Additional Software Installation
+On Windows, you'll need to install Microsoft Visual C++ Redistributable (VC_redist.x64.exe or VC_redist.arm64.exe) if you could not load the aba-pos-sdk-node. Link: https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist
+
 ## Import Module
 You need to import AbaPosSdk and AbaPosSdkError from this module: 'aba-pos-sdk-node'.
 
@@ -64,11 +69,9 @@ try {
     // The timeout in milliseconds. You can increase the timeout if it's too fast.
     const timeoutMs = 60000;
 
-    console.log("Sending data to ABA POS...");
-    await AbaPosSdk.sendDataByUsb(data, timeoutMs);
-
-    console.log("Waiting for response from ABA POS...");
-    const response = await AbaPosSdk.waitForResponse();
+    console.log("Send data to ABA POS. Waiting for response...");
+    const response = await AbaPosSdk.sendDataByUsb(data, timeoutMs);
+    
     if (response) {
         console.log('Response received:', response);
     } else {
@@ -111,11 +114,9 @@ try {
     // The timeout in milliseconds. You can increase the timeout if it's too fast.
     const timeoutMs = 60000;
 
-    console.log("Sending data to ABA POS...");
-    await AbaPosSdk.sendDataByIp(data, timeoutMs);
-
-    console.log("Waiting for response from ABA POS...");
-    const response = await AbaPosSdk.waitForResponse();
+    console.log("Send data to ABA POS. Waiting for response...");
+    const response = await AbaPosSdk.sendDataByIp(data, timeoutMs);
+    
     if (response) {
         console.log('Response received:', response);
     } else {

package/aba_pos_sdk.min.js

@@ -6,7 +6,7 @@
  * asynchronous utility methods to interact with the POS terminal via USB or IP connection.
  * 
  * @copyright
- * Copyright (C) 2025 ABA Bank (Advanced Bank of Asia Ltd).
+ * Copyright (C) 2026 ABA Bank (Advanced Bank of Asia Ltd).
  * All copyrights of the code are owned or licensed by ABA Bank.
  */
-const r=require("path"),t=process.platform,a=process.arch;if("darwin"!==t&&"win32"!==t&&"linux"!==t)throw new AbaPosSdkError(e,`Unsupported platform: ${t}`);const s=r.resolve(__dirname,"addons",t,a,"aba_pos_sdk_node_addon"),o=require(s),e=-101;class AbaPosSdk{constructor(){throw new AbaPosSdkError(e,"AbaPosSdk is a static class and cannot be instantiated.")}static async initUsbConnection(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"initUsbConnection() error. 'key' must be a string.");0!==await o.initUsbConnection(r)&&await AbaPosSdk.t()}static async sendDataByUsb(r,t){if("string"!=typeof r)throw new AbaPosSdkError(e,"sendDataByUsb() error. 'data' must be a string.");if(!Number.isInteger(t))throw new AbaPosSdkError(e,"sendDataByUsb() error. 'timeout' must be an integer.");0!==await o.sendDataByUsb(r,t)&&await AbaPosSdk.t()}static async releaseUsbConnection(){await o.releaseUsbConnection()}static async initIpConnection(r,t){if("string"!=typeof r)throw new AbaPosSdkError(e,"initIpConnection() error. 'ipAddress' must be a string.");if("string"!=typeof t)throw new AbaPosSdkError(e,"initIpConnection() error. 'key' must be a string.");0!==await o.initIpConnection(r,t)&&await AbaPosSdk.t()}static async updateIpAddress(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"updateIpAddress() error. 'newIpAddress' must be a string.");0!==await o.updateIpAddress(r)&&await AbaPosSdk.t()}static async sendDataByIp(r,t){if("string"!=typeof r)throw new AbaPosSdkError(e,"sendDataByIp() error. 'data' must be a string.");if(!Number.isInteger(t))throw new AbaPosSdkError(e,"sendDataByIp() error. 'timeout' must be an integer.");0!==await o.sendDataByIp(r,t)&&await AbaPosSdk.t()}static async releaseIpConnection(){await o.releaseIpConnection()}static async cancelWaitingPosTerminal(){0!==await o.cancelWaitingPosTerminal()&&await AbaPosSdk.t()}static waitForResponse(){return new Promise(((r,t)=>{o.waitForResponseAsync((async(a,s)=>{a?t(a):0==await AbaPosSdk.getErrorCode()?r(s):t(await AbaPosSdk.o())}))}))}static async getErrorMessage(){return await o.getErrorMessage()}static async getErrorCode(){return await o.getErrorCode()}static async setLogDirectoryPath(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"setLogDirectoryPath() error. 'absolutePath' must be a string.");0!==await o.setLogDirectoryPath(r)&&await AbaPosSdk.t()}static async removeLogDirectoryPath(){0!==await o.removeLogDirectoryPath()&&await AbaPosSdk.t()}static async updateKey(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"updateKey() error. 'newKey' must be a string.");0!==await o.updateKey(r)&&await AbaPosSdk.t()}static generateTimestamp(){const r=new Date;return`${r.getFullYear()}-${String(r.getMonth()+1).padStart(2,"0")}-${String(r.getDate()).padStart(2,"0")} ${String(r.getHours()).padStart(2,"0")}:${String(r.getMinutes()).padStart(2,"0")}:${String(r.getSeconds()).padStart(2,"0")}`}static async t(){throw new AbaPosSdkError(await AbaPosSdk.getErrorCode(),await AbaPosSdk.getErrorMessage())}static async o(){return new AbaPosSdkError(await AbaPosSdk.getErrorCode(),await AbaPosSdk.getErrorMessage())}}class AbaPosSdkError extends Error{constructor(r,t){if(super(t),!Number.isInteger(r))throw new AbaPosSdkError(e,"'errorCode' must be an integer.");if("string"!=typeof t)throw new AbaPosSdkError(e,"'errorMessage' must be a string.");this.name="AbaPosSdkError",this.errorCode=r,this.errorMessage=t,Error.captureStackTrace&&Error.captureStackTrace(this,AbaPosSdkError)}toString(){return`AbaPosSdkError: ${this.errorMessage} (Error Code: ${this.errorCode})`}}module.exports={AbaPosSdk:AbaPosSdk,AbaPosSdkError:AbaPosSdkError};
+const r=require("path"),t=process.platform,a=process.arch;if("darwin"!==t&&"win32"!==t&&"linux"!==t)throw new AbaPosSdkError(e,`Unsupported platform: ${t}`);const s=r.resolve(__dirname,"addons",t,a,"aba_pos_sdk_node_addon"),o=require(s),e=-101;class AbaPosSdk{constructor(){throw new AbaPosSdkError(e,"AbaPosSdk is a static class and cannot be instantiated.")}static async initUsbConnection(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"initUsbConnection() error. 'key' must be a string.");0!==await o.initUsbConnection(r)&&await AbaPosSdk.t()}static async sendDataByUsb(r,t){if("string"!=typeof r)throw new AbaPosSdkError(e,"sendDataByUsb() error. 'data' must be a string.");if(!Number.isInteger(t))throw new AbaPosSdkError(e,"sendDataByUsb() error. 'timeout' must be an integer.");return 0!==await o.sendDataByUsb(r,t)&&await AbaPosSdk.t(),AbaPosSdk.o()}static async releaseUsbConnection(){await o.releaseUsbConnection()}static async initIpConnection(r,t){if("string"!=typeof r)throw new AbaPosSdkError(e,"initIpConnection() error. 'ipAddress' must be a string.");if("string"!=typeof t)throw new AbaPosSdkError(e,"initIpConnection() error. 'key' must be a string.");0!==await o.initIpConnection(r,t)&&await AbaPosSdk.t()}static async updateIpAddress(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"updateIpAddress() error. 'newIpAddress' must be a string.");0!==await o.updateIpAddress(r)&&await AbaPosSdk.t()}static async sendDataByIp(r,t){if("string"!=typeof r)throw new AbaPosSdkError(e,"sendDataByIp() error. 'data' must be a string.");if(!Number.isInteger(t))throw new AbaPosSdkError(e,"sendDataByIp() error. 'timeout' must be an integer.");return 0!==await o.sendDataByIp(r,t)&&await AbaPosSdk.t(),AbaPosSdk.o()}static async releaseIpConnection(){await o.releaseIpConnection()}static async cancelWaitingPosTerminal(){0!==await o.cancelWaitingPosTerminal()&&await AbaPosSdk.t()}static o(){return new Promise((r,t)=>{o.waitForResponseAsync(async(a,s)=>{a?t(a):0==await AbaPosSdk.getErrorCode()?r(s):t(await AbaPosSdk.i())})})}static async getErrorMessage(){return await o.getErrorMessage()}static async getErrorCode(){return await o.getErrorCode()}static async setLogDirectoryPath(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"setLogDirectoryPath() error. 'absolutePath' must be a string.");0!==await o.setLogDirectoryPath(r)&&await AbaPosSdk.t()}static async removeLogDirectoryPath(){0!==await o.removeLogDirectoryPath()&&await AbaPosSdk.t()}static async updateKey(r){if("string"!=typeof r)throw new AbaPosSdkError(e,"updateKey() error. 'newKey' must be a string.");0!==await o.updateKey(r)&&await AbaPosSdk.t()}static generateTimestamp(){const r=new Date;return`${r.getFullYear()}-${String(r.getMonth()+1).padStart(2,"0")}-${String(r.getDate()).padStart(2,"0")} ${String(r.getHours()).padStart(2,"0")}:${String(r.getMinutes()).padStart(2,"0")}:${String(r.getSeconds()).padStart(2,"0")}`}static async t(){throw new AbaPosSdkError(await AbaPosSdk.getErrorCode(),await AbaPosSdk.getErrorMessage())}static async i(){return new AbaPosSdkError(await AbaPosSdk.getErrorCode(),await AbaPosSdk.getErrorMessage())}}class AbaPosSdkError extends Error{constructor(r,t){if(super(t),!Number.isInteger(r))throw new AbaPosSdkError(e,"'errorCode' must be an integer.");if("string"!=typeof t)throw new AbaPosSdkError(e,"'errorMessage' must be a string.");this.name="AbaPosSdkError",this.errorCode=r,this.errorMessage=t,Error.captureStackTrace&&Error.captureStackTrace(this,AbaPosSdkError)}toString(){return`AbaPosSdkError: ${this.errorMessage} (Error Code: ${this.errorCode})`}}module.exports={AbaPosSdk:AbaPosSdk,AbaPosSdkError:AbaPosSdkError};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aba-pos-sdk-node",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Node.js Addons for ABA POS SDK developed by ABA Bank. This package allows you to connect with the ABA POS terminal.",
   "main": "aba_pos_sdk.min.js",
   "type": "commonjs",