wahdx-api 1.0.0 → 1.0.2

package/README.md

@@ -25,6 +25,8 @@ 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
@@ -152,10 +154,35 @@ Output jika berhasil:
 */
 ```
 
-## Persyaratan Sistem
+## 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
+```
 
-- Node.js >= 20.18.3
+Package secara otomatis mendeteksi format yang digunakan dan menyediakan versi yang sesuai.
 
 ## Lisensi
 
-MIT 
+MIT

package/dist/index.cjs

@@ -0,0 +1,61 @@
+const QRISGenerator = require("./qr-generator.cjs");
+const PaymentChecker = require("./payment-checker.cjs");
+const ReceiptGenerator = require("./receipt-generator.cjs");
+
+class QRISPayment {
+    constructor(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
+     * @returns {Promise<{qrString: string, qrBuffer: Buffer}>}
+     */
+    async generateQR(amount) {
+        const qrString = this.qrGenerator.generateQrString(amount);
+        const qrBuffer = await this.qrGenerator.generateQRWithLogo(qrString);
+        return {
+            qrString,
+            qrBuffer
+        };
+    }
+
+    /**
+     * Membaca QR dari file gambar dan langsung menghasilkan QR baru dengan nominal
+     * @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 checkPayment(reference, amount) {
+        const result = await this.paymentChecker.checkPaymentStatus(reference, amount);
+        if (result.success && result.data.status === 'PAID') {
+            const receipt = await this.receiptGenerator.generateReceipt(result.data);
+            result.receipt = receipt;
+        }
+        
+        return result;
+    }
+
+    async generateReceipt(transactionData) {
+        return await this.receiptGenerator.generateReceipt(transactionData);
+    }
+}
+
+// Mengekspor kelas utama
+module.exports = QRISPayment;

package/dist/{index.js → index.mjs}

@@ -1,6 +1,6 @@
-import QRISGenerator from './qr-generator.js';
-import PaymentChecker from './payment-checker.js';
-import ReceiptGenerator from './receipt-generator.js';
+import QRISGenerator from './qr-generator.mjs';
+import PaymentChecker from './payment-checker.mjs';
+import ReceiptGenerator from './receipt-generator.mjs';
 
 class QRISPayment {
     constructor(config = {}) {

package/dist/payment-checker.cjs

@@ -0,0 +1,90 @@
+const axios = require("axios");
+
+class PaymentChecker {
+    constructor(config) {
+        if (!config.tokenKey || !config.auth_username || !config.auth_token) {
+            throw new Error('tokenKey, auth_username, dan auth_token harus diisi');
+        }
+        this.config = {
+            tokenKey: config.tokenKey,
+            auth_username: config.auth_username,
+            auth_token: config.auth_token
+        };
+    }
+    
+    async checkPaymentStatus(reference, amount) {
+        try {
+            if (!reference || !amount || amount <= 0) {
+                throw new Error('Reference dan amount harus diisi dengan benar');
+            }
+            
+            const response = await axios.post(
+                'https://api.wahdx.co/api/mutasi-orkut-v2',
+                {
+                    username_orkut: this.config.auth_username,
+                    token_orkut: this.config.auth_token
+                },
+                {
+                    headers: {
+                        'tokenKey': this.config.tokenKey,
+                        'Content-Type': 'application/json'
+                    }
+                }
+            );
+            
+            if (!response.data || !response.data.status || !response.data.data) {
+                throw new Error('Response tidak valid dari server');
+            }
+            
+            const transactions = response.data.data;
+            
+            const matchingTransactions = transactions.filter(tx => {
+                const txAmount = parseInt(tx.amount);
+                const txDate = new Date(tx.date);
+                const now = new Date();
+                const timeDiff = now - txDate;
+                
+                return txAmount === amount && 
+                       tx.qris === "static" &&
+                       tx.type === "CR" &&
+                       timeDiff <= 5 * 60 * 1000;
+            });
+
+            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;
+                });
+                
+                return {
+                    success: true,
+                    data: {
+                        status: 'PAID',
+                        amount: parseInt(latestTransaction.amount),
+                        reference: latestTransaction.issuer_reff,
+                        date: latestTransaction.date,
+                        brand_name: latestTransaction.brand_name,
+                        buyer_reff: latestTransaction.buyer_reff
+                    }
+                };
+            }
+            
+            return {
+                success: true,
+                data: {
+                    status: 'UNPAID',
+                    amount: amount,
+                    reference: reference
+                }
+            };
+        } catch (error) {
+            return {
+                success: false,
+                error: 'Gagal cek status pembayaran: ' + error.message
+            };
+        }
+    }
+}
+
+module.exports = PaymentChecker;

package/dist/qr-generator.cjs

@@ -0,0 +1,199 @@
+const QRCode = require("qrcode");
+const { createCanvas, loadImage  } = require("canvas");
+const fs = require("fs");
+const sharp = require("sharp");
+const jsQR = require("jsqr");
+const path = require("path");
+// CJS sudah menyediakan __filename dan __dirname secara otomatis
+
+class QRISGenerator {
+    constructor(config = {}) {
+        this.config = {
+            baseQrString: config.baseQrString || '',
+            logoPath: config.logoPath || null,
+            defaultQrPath: config.defaultQrPath || 'QRIS.png'
+        };
+    }
+
+    /**
+     * Membaca QR code dari gambar dan mengekstrak baseQrString
+     * @param {string} imagePath - Path relatif atau absolut ke file gambar QR
+     * @returns {Promise<string>} - Promise yang menghasilkan baseQrString
+     */
+    async readQRFromImage(imagePath) {
+        try {
+            // Konversi path relatif ke absolut jika diperlukan
+            const absolutePath = path.isAbsolute(imagePath) 
+                ? imagePath 
+                : path.resolve(process.cwd(), imagePath);
+            
+            // Periksa apakah file ada
+            if (!fs.existsSync(absolutePath)) {
+                throw new Error(`File tidak ditemukan: ${absolutePath}`);
+            }
+            
+            // Baca gambar menggunakan Sharp
+            const image = sharp(absolutePath);
+            const metadata = await image.metadata();
+            const { width, height } = metadata;
+            
+            // Konversi ke raw pixel data
+            const rawData = await image
+                .raw()
+                .toBuffer();
+            
+            // Format data untuk jsQR
+            const imageData = new Uint8ClampedArray(width * height * 4);
+            
+            for (let i = 0; i < rawData.length; i += 3) { // RGB format
+                const pixelIndex = (i / 3) * 4; // Convert RGB index to RGBA index
+                imageData[pixelIndex] = rawData[i];     // R
+                imageData[pixelIndex + 1] = rawData[i + 1]; // G
+                imageData[pixelIndex + 2] = rawData[i + 2]; // B
+                imageData[pixelIndex + 3] = 255;            // A (full opacity)
+            }
+            
+            // Dekode QR code menggunakan jsQR
+            const code = jsQR(imageData, width, height);
+            
+            if (code) {
+                // Simpan baseQrString yang dibaca ke config
+                this.config.baseQrString = code.data;
+                return code.data;
+            } else {
+                throw new Error('QR code tidak terdeteksi dalam gambar');
+            }
+        } catch (error) {
+            console.error('Error saat membaca QR code:', error);
+            throw error;
+        }
+    }
+
+    /**
+     * Membaca QR code dari file default (biasanya QRIS.png)
+     * @returns {Promise<string>} - Promise yang menghasilkan baseQrString
+     */
+    async readDefaultQR() {
+        try {
+            // Path default ke file QRIS.png
+            const defaultPath = path.resolve(process.cwd(), this.config.defaultQrPath);
+            return await this.readQRFromImage(defaultPath);
+        } catch (error) {
+            console.error(`Error saat membaca gambar default (${this.config.defaultQrPath}):`, error);
+            throw error;
+        }
+    }
+
+    async generateQRWithLogo(qrString) {
+        try {
+            if (!qrString) {
+                throw new Error('qrString tidak boleh kosong');
+            }
+            const canvas = createCanvas(500, 500);
+            const ctx = canvas.getContext('2d');
+            await QRCode.toCanvas(canvas, qrString, {
+                errorCorrectionLevel: 'H',
+                margin: 2,
+                width: 500,
+                color: {
+                    dark: '#000000',
+                    light: '#ffffff'
+                }
+            });
+            if (this.config.logoPath && fs.existsSync(this.config.logoPath)) {
+                const logo = await loadImage(this.config.logoPath);
+                const logoSize = canvas.width * 0.2;
+                const logoPosition = (canvas.width - logoSize) / 2;
+
+                ctx.fillStyle = '#FFFFFF';
+                ctx.fillRect(logoPosition - 5, logoPosition - 5, logoSize + 10, logoSize + 10);
+                ctx.drawImage(logo, logoPosition, logoPosition, logoSize, logoSize);
+            }
+            return canvas.toBuffer('image/png');
+        } catch (error) {
+            throw new Error('Gagal generate QR: ' + error.message);
+        }
+    }
+
+    /**
+     * Membaca QR dari file kemudian generate QR baru dengan nominal
+     * @param {number} amount - Nominal pembayaran
+     * @param {string} qrImagePath - Path ke gambar QR (opsional)
+     * @returns {Promise<{qrString: string, qrBuffer: Buffer}>}
+     */
+    async generateQRFromImage(amount, qrImagePath = null) {
+        try {
+            // Jika path gambar disediakan, baca dari path tersebut
+            if (qrImagePath) {
+                await this.readQRFromImage(qrImagePath);
+            } 
+            // Jika tidak ada path dan baseQrString kosong, gunakan default
+            else if (!this.config.baseQrString) {
+                await this.readDefaultQR();
+            }
+            
+            // Generate QR string dengan nominal
+            const qrString = this.generateQrString(amount);
+            
+            // Generate QR image
+            const qrBuffer = await this.generateQRWithLogo(qrString);
+            
+            return {
+                qrString,
+                qrBuffer
+            };
+        } catch (error) {
+            throw new Error('Gagal generate QR dari gambar: ' + error.message);
+        }
+    }
+
+    generateQrString(amount) {
+        try {
+            if (!amount || amount <= 0) {
+                throw new Error('Nominal harus lebih besar dari 0');
+            }
+            
+            if (!this.config.baseQrString) {
+                throw new Error('BaseQrString tidak tersedia. Gunakan readQRFromImage terlebih dahulu atau berikan baseQrString pada config.');
+            }
+            
+            if (!this.config.baseQrString.includes("5802ID")) {
+                throw new Error("Format QRIS tidak valid");
+            }
+            
+            const finalAmount = Math.floor(amount);
+            const qrisBase = this.config.baseQrString.slice(0, -4).replace("010211", "010212");
+            const nominalStr = finalAmount.toString();
+            const nominalTag = `54${nominalStr.length.toString().padStart(2, '0')}${nominalStr}`;
+            const insertPosition = qrisBase.indexOf("5802ID");
+            const qrisWithNominal = qrisBase.slice(0, insertPosition) + nominalTag + qrisBase.slice(insertPosition);
+            const checksum = this.calculateCRC16(qrisWithNominal);
+            
+            return qrisWithNominal + checksum;
+        } catch (error) {
+            throw new Error('Gagal generate string QRIS: ' + error.message);
+        }
+    }
+
+    calculateCRC16(str) {
+        try {
+            if (!str) {
+                throw new Error('String tidak boleh kosong');
+            }
+
+            let crc = 0xFFFF;
+            for (let i = 0; i < str.length; i++) {
+                crc ^= str.charCodeAt(i) << 8;
+                for (let j = 0; j < 8; j++) {
+                    crc = (crc & 0x8000) ? ((crc << 1) ^ 0x1021) : (crc << 1);
+                }
+                crc &= 0xFFFF;
+            }
+            return crc.toString(16).toUpperCase().padStart(4, '0');
+        } catch (error) {
+            throw new Error('Gagal kalkulasi CRC16: ' + error.message);
+        }
+    }
+}
+
+module.exports = QRISGenerator;

package/dist/receipt-generator.cjs

@@ -0,0 +1,130 @@
+const PDFDocument = require("pdfkit");
+const fs = require("fs");
+const moment = require("moment");
+const path = require("path");
+
+class ReceiptGenerator {
+    constructor(config) {
+        this.config = config;
+    }
+
+    async generateReceipt(transactionData) {
+        return new Promise((resolve, reject) => {
+            try {
+                const doc = new PDFDocument({
+                    size: [300, 450],
+                    margin: 20,
+                    layout: 'portrait'
+                });
+
+                const fileName = `receipt_${transactionData.reference}_${Date.now()}.pdf`;
+                const filePath = `receipts/${fileName}`;
+                if (!fs.existsSync('receipts')) {
+                    fs.mkdirSync('receipts');
+                }
+                const writeStream = fs.createWriteStream(filePath);
+                doc.pipe(writeStream);
+
+                if (this.config.logoPath && fs.existsSync(this.config.logoPath)) {
+                    const logoWidth = 40;
+                    const logoHeight = 40;
+                    const logoX = 20 + (260 - logoWidth) / 2;
+                    const logoY = 10;
+                    doc.image(this.config.logoPath, logoX, logoY, { width: logoWidth, height: logoHeight });
+                    doc.y = logoY + logoHeight + 4;
+                } else {
+                    doc.moveDown(0.5);
+                }
+
+                doc.fontSize(14)
+                   .fillColor('black')
+                   .font('Helvetica-Bold');
+                const headerText = 'QRIS PAYMENT RECEIPT';
+                const headerWidth = doc.widthOfString(headerText);
+                doc.text(headerText, 20 + (260 - headerWidth) / 2, doc.y, { width: headerWidth });
+
+                doc.fontSize(9)
+                   .font('Helvetica');
+                const merchantText = this.config.storeName || 'STORE NAME';
+                const merchantWidth = doc.widthOfString(merchantText);
+                doc.text(merchantText, 20 + (260 - merchantWidth) / 2, doc.y, { width: merchantWidth });
+
+                doc.moveDown(0.3);
+                const lineY = doc.y;
+                doc.moveTo(20, lineY)
+                   .lineTo(280, lineY)
+                   .strokeColor('#888').stroke();
+
+                doc.moveDown(0.5);
+                doc.fontSize(9)
+                   .font('Helvetica-Bold');
+                const detailsTitle = 'TRANSACTION DETAILS';
+                const detailsTitleWidth = doc.widthOfString(detailsTitle);
+                doc.text(detailsTitle, 20 + (260 - detailsTitleWidth) / 2, doc.y, { width: detailsTitleWidth });
+                doc.moveDown(0.2);
+
+                const formattedDate = moment(transactionData.date).format('DD/MM/YYYY HH:mm:ss');
+                const details = [
+                    ['Reference', transactionData.reference],
+                    ['Date', formattedDate],
+                    ['Amount', `Rp ${transactionData.amount.toLocaleString('id-ID')}`],
+                    ['Status', transactionData.status],
+                    ['Payment Method', transactionData.brand_name || '-'],
+                    ['Buyer Reference', transactionData.buyer_reff || '-']
+                ];
+
+                const tableWidth = 240;
+                const startX = (300 - tableWidth) / 2;
+                const labelWidth = 100;
+                const valueWidth = 130;
+                let y = doc.y + 5;
+
+                details.forEach(([label, value], idx) => {
+                    doc.font('Helvetica-Bold')
+                       .fontSize(9)
+                       .fillColor('black')
+                       .text(label, startX, y, { width: labelWidth, align: 'left' });
+                    doc.font('Helvetica')
+                       .fontSize(9)
+                       .fillColor('black')
+                       .text(value, startX + labelWidth, y, { width: valueWidth, align: 'right' });
+
+                    y += 14;
+                    doc.moveTo(startX, y)
+                       .lineTo(startX + labelWidth + valueWidth, y)
+                       .strokeColor('#e0e0e0').stroke();
+                    y += 2;
+                });
+
+                y += 6;
+                doc.moveTo(20, y)
+                   .lineTo(280, y)
+                   .strokeColor('#888').stroke();
+
+                y += 12;
+                doc.text('Thank you for your payment!', 0, y, { align: 'right', width: 260 });
+                y += 12;
+                doc.text(`Receipt No: ${transactionData.reference}`, 0, y, { align: 'right', width: 260 });
+
+                doc.end();
+
+                writeStream.on('finish', () => {
+                    resolve({
+                        success: true,
+                        filePath: filePath,
+                        fileName: fileName
+                    });
+                });
+
+                writeStream.on('error', (error) => {
+                    reject(error);
+                });
+
+            } catch (error) {
+                reject(error);
+            }
+        });
+    }
+}
+
+module.exports = ReceiptGenerator;

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "wahdx-api",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Package untuk generate QRIS dan cek payment status secara realtime dengan API OrderKuota dari https://api.wahdx.co",
-  "main": "dist/index.js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs"
+    }
+  },
   "author": "wahdalo",
   "license": "MIT",
   "type": "module",
@@ -17,7 +24,8 @@
   ],
   "scripts": {
     "test": "node tes.js",
-    "start": "node dist/index.js",
+    "test:cjs": "node tes-cjs.cjs",
+    "start": "node dist/index.mjs",
     "build": "node scripts/build.js",
     "prepublishOnly": "npm run build",
     "pack": "npm pack --dry-run"