wahdx-api 1.0.3 → 2.0.0

package/README.md

@@ -1,189 +1,240 @@
-# wahdx-api
-
-Package untuk generate QRIS dan cek payment status secara realtime dengan API OrderKuota dari [https://api.wahdx.co](https://api.wahdx.co).
-
-## Fitur
-
-- Membaca dan ekstrak kode QR dari gambar
-- Generate kode QR dengan nominal tertentu
-- Cek status pembayaran secara realtime
-- Generate bukti transaksi (receipt)
-- Kompatibel di semua platform (Windows, Linux, Mac)
-
-## Instalasi
-
-```bash
-npm install wahdx-api
-```
-
-## Konfigurasi
-
-Buat file `.env` di root project Anda:
-
-```
-WAHDX_TOKENKEY=your_wahdx_token_key
-ORKUT_TOKEN_AUTH=your_orkut_token_auth
-ORKUT_USERNAME=your_orkut_username
-```
-
-> **Catatan:** Untuk mendapatkan tokenKey, Anda bisa membelinya di halaman [https://api.wahdx.co](https://api.wahdx.co)
-
-## Penggunaan
-
-### Contoh Lengkap
-
-```javascript
-import QRISPayment from 'wahdx-api';
-import '@dotenvx/dotenvx/config';
-import fs from 'fs';
-
-// Konfigurasi
-const config = {
-    storeName: 'AHDX STORE',
-    defaultQrPath: 'QRIS.png', // Path ke QRIS static yang didownload di merchant orderkuota
-    tokenKey: process.env.WAHDX_TOKENKEY,
-    auth_token: process.env.ORKUT_TOKEN_AUTH,
-    auth_username: process.env.ORKUT_USERNAME
-};
-
-// Membuat instance QRISPayment
-const qrisPayment = new QRISPayment(config);
-
-async function main() {
-    try {
-        console.log('=== TEST REALTIME QRIS PAYMENT ===\n');
-        const randomAmount = Math.floor(Math.random() * 99) + 1; // Random 1-99
-        const amount = 100 + randomAmount; // Base 100 + random amount
-        const reference = 'REF' + Date.now();
-        
-        // Generate QR code
-        const { qrBuffer } = await qrisPayment.generateQRFromImage(amount);
-        
-        // Save QR code image
-        fs.writeFileSync(`qr-${amount}.png`, qrBuffer);
-        
-        console.log('=== TRANSACTION DETAILS ===');
-        console.log('Reference:', reference);
-        console.log('Amount:', amount);
-        console.log('QR Image:', `qr-${amount}.png`);
-        console.log('\nSilakan scan QR code dan lakukan pembayaran');
-        console.log('\nMenunggu pembayaran...\n');
-
-        // Check payment status with 5 minutes timeout
-        const startTime = Date.now();
-        const timeout = 5 * 60 * 1000;
-
-        while (Date.now() - startTime < timeout) {
-            const result = await qrisPayment.checkPayment(reference, amount);
-            
-            if (result.success && result.data.status === 'PAID') {
-                console.log('✓ Pembayaran berhasil!');
-                if (result.receipt) {
-                    console.log('✓ Bukti transaksi:', result.receipt.filePath);
-                }
-                return;
-            }
-
-            await new Promise(resolve => setTimeout(resolve, 10000));   // delay 10 detik
-            console.log('Menunggu pembayaran...');
-        }
-
-        throw new Error('Timeout: Pembayaran tidak diterima dalam 5 menit');
-        
-    } catch (error) {
-        console.error('Error:', error.message);
-    }
-}
-
-main();
-```
-
-### API Reference
-
-#### Inisialisasi
-
-```javascript
-import QRISPayment from 'wahdx-api';
-
-const config = {
-    storeName: 'NAMA TOKO',
-    defaultQrPath: 'path/to/qris/template.png',
-    tokenKey: 'your_wahdx_token_key',
-    auth_token: 'your_orkut_token_auth',
-    auth_username: 'your_orkut_username'
-};
-
-const qrisPayment = new QRISPayment(config);
-```
-
-#### Generate QR dari Template
-
-```javascript
-const amount = 10000; // Rp 10.000
-// Menggunakan default QR yang sudah diatur
-const { qrString, qrBuffer } = await qrisPayment.generateQRFromImage(amount);
-// Atau dengan path QR spesifik
-// const { qrString, qrBuffer } = await qrisPayment.generateQRFromImage(amount, 'path/to/qris/template.png');
-
-// Simpan QR ke file
-fs.writeFileSync('qr-output.png', qrBuffer);
-```
-
-#### Cek Status Pembayaran
-
-```javascript
-const reference = 'REF' + Date.now();
-const amount = 10000;
-
-const result = await qrisPayment.checkPayment(reference, amount);
-console.log(result);
-/*
-Output jika berhasil:
-{
-  success: true,
-  data: {
-    status: 'PAID',
-    amount: 10000,
-    reference: 'REF1234567890',
-    ...
-  },
-  receipt: {
-    filePath: 'path/to/receipt.pdf',
-    ...
-  }
-}
-*/
-```
-
-## FAQ
-
-### Q: Bagaimana cara mendapatkan tokenKey agar bisa menggunakan module ini?
-A: Anda bisa membeli tokenKey di halaman utama [https://api.wahdx.co](https://api.wahdx.co)
-
-### Q: Bagaimana cara mendapatkan kredensial API OrderKuota?
-A: Silahkan kunjungi dokumentasi api [https://api.wahdx.co/api-docs](https://api.wahdx.co/api-docs) untuk mendapatkan token pada akun orderkuota anda.
-
-### Q: Apakah module ini bisa digunakan di project CommonJS?
-A: Ya! Package ini mendukung dual module system (ESM dan CommonJS). Anda bisa menggunakan dengan dua cara:
-
-1. Dengan ES Modules (dalam file .js dengan `type: "module"` di package.json):
-```javascript
-import QRISPayment from 'wahdx-api';
-
-const qrisPayment = new QRISPayment(config);
-// gunakan qrisPayment
-```
-
-2. Dengan CommonJS (dalam file .cjs atau project tanpa `type: "module"`):
-```javascript
-const QRISPayment = require('wahdx-api');
-
-const qrisPayment = new QRISPayment(config);
-// gunakan qrisPayment
-```
-
-Package secara otomatis mendeteksi format yang digunakan dan menyediakan versi yang sesuai.
-
-## Lisensi
-
+# wahdx-api
+
+Package untuk generate QRIS dan cek payment status secara realtime dengan API OrderKuota dari [https://api.wahdx.co](https://api.wahdx.co).
+
+> **⚠️ PENTING: Perubahan di Versi 2.0.0**
+>
+> Pada versi 2.0.0, kami melakukan perubahan besar pada package ini:
+> - Fitur `generateQRFromImage` telah **DIHAPUS** sepenuhnya
+> - Digantikan dengan `generateQRFromAPI` yang lebih valid dan reliable
+> - Dependency `sharp` dan `jsqr` telah dihapus untuk membuat package lebih ringan
+>
+> Jika Anda mengupgrade dari versi sebelumnya, harap perbarikan kode Anda untuk menggunakan `generateQRFromAPI` alih-alih `generateQRFromImage`.
+
+## Fitur
+
+- Generate kode QR dengan nominal tertentu (lokal atau via API)
+- Cek status pembayaran secara realtime
+- Generate bukti transaksi (receipt)
+- Kompatibel di semua platform (Windows, Linux, Mac)
+
+## Instalasi
+
+```bash
+npm install wahdx-api
+```
+
+## Konfigurasi
+
+Buat file `.env` di root project Anda:
+
+```
+WAHDX_TOKENKEY=your_wahdx_token_key
+ORKUT_TOKEN_AUTH=your_orkut_token_auth
+ORKUT_USERNAME=your_orkut_username
+```
+
+> **Catatan:** Untuk mendapatkan tokenKey, Anda bisa membelinya di halaman [https://api.wahdx.co](https://api.wahdx.co)
+
+### Opsi Konfigurasi
+
+| Opsi                | Deskripsi                                                        | Default     |
+|---------------------|------------------------------------------------------------------|-------------|
+| storeName           | Nama toko yang akan ditampilkan pada receipt                     | -           |
+| baseQrString        | Base QR string untuk generate QR secara lokal                    | -           |
+| tokenKey            | Token key dari WAHDX                                             | -           |
+| auth_token          | Token autentikasi OrderKuota                                     | -           |
+| auth_username       | Username OrderKuota                                              | -           |
+| autoGenerateReceipt | Mengaktifkan/menonaktifkan pembuatan receipt otomatis            | true        |
+
+## Penggunaan
+
+### Contoh Lengkap
+
+```javascript
+import QRISPayment from 'wahdx-api';
+import '@dotenvx/dotenvx/config';
+import fs from 'fs';
+
+// Konfigurasi
+const config = {
+    storeName: 'AHDX STORE',
+    baseQrString: 'base-qr-string-anda', // Diperlukan untuk generateQR secara lokal
+    tokenKey: process.env.WAHDX_TOKENKEY, // Diperlukan untuk generateQRFromAPI
+    auth_token: process.env.ORKUT_TOKEN_AUTH, // Diperlukan untuk generateQRFromAPI
+    auth_username: process.env.ORKUT_USERNAME, // Diperlukan untuk generateQRFromAPI
+    autoGenerateReceipt: true // Atur false jika tidak ingin otomatis membuat receipt
+};
+
+// Membuat instance QRISPayment
+const qrisPayment = new QRISPayment(config);
+
+async function main() {
+    try {
+        console.log('=== TEST REALTIME QRIS PAYMENT ===\n');
+        const randomAmount = Math.floor(Math.random() * 99) + 1; // Random 1-99
+        const amount = 100 + randomAmount; // Base 100 + random amount
+        const reference = 'REF' + Date.now();
+        
+        // Generate QR code menggunakan API OrderKuota
+        const { qrBuffer } = await qrisPayment.generateQRFromAPI(amount);
+        
+        // Save QR code image
+        fs.writeFileSync(`qr-${amount}.png`, qrBuffer);
+        
+        console.log('=== TRANSACTION DETAILS ===');
+        console.log('Reference:', reference);
+        console.log('Amount:', amount);
+        console.log('QR Image:', `qr-${amount}.png`);
+        console.log('\nSilakan scan QR code dan lakukan pembayaran');
+        console.log('\nMenunggu pembayaran...\n');
+
+        // Check payment status with 5 minutes timeout
+        const startTime = Date.now();
+        const timeout = 5 * 60 * 1000;
+
+        while (Date.now() - startTime < timeout) {
+            const result = await qrisPayment.checkPayment(reference, amount);
+            
+            if (result.success && result.data.status === 'PAID') {
+                console.log('✓ Pembayaran berhasil!');
+                if (result.receipt) {
+                    console.log('✓ Bukti transaksi:', result.receipt.filePath);
+                }
+                return;
+            }
+
+            await new Promise(resolve => setTimeout(resolve, 10000));   // delay 10 detik
+            console.log('Menunggu pembayaran...');
+        }
+
+        throw new Error('Timeout: Pembayaran tidak diterima dalam 5 menit');
+        
+    } catch (error) {
+        console.error('Error:', error.message);
+    }
+}
+
+main();
+```
+
+### API Reference
+
+#### Inisialisasi
+
+```javascript
+import QRISPayment from 'wahdx-api';
+
+const config = {
+    storeName: 'NAMA TOKO',
+    baseQrString: 'base-qr-string-anda', // Diperlukan untuk generateQR secara lokal
+    tokenKey: 'your_wahdx_token_key', // Diperlukan untuk generateQRFromAPI
+    auth_token: 'your_orkut_token_auth', // Diperlukan untuk generateQRFromAPI
+    auth_username: 'your_orkut_username', // Diperlukan untuk generateQRFromAPI
+    autoGenerateReceipt: true // Atur false jika tidak ingin otomatis membuat receipt
+};
+
+const qrisPayment = new QRISPayment(config);
+```
+
+#### Generate QR
+
+Ada dua metode untuk generate QR:
+
+##### 1. Generate QR secara lokal
+
+```javascript
+const amount = 10000; // Rp 10.000
+// Generate QR secara lokal menggunakan baseQrString
+const { qrString, qrBuffer } = await qrisPayment.generateQR(amount);
+
+// Simpan QR ke file
+fs.writeFileSync('qr-output.png', qrBuffer);
+```
+
+##### 2. Generate QR menggunakan API OrderKuota (Lebih direkomendasikan)
+
+```javascript
+const amount = 10000; // Rp 10.000
+// Generate QR menggunakan API OrderKuota
+const { qrString, qrBuffer } = await qrisPayment.generateQRFromAPI(amount);
+
+// Simpan QR ke file
+fs.writeFileSync('qr-output.png', qrBuffer);
+```
+
+> **Catatan:** Metode `generateQRFromAPI` lebih direkomendasikan karena QR code dihasilkan langsung dari server OrderKuota, sehingga lebih valid dan reliable.
+
+#### Cek Status Pembayaran
+
+```javascript
+const reference = 'REF' + Date.now();
+const amount = 10000;
+
+const result = await qrisPayment.checkPayment(reference, amount);
+console.log(result);
+/*
+Output jika berhasil:
+{
+  success: true,
+  data: {
+    status: 'PAID',
+    amount: 10000,
+    reference: 'REF1234567890',
+    ...
+  },
+  receipt: {
+    filePath: 'path/to/receipt.pdf',
+    ...
+  }
+}
+*/
+```
+
+#### Generate Receipt Secara Manual
+
+Jika Anda telah menonaktifkan `autoGenerateReceipt` dalam konfigurasi, Anda dapat menghasilkan receipt secara manual dengan metode berikut:
+
+```javascript
+// Ketika pembayaran sudah diterima
+const result = await qrisPayment.checkPayment(reference, amount);
+
+if (result.success && result.data.status === 'PAID') {
+  // Generate receipt secara manual
+  const receipt = await qrisPayment.generateReceipt(result.data);
+  console.log('Receipt berhasil dibuat:', receipt.filePath);
+}
+```
+
+## FAQ
+
+### Q: Bagaimana cara mendapatkan tokenKey agar bisa menggunakan module ini?
+A: Anda bisa membeli tokenKey di halaman utama [https://api.wahdx.co](https://api.wahdx.co)
+
+### Q: Bagaimana cara mendapatkan kredensial API OrderKuota?
+A: Silahkan kunjungi dokumentasi api [https://api.wahdx.co/api-docs](https://api.wahdx.co/api-docs) untuk mendapatkan token pada akun orderkuota anda.
+
+### Q: Apakah module ini bisa digunakan di project CommonJS?
+A: Ya! Package ini mendukung dual module system (ESM dan CommonJS). Anda bisa menggunakan dengan dua cara:
+
+1. Dengan ES Modules (dalam file .js dengan `type: "module"` di package.json):
+```javascript
+import QRISPayment from 'wahdx-api';
+
+const qrisPayment = new QRISPayment(config);
+// gunakan qrisPayment
+```
+
+2. Dengan CommonJS (dalam file .cjs atau project tanpa `type: "module"`):
+```javascript
+const QRISPayment = require('wahdx-api');
+
+const qrisPayment = new QRISPayment(config);
+// gunakan qrisPayment
+```
+
+Package secara otomatis mendeteksi format yang digunakan dan menyediakan versi yang sesuai.
+
+## Lisensi
+
 MIT

package/dist/index.cjs

@@ -4,20 +4,17 @@ const ReceiptGenerator = require("./receipt-generator.cjs");
 
 class QRISPayment {
     constructor(config = {}) {
+        // Default config
+        this.config = {
+            autoGenerateReceipt: true, // Default-nya adalah true untuk mempertahankan kompatibilitas
+            ...config
+        };
+        
         this.qrGenerator = new QRISGenerator(config);
         this.paymentChecker = new PaymentChecker(config);
         this.receiptGenerator = new ReceiptGenerator(config);
     }
 
-    /**
-     * Membaca QR code dari file gambar dan mengekstrak baseQrString
-     * @param {string} imagePath - Path ke file gambar QR
-     * @returns {Promise<string>} - Promise yang menghasilkan baseQrString
-     */
-    async readQRCode(imagePath) {
-        return await this.qrGenerator.readQRFromImage(imagePath);
-    }
-
     /**
      * Generate QR dengan nominal tertentu
      * @param {number} amount - Nominal pembayaran
@@ -28,18 +25,19 @@ class QRISPayment {
     }
 
     /**
-     * Membaca QR dari file gambar dan langsung menghasilkan QR baru dengan nominal
+     * Generate QR dengan nominal tertentu menggunakan API OrderKuota
      * @param {number} amount - Nominal pembayaran
-     * @param {string} qrImagePath - Path ke gambar QR (opsional)
      * @returns {Promise<{qrString: string, qrBuffer: Buffer}>}
      */
-    async generateQRFromImage(amount, qrImagePath = null) {
-        return await this.qrGenerator.generateQRFromImage(amount, qrImagePath);
+    async generateQRFromAPI(amount) {
+        return await this.qrGenerator.generateQRFromAPI(amount);
     }
 
     async checkPayment(reference, amount) {
         const result = await this.paymentChecker.checkPaymentStatus(reference, amount);
-        if (result.success && result.data.status === 'PAID') {
+        
+        // Cek apakah pembayaran sukses dan statusnya PAID, serta autoGenerateReceipt diaktifkan
+        if (result.success && result.data.status === 'PAID' && this.config.autoGenerateReceipt) {
             const receipt = await this.receiptGenerator.generateReceipt(result.data);
             result.receipt = receipt;
         }

package/dist/index.mjs

@@ -4,20 +4,17 @@ import ReceiptGenerator from './receipt-generator.mjs';
 
 class QRISPayment {
     constructor(config = {}) {
+        // Default config
+        this.config = {
+            autoGenerateReceipt: true, // Default-nya adalah true untuk mempertahankan kompatibilitas
+            ...config
+        };
+        
         this.qrGenerator = new QRISGenerator(config);
         this.paymentChecker = new PaymentChecker(config);
         this.receiptGenerator = new ReceiptGenerator(config);
     }
 
-    /**
-     * Membaca QR code dari file gambar dan mengekstrak baseQrString
-     * @param {string} imagePath - Path ke file gambar QR
-     * @returns {Promise<string>} - Promise yang menghasilkan baseQrString
-     */
-    async readQRCode(imagePath) {
-        return await this.qrGenerator.readQRFromImage(imagePath);
-    }
-
     /**
      * Generate QR dengan nominal tertentu
      * @param {number} amount - Nominal pembayaran
@@ -28,18 +25,19 @@ class QRISPayment {
     }
 
     /**
-     * Membaca QR dari file gambar dan langsung menghasilkan QR baru dengan nominal
+     * Generate QR dengan nominal tertentu menggunakan API OrderKuota
      * @param {number} amount - Nominal pembayaran
-     * @param {string} qrImagePath - Path ke gambar QR (opsional)
      * @returns {Promise<{qrString: string, qrBuffer: Buffer}>}
      */
-    async generateQRFromImage(amount, qrImagePath = null) {
-        return await this.qrGenerator.generateQRFromImage(amount, qrImagePath);
+    async generateQRFromAPI(amount) {
+        return await this.qrGenerator.generateQRFromAPI(amount);
     }
 
     async checkPayment(reference, amount) {
         const result = await this.paymentChecker.checkPaymentStatus(reference, amount);
-        if (result.success && result.data.status === 'PAID') {
+        
+        // Cek apakah pembayaran sukses dan statusnya PAID, serta autoGenerateReceipt diaktifkan
+        if (result.success && result.data.status === 'PAID' && this.config.autoGenerateReceipt) {
             const receipt = await this.receiptGenerator.generateReceipt(result.data);
             result.receipt = receipt;
         }

package/dist/payment-checker.cjs

@@ -1,4 +1,5 @@
 const axios = require("axios");
+const moment = require("moment-timezone");
 
 class PaymentChecker {
     constructor(config) {
@@ -40,11 +41,12 @@ class PaymentChecker {
             
             const matchingTransactions = transactions.filter(tx => {
                 const txAmount = parseInt(tx.amount);
-                const txDate = new Date(tx.date);
-                const now = new Date();
-                const timeDiff = now - txDate;
+                // Parse tanggal dengan timezone Jakarta
+                const txDate = moment.tz(tx.date, 'YYYY-MM-DD HH:mm', 'Asia/Jakarta');
+                const now = moment().tz("Asia/Jakarta");
+                const timeDiff = now.diff(txDate, 'milliseconds');
                 
-                return txAmount === amount && 
+                return txAmount === amount &&
                        tx.qris === "static" &&
                        tx.type === "CR" &&
                        timeDiff <= 5 * 60 * 1000;
@@ -52,9 +54,9 @@ class PaymentChecker {
 
             if (matchingTransactions.length > 0) {
                 const latestTransaction = matchingTransactions.reduce((latest, current) => {
-                    const currentDate = new Date(current.date);
-                    const latestDate = new Date(latest.date);
-                    return currentDate > latestDate ? current : latest;
+                    const currentDate = moment.tz(current.date, 'YYYY-MM-DD HH:mm', 'Asia/Jakarta');
+                    const latestDate = moment.tz(latest.date, 'YYYY-MM-DD HH:mm', 'Asia/Jakarta');
+                    return currentDate.isAfter(latestDate) ? current : latest;
                 });
                 
                 return {

package/dist/payment-checker.mjs

@@ -1,4 +1,5 @@
 import axios from 'axios';
+import moment from 'moment-timezone';
 
 class PaymentChecker {
     constructor(config) {
@@ -40,11 +41,12 @@ class PaymentChecker {
             
             const matchingTransactions = transactions.filter(tx => {
                 const txAmount = parseInt(tx.amount);
-                const txDate = new Date(tx.date);
-                const now = new Date();
-                const timeDiff = now - txDate;
+                // Parse tanggal dengan timezone Jakarta
+                const txDate = moment.tz(tx.date, 'YYYY-MM-DD HH:mm', 'Asia/Jakarta');
+                const now = moment().tz("Asia/Jakarta");
+                const timeDiff = now.diff(txDate, 'milliseconds');
                 
-                return txAmount === amount && 
+                return txAmount === amount &&
                        tx.qris === "static" &&
                        tx.type === "CR" &&
                        timeDiff <= 5 * 60 * 1000;
@@ -52,9 +54,9 @@ class PaymentChecker {
 
             if (matchingTransactions.length > 0) {
                 const latestTransaction = matchingTransactions.reduce((latest, current) => {
-                    const currentDate = new Date(current.date);
-                    const latestDate = new Date(latest.date);
-                    return currentDate > latestDate ? current : latest;
+                    const currentDate = moment.tz(current.date, 'YYYY-MM-DD HH:mm', 'Asia/Jakarta');
+                    const latestDate = moment.tz(latest.date, 'YYYY-MM-DD HH:mm', 'Asia/Jakarta');
+                    return currentDate.isAfter(latestDate) ? current : latest;
                 });
                 
                 return {