dra-qris-api 1.0.6 → 1.0.8

package/README.md

@@ -0,0 +1,253 @@
+<div align="center">
+
+# DRA QRIS API
+
+## QRIS Dinamis Generator + Auto Payment Handler
+
+Library Node.js untuk membuat QRIS, membaca bukti transfer secara otomatis, dan memverifikasi pembayaran melalui API.
+
+---
+
+<p align="center">
+  <img src="https://img.shields.io/badge/dra--qris--api-v1.0.4-purple?logo=npm" alt="Version"/>
+  <img src="https://img.shields.io/badge/Node.js-16%2B-green?logo=node.js" alt="Node.js"/>
+  <img src="https://img.shields.io/badge/OCR-Tesseract-blue?logo=tesseract" alt="OCR"/>
+  <img src="https://img.shields.io/badge/API-Secure-orange?logo=shield" alt="Secure"/>
+</p>
+
+</div>
+
+---
+
+## ⚡ Fitur Utama
+
+- ⚡ Generate QRIS dinamis otomatis
+- 🔍 Membaca foto bukti transfer otomatis
+- 🤖 Auto Payment Handler untuk bot WhatsApp (untuk saat ini hanya pada bot WhatsApp)
+- 🔐 HMAC Signature SHA-256 untuk keamanan request
+- 🗂️ Sangat mudah diintegrasikan ke bot / server mana pun
+
+---
+
+## 🛠️ Instalasi
+
+```
+npm i dra-qris-api
+```
+
+## 📁 Struktur Fungsi
+
+Library ini menyediakan 4 fitur utama:
+
+<table>
+  <thead>
+    <tr>
+      <th>Fungsi</th>
+      <th>Keterangan</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>createQris()</code></td>
+      <td>Membuat QRIS dan mengembalikan image buffer</td>
+    </tr>
+    <tr>
+      <td><code>submitProof()</code></td>
+      <td>Mengirim hasil OCR untuk verifikasi ke API</td>
+    </tr>
+    <tr>
+      <td><code>handlePaymentProof()</code></td>
+      <td>Handler otomatis untuk bukti transfer (gambar)</td>
+    </tr>
+    <tr>
+      <td><code>globalPending</code></td>
+      <td>Store transaksi yang sedang menunggu pembayaran</td>
+    </tr>
+  </tbody>
+</table>
+
+## 🧠 Arsitektur Singkat
+
+```mermaid
+flowchart TD
+  A["User Kirim Command Order"] --> B["createQris()"]
+  B --> C["Generate QRIS + ID"]
+  C --> D["Simpan ke globalPending"]
+  D --> E["User Kirim Bukti Transfer"]
+  E --> F["handlePaymentProof()"]
+  F --> G["OCR Tesseract"]
+  G --> H["submitProof()"]
+  H --> I{"Status Paid?"}
+  I -->|YES| J["Success Callback (bot handle)"]
+  I -->|NO| K["Reply: Pembayaran belum valid"]
+```
+
+## 🚀 Cara Penggunaan
+
+### 1. Import Function
+
+```js
+const {
+  createQris,
+  submitProof,
+  handlePaymentProof,
+  globalPending,
+} = require("dra-qris-api");
+```
+
+### 2. Generate QRIS
+
+```js
+const { id, buffer } = await createQris({
+  nominal: 15000,
+  merchantName: "NAMA MERCHANT",
+  qris: "STRING_QRIS",
+  apikey: "API_KEY", // Hubungi admin atau kunjungi https://api.denayrestapi.xyz untuk mendapatkan apikey
+});
+```
+
+Simpan transaksi:
+
+```js
+globalPending[userId] = {
+  id,
+  nominal: 15000,
+  merchantName: "NAMA MERCHANT",
+  description: "Pembelian Paket Premium",
+  meta: { type: "premium" },
+};
+```
+
+### 3. Handler Bukti Transfer
+
+```js
+if (m.message?.imageMessage) {
+  const result = await handlePaymentProof({
+    m,
+    NekonoidF,
+    reply,
+    botname: "MyBot",
+    apiKey: "API_KEY_KAMU", // Hubungi admin atau kunjungi https://api.denayrestapi.xyz untuk mendapatkan apikey
+  });
+
+  if (!result) return; // gambar biasa bukan bukti tf
+
+  if (result.status === "paid") {
+    await reply("🎉 Pembayaran berhasil diterima!");
+  }
+}
+```
+
+### 4. Struktur Return dari handlePaymentProof()
+
+```js
+{
+  status: "paid",
+  ocrAmount: 15000,
+  ocrText: "...hasil bukti transfer...",
+  pending: {
+    id: "...",
+    nominal: 15000,
+    merchantName: "NAMA MERCHANT",
+    description: "Pembelian Paket Premium",
+    meta: {...},
+  },
+  apiResult: {...}
+}
+```
+
+## 📦 Fitur: globalPending
+
+Contoh penyimpanan transaksi:
+
+```js
+globalPending["628xxx@s.whatsapp.net"] = {
+  id: "PAY123",
+  nominal: 20000,
+  description: "Topup Saldo",
+  meta: {
+    type: "topup",
+    amount: 20000,
+  },
+};
+```
+
+Menghapus transaksi:
+
+```js
+delete globalPending[m.sender];
+```
+
+## Implementasi Lengkap
+
+```js
+if (m.message?.imageMessage) {
+  const result = await handlePaymentProof({
+    m,
+    NekonoidF: conn,
+    reply: (txt) => conn.sendMessage(m.chat, { text: txt }),
+    botname: "BotDigital",
+    apiKey: "API_KEY", // Hubungi admin atau kunjungi https://api.denayrestapi.xyz untuk mendapatkan apikey
+  });
+
+  if (result?.status === "paid") {
+    if (result.pending.meta.product === "A") {
+      // kasih produk
+    }
+  }
+}
+
+switch (command) {
+  case "buy":
+    {
+      const basePrice = 20000;
+
+      // Kode unik untuk mencegah gambar palsu
+      const uniqueCode = Math.floor(Math.random() * 100); // 0 - 99
+      const nominal = basePrice + uniqueCode;
+
+      const { id, buffer } = await createQris({
+        nominal,
+        merchantName: "TOKO SAYA",
+        qris: "QRIS STRING",
+        apikey: "API_KEY", // Hubungi admin atau kunjungi https://api.denayrestapi.xyz untuk mendapatkan apikey
+      });
+
+      globalPending[m.sender] = {
+        id,
+        nominal,
+        description: "Pembelian Produk A",
+        meta: { product: "A", uniqueCode },
+      };
+
+      await conn.sendMessage(m.chat, {
+        image: Buffer.from(buffer),
+        caption: `💳 *Pembayaran Produk A*\nNominal: Rp${nominal}\n\nSilakan scan QRIS dan unggah bukti transfer.`,
+      });
+    }
+    break;
+}
+```
+
+## 🛡️ Keamanan
+
+- Semua request memakai HMAC-SHA256 signature
+- Timestamp + request-id otomatis
+
+## NOTE
+
+> Ini hanya menggunakan metode validasi pembayaran via bukti transfer, tidak melakukan pembayaran otomatis layaknya API QRIS langsung. Silahkan gunakan API QRIS langsung jika cara ini terbilang rumit, cara ini hanya sebagai alternatif.
+
+## 👨‍💻 Sosial Media Kreator
+
+<p align="center">
+  <a href="https://github.com/irukadevsindie">
+    <img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white"/>
+  </a>
+  <a href="https://t.me/irukaid">
+    <img src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"/>
+  </a>
+  <a href="https://instagram.com/irukadevs.id">
+    <img src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white"/>
+  </a>
+</p>

package/dist/chunk-4NA4NJ4G.js

@@ -0,0 +1,390 @@
+// lib/merchantBalanceManager.js
+import axios from "axios";
+import crypto from "crypto";
+var MerchantBalanceManager = class {
+  constructor() {
+    this.balances = /* @__PURE__ */ new Map();
+    this.mutations = /* @__PURE__ */ new Map();
+    this.transactions = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Hash API key untuk privacy
+   */
+  hashApiKey(apiKey) {
+    return crypto.createHash("sha256").update(apiKey).digest("hex").substring(0, 16);
+  }
+  /**
+   * Update merchant balance setelah payment berhasil
+   */
+  async updateBalance({
+    apiKey,
+    merchantName,
+    transactionId,
+    amount,
+    description
+  }) {
+    const merchantHash = this.hashApiKey(apiKey);
+    const key = `${merchantHash}:${merchantName}`;
+    let balanceData = this.balances.get(key) || {
+      merchantHash,
+      merchantName,
+      balance: 0,
+      totalTransactions: 0,
+      totalIncome: 0,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const balanceBefore = balanceData.balance;
+    const balanceAfter = balanceBefore + amount;
+    balanceData.balance = balanceAfter;
+    balanceData.totalTransactions += 1;
+    balanceData.totalIncome += amount;
+    balanceData.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.balances.set(key, balanceData);
+    const mutation = {
+      transactionId,
+      amount,
+      description,
+      balanceBefore,
+      balanceAfter,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const mutationKey = `${key}:${Date.now()}_${transactionId}`;
+    if (!this.mutations.has(key)) {
+      this.mutations.set(key, []);
+    }
+    this.mutations.get(key).push(mutation);
+    this.transactions.set(transactionId, {
+      merchantHash,
+      merchantName,
+      amount,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    return {
+      merchantName,
+      amount,
+      balanceBefore,
+      balanceAfter,
+      timestamp: mutation.timestamp
+    };
+  }
+  /**
+   * Get merchant balance
+   */
+  async getBalance(apiKey, merchantName = null) {
+    const merchantHash = this.hashApiKey(apiKey);
+    if (merchantName) {
+      const key = `${merchantHash}:${merchantName}`;
+      return this.balances.get(key) || null;
+    }
+    const results = [];
+    for (const [key, value] of this.balances.entries()) {
+      if (key.startsWith(merchantHash + ":")) {
+        results.push(value);
+      }
+    }
+    return results;
+  }
+  /**
+   * Get balance mutations (transaction history)
+   */
+  async getMutations(apiKey, merchantName = null, limit = 50) {
+    const merchantHash = this.hashApiKey(apiKey);
+    if (merchantName) {
+      const key = `${merchantHash}:${merchantName}`;
+      const mutations = this.mutations.get(key) || [];
+      return mutations.slice(-limit).reverse();
+    }
+    const allMutations = [];
+    for (const [key, value] of this.mutations.entries()) {
+      if (key.startsWith(merchantHash + ":")) {
+        allMutations.push(...value);
+      }
+    }
+    allMutations.sort(
+      (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
+    );
+    return allMutations.slice(0, limit);
+  }
+  /**
+   * Get merchant statistics
+   */
+  async getMerchantStats(apiKey, merchantName = null) {
+    const merchantHash = this.hashApiKey(apiKey);
+    if (merchantName) {
+      const key = `${merchantHash}:${merchantName}`;
+      const balance = this.balances.get(key);
+      if (!balance) {
+        return {
+          totalTransactions: 0,
+          totalIncome: 0,
+          balance: 0,
+          merchantName
+        };
+      }
+      return {
+        totalTransactions: balance.totalTransactions,
+        totalIncome: balance.totalIncome,
+        balance: balance.balance,
+        merchantName: balance.merchantName,
+        createdAt: balance.createdAt,
+        updatedAt: balance.updatedAt
+      };
+    }
+    let totalTransactions = 0;
+    let totalIncome = 0;
+    let totalBalance = 0;
+    let merchantCount = 0;
+    for (const [key, value] of this.balances.entries()) {
+      if (key.startsWith(merchantHash + ":")) {
+        totalTransactions += value.totalTransactions;
+        totalIncome += value.totalIncome;
+        totalBalance += value.balance;
+        merchantCount++;
+      }
+    }
+    return {
+      merchantCount,
+      totalTransactions,
+      totalIncome,
+      totalBalance,
+      averageBalance: merchantCount > 0 ? totalBalance / merchantCount : 0
+    };
+  }
+  /**
+   * Get transaction history dengan filtering
+   */
+  async getTransactionHistory(apiKey, filters = {}) {
+    const merchantHash = this.hashApiKey(apiKey);
+    const {
+      merchantName,
+      status,
+      startDate,
+      endDate,
+      minAmount,
+      maxAmount,
+      limit = 100
+    } = filters;
+    const mutations = await this.getMutations(apiKey, merchantName, 1e3);
+    let filtered = [...mutations];
+    if (startDate) {
+      const start = new Date(startDate).getTime();
+      filtered = filtered.filter(
+        (m) => new Date(m.timestamp).getTime() >= start
+      );
+    }
+    if (endDate) {
+      const end = new Date(endDate).getTime();
+      filtered = filtered.filter((m) => new Date(m.timestamp).getTime() <= end);
+    }
+    if (minAmount) {
+      filtered = filtered.filter((m) => m.amount >= minAmount);
+    }
+    if (maxAmount) {
+      filtered = filtered.filter((m) => m.amount <= maxAmount);
+    }
+    return filtered.slice(0, limit);
+  }
+  /**
+   * Get daily sales summary
+   */
+  async getDailySales(apiKey, merchantName = null, date = null) {
+    const targetDate = date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const mutations = await this.getMutations(apiKey, merchantName, 1e3);
+    const dailyMutations = mutations.filter(
+      (m) => m.timestamp.startsWith(targetDate)
+    );
+    const totalSales = dailyMutations.reduce((sum, m) => sum + m.amount, 0);
+    const transactionCount = dailyMutations.length;
+    return {
+      date: targetDate,
+      merchantName,
+      totalSales,
+      transactionCount,
+      averageTransaction: transactionCount > 0 ? totalSales / transactionCount : 0,
+      transactions: dailyMutations
+    };
+  }
+  /**
+   * Get monthly report
+   */
+  async getMonthlyReport(apiKey, merchantName = null, year = null, month = null) {
+    const now = /* @__PURE__ */ new Date();
+    const targetYear = year || now.getFullYear();
+    const targetMonth = month || now.getMonth() + 1;
+    const monthStr = `${targetYear}-${String(targetMonth).padStart(2, "0")}`;
+    const mutations = await this.getMutations(apiKey, merchantName, 1e4);
+    const monthlyMutations = mutations.filter(
+      (m) => m.timestamp.startsWith(monthStr)
+    );
+    const totalRevenue = monthlyMutations.reduce((sum, m) => sum + m.amount, 0);
+    const transactionCount = monthlyMutations.length;
+    const dailyBreakdown = {};
+    monthlyMutations.forEach((m) => {
+      const day = m.timestamp.split("T")[0];
+      if (!dailyBreakdown[day]) {
+        dailyBreakdown[day] = {
+          date: day,
+          totalSales: 0,
+          transactionCount: 0
+        };
+      }
+      dailyBreakdown[day].totalSales += m.amount;
+      dailyBreakdown[day].transactionCount += 1;
+    });
+    return {
+      year: targetYear,
+      month: targetMonth,
+      merchantName,
+      totalRevenue,
+      transactionCount,
+      averageTransaction: transactionCount > 0 ? totalRevenue / transactionCount : 0,
+      dailyBreakdown: Object.values(dailyBreakdown).sort(
+        (a, b) => a.date.localeCompare(b.date)
+      )
+    };
+  }
+  /**
+   * Export data untuk backup/reporting
+   */
+  async exportData(apiKey, format = "json") {
+    const merchantHash = this.hashApiKey(apiKey);
+    const balances = await this.getBalance(apiKey);
+    const mutations = await this.getMutations(apiKey, null, 1e4);
+    const stats = await this.getMerchantStats(apiKey);
+    const data = {
+      exportDate: (/* @__PURE__ */ new Date()).toISOString(),
+      merchantHash,
+      balances,
+      mutations,
+      stats
+    };
+    if (format === "json") {
+      return JSON.stringify(data, null, 2);
+    }
+    if (format === "csv") {
+      let csv = "Date,Merchant,Amount,Balance Before,Balance After,Description\n";
+      mutations.forEach((m) => {
+        const balance = balances.find((b) => b.merchantName === m.merchantName);
+        csv += `${m.timestamp},${(balance == null ? void 0 : balance.merchantName) || "N/A"},${m.amount},${m.balanceBefore},${m.balanceAfter},"${m.description}"
+`;
+      });
+      return csv;
+    }
+    return data;
+  }
+  /**
+   * Reset balance (untuk testing atau koreksi)
+   */
+  async resetBalance(apiKey, merchantName) {
+    const merchantHash = this.hashApiKey(apiKey);
+    const key = `${merchantHash}:${merchantName}`;
+    this.balances.delete(key);
+    this.mutations.delete(key);
+    return {
+      success: true,
+      message: `Balance reset for ${merchantName}`
+    };
+  }
+  /**
+   * Sync dengan API eksternal (untuk production)
+   */
+  async syncWithAPI(apiKey, baseURL) {
+    var _a;
+    try {
+      const balanceResp = await axios.get(`${baseURL}/api/qris?op=balance`, {
+        headers: { "x-api-key": apiKey }
+      });
+      const mutationsResp = await axios.get(
+        `${baseURL}/api/qris?op=balance-mutations&limit=100`,
+        {
+          headers: { "x-api-key": apiKey }
+        }
+      );
+      if (balanceResp.data.balance) {
+        const balance = balanceResp.data.balance;
+        const merchantHash = this.hashApiKey(apiKey);
+        const key = `${merchantHash}:${balance.merchantName}`;
+        this.balances.set(key, balance);
+      }
+      if (mutationsResp.data.mutations) {
+        const mutations = mutationsResp.data.mutations;
+        mutations.forEach((mutation) => {
+          var _a2;
+          const merchantHash = this.hashApiKey(apiKey);
+          const merchantName = ((_a2 = mutation.description.match(/from (.+)$/)) == null ? void 0 : _a2[1]) || "Unknown";
+          const key = `${merchantHash}:${merchantName}`;
+          if (!this.mutations.has(key)) {
+            this.mutations.set(key, []);
+          }
+          this.mutations.get(key).push(mutation);
+        });
+      }
+      return {
+        success: true,
+        synced: {
+          balances: 1,
+          mutations: ((_a = mutationsResp.data.mutations) == null ? void 0 : _a.length) || 0
+        }
+      };
+    } catch (err) {
+      console.error("Sync error:", err);
+      return {
+        success: false,
+        error: err.message
+      };
+    }
+  }
+  /**
+   * Get top merchants by revenue
+   */
+  async getTopMerchants(apiKey, limit = 10) {
+    const balances = await this.getBalance(apiKey);
+    return balances.sort((a, b) => b.totalIncome - a.totalIncome).slice(0, limit).map((balance, index) => ({
+      rank: index + 1,
+      merchantName: balance.merchantName,
+      totalIncome: balance.totalIncome,
+      totalTransactions: balance.totalTransactions,
+      averageTransaction: balance.totalIncome / balance.totalTransactions,
+      currentBalance: balance.balance
+    }));
+  }
+  /**
+   * Calculate growth rate
+   */
+  async getGrowthRate(apiKey, merchantName, days = 7) {
+    const mutations = await this.getMutations(apiKey, merchantName, 1e3);
+    const now = /* @__PURE__ */ new Date();
+    const periodStart = new Date(now.getTime() - days * 24 * 60 * 60 * 1e3);
+    const recentMutations = mutations.filter(
+      (m) => new Date(m.timestamp).getTime() >= periodStart.getTime()
+    );
+    const currentPeriodRevenue = recentMutations.reduce(
+      (sum, m) => sum + m.amount,
+      0
+    );
+    const prevPeriodStart = new Date(
+      periodStart.getTime() - days * 24 * 60 * 60 * 1e3
+    );
+    const prevMutations = mutations.filter((m) => {
+      const ts = new Date(m.timestamp).getTime();
+      return ts >= prevPeriodStart.getTime() && ts < periodStart.getTime();
+    });
+    const previousPeriodRevenue = prevMutations.reduce(
+      (sum, m) => sum + m.amount,
+      0
+    );
+    const growthRate = previousPeriodRevenue > 0 ? (currentPeriodRevenue - previousPeriodRevenue) / previousPeriodRevenue * 100 : 0;
+    return {
+      period: `${days} days`,
+      currentPeriodRevenue,
+      previousPeriodRevenue,
+      growthRate: parseFloat(growthRate.toFixed(2)),
+      trend: growthRate > 0 ? "up" : growthRate < 0 ? "down" : "stable"
+    };
+  }
+};
+
+export {
+  MerchantBalanceManager
+};