zakkistore-sdk 1.0.0 → 1.0.2

package/README.md

@@ -4,8 +4,6 @@
   <p><b>Node.js Official B2B Client Library</b></p>
 
   [![Zakki Store Web Docs](https://img.shields.io/badge/ZAKKI%20STORE-WEB%20DOCS-6C5CE7?style=for-the-badge&logo=gitbook&logoColor=white)](https://qris.zakki.store)
-  [![GitHub Repository](https://img.shields.io/badge/GitHub-Repository-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/MrLow12/zakkistore-sdk)
-  
   [![WhatsApp](https://img.shields.io/badge/WHATSAPP-CHAT%20SUPPORT-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://wa.me/6283844082339)
   [![Telegram](https://img.shields.io/badge/TELEGRAM-DEV%20CONTACT-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/zakki_store)
 </div>
@@ -16,24 +14,14 @@
 > **🚀 Hubungi Developer untuk Akses API & Whitelist IP:**
 > Pendaftaran IP partner B2B, pembukaan whitelist, atau keluhan error `[IP BLOCKED / UNREGISTERED]` dapat diselesaikan secara instan dengan menghubungi tim Developer Zakki Store via tombol **WhatsApp** atau **Telegram** di atas.
 
-> [!TIP]
-> **📦 Repositori Kode Sumber Terbuka (GitHub):**
-> SDK Node.js ini bersifat open-source dan dikembangkan secara aktif. Anda dapat melihat kode sumber, melaporkan masalah, berkontribusi, atau melihat riwayat perubahan di **[GitHub Repository MrLow12/zakkistore-sdk](https://github.com/MrLow12/zakkistore-sdk)**.
-
 ---
 
 ## 🚀 Instalasi & Inisialisasi
 
-Pasang pustaka SDK resmi melalui manajer paket NPM:
-
-```bash
-npm install zakkistore-sdk
-```
-
-Kemudian inisialisasi SDK di dalam project Node.js Anda:
+Untuk menggunakan SDK di dalam project Node.js Anda:
 
 ```javascript
-const ZakkiStore = require('zakkistore-sdk');
+const ZakkiStore = require('./sdk/index');
 
 // Inisialisasi SDK dengan parameter konfigurasi
 const zakki = new ZakkiStore({
@@ -76,6 +64,9 @@ import ZakkiStore from 'zakkistore-sdk';
 const zakki = new ZakkiStore({
     baseUrl: 'https://qris.zakki.store',
     token: 'token_api_member',
+    iduser: 'IBO99',
+    email: 'member@gmail.com',
+    pin: '123456',
     autoWithdraw: true
 });
 ```
@@ -384,7 +375,7 @@ Melihat sisa saldo aktif, no Virtual Account unik member, serta 20 riwayat mutas
 > **🚀 FITUR UNGGULAN: Auto-Withdraw / Tarik Saldo Otomatis**
 > SDK ini dilengkapi dengan sistem auto-withdraw yang sangat fleksibel dan efisien. Jika Anda mengaktifkan opsi `autoWithdraw: true` saat inisialisasi (atau memanggil `zakki.enableAutoWithdraw(true)`), maka setiap kali fungsi `checkbank()` dipanggil:
 > 1. SDK akan otomatis mendeteksi jika saldo rekening virtual bank Anda lebih dari Rp 0 (`bank_detail.balance > 0`).
-> 2. Tanpa perlu dipanggil manual oleh pengembang, SDK akan langsung memicu eksekusi internal fungsi `tarik()` di latar belakang untuk menarik seluruh dana bank tersebut masuk ke saldo utama aplikasi (BukaOlshop).
+> 2. Tanpa perlu dipanggil manual oleh pengembang, SDK akan langsung memicu eksekusi internal fungsi `tarik()` di latar belakang untuk menarik seluruh dana bank tersebut masuk ke saldo utama aplikasi zakki store.
 > 3. Hasil akhirnya, objek respon `checkbank()` akan disisipkan bendera sukses `auto_withdraw_executed: true` beserta jumlah yang ditarik, membuat siklus transaksi menjadi instan dan otomatis secara total!
 
 - **Sintaks:** `zakki.checkbank()`
@@ -750,25 +741,40 @@ Melihat rangkuman total volume, laba/rugi, peredaran koin, jumlah transaksi akti
 - **Struktur Output JSON (`code 200`):**
   ```json
   {
-    "total_users": 28,
-    "financials": {
-      "total_saldo_bank": 4500000,
-      "total_saldo_bukaolshop": 4520000,
-      "system_profit": 250000,
-      "total_injection": 5000000,
-      "total_loss": 5000
-    },
-    "h2h_metrics": {
-      "total_transactions": 1420,
-      "total_volume": 12500000,
-      "success_ratio": "98.4%"
-    },
-    "mining_metrics": {
-      "total_blocks_mined": 250,
-      "total_koin_mined": 12500
+    "code": 200,
+    "status": "success",
+    "message": "🚀 BANK ZAKKI STORE - SYSTEM STATUS ENGINE (PUBLIC)",
+    "data": {
+      "statistik_mesin": {
+        "total_pengguna": 28,
+        "koneksi_aktif": 0,
+        "jumlah_core": 4,
+        "penggunaan_cpu": [
+          "core1: 5%"
+        ],
+        "beban_rata_rata": [0, 0, 0],
+        "waktu_aktif": "1 hari, 2 jam, 3 menit, 4 detik"
+      },
+      "ringkasan_finansial": {
+        "total_saldo_beredar": 4500000,
+        "total_volume_transaksi": 12500000,
+        "total_poin_reward": 120,
+        "total_transaksi_h2h": 1420,
+        "total_volume_h2h": 12500000,
+        "total_mining": 250,
+        "total_mining_reward": 12500
+      },
+      "integritas_keamanan": {
+        "injeksi_ilegal": 0,
+        "kehilangan_data_terdeteksi": 0,
+        "kesehatan_sistem": "🟢 OPTIMAL",
+        "status_audit": "100% VERIFIED BY SYSTEM ENGINEERING CHECKER",
+        "callback_engine": "ONLINE",
+        "telegram_bot": "ONLINE"
+      },
+      "topup_sukses": 150
     },
-    "status": "HEALTHY",
-    "timestamp": "2026-05-31T17:40:00.000Z"
+    "server_time": "Senin, 1 Juni 2026 pukul 17.40"
   }
   ```
 

package/index.d.ts

@@ -115,6 +115,13 @@ declare class ZakkiStore {
      */
     tarik(jumlah: number | string): Promise<any>;
 
+    /**
+     * 25. Cek Riwayat Mutasi Tarik/Tabung
+     * Melihat riwayat mutasi tarik/tabung pada akun Anda
+     * @param type Tipe mutasi ('all' | 'tarik' | 'tabung')
+     */
+    checkmutasi(type?: 'all' | 'tarik' | 'tabung' | string): Promise<any>;
+
     /**
      * 12. Transfer Saldo Antar Member
      * Mentransfer sebagian saldo Anda ke rekening VA member/user Zakki Store lainnya
@@ -147,14 +154,29 @@ declare class ZakkiStore {
 
     /**
      * 16. Cek Status Mining Global
+     * @param idmining ID Transaksi Mining (contoh: Mining-XXXXXX)
      */
-    cekmining(): Promise<any>;
+    cekmining(idmining: string): Promise<any>;
 
     /**
      * 17. Cek Statistik Mining Pribadi
      */
     mymining(): Promise<any>;
 
+    /**
+     * Minta Tantangan (Challenge) Mining Baru
+     * Mendapatkan challenge kriptografi dan difficulty untuk komputasi Proof of Work
+     */
+    miningStart(): Promise<any>;
+
+    /**
+     * Submit Jawaban Mining (Proof of Work)
+     * Mengirimkan nonce tebakan dan signature untuk divalidasi oleh server
+     * @param nonce Nonce hasil komputasi yang valid
+     * @param signature Segel kriptografi signature dari server
+     */
+    miningSubmit(nonce: number | string, signature: string): Promise<any>;
+
     /**
      * 18. Cek Stok Nomor Telepon (Noktel)
      */
@@ -199,6 +221,67 @@ declare class ZakkiStore {
      * Mengambil rangkuman statistik global sistem (total saldo, total pengguna, total volume H2H, dll)
      */
     status(): Promise<any>;
+
+    /**
+     * 26. Set Callback URL
+     * Mendaftarkan URL callback HTTPS Anda untuk menerima laporan otomatis status pembayaran
+     * @param site URL callback Anda (Wajib HTTPS dan harus mengembalikan 200 OK)
+     */
+    setcallback(site: string): Promise<any>;
+
+    /**
+     * 27. Hapus Callback URL
+     * Menghapus URL callback yang terdaftar agar tidak lagi menerima laporan otomatis
+     */
+    delcallback(): Promise<any>;
+
+    /**
+     * 28. Set Notifikasi Bot Telegram
+     * Mendaftarkan ID Telegram Anda agar menerima laporan transaksi otomatis dari bot
+     * @param telegramId ID Telegram member Anda
+     */
+    setnotifbot(telegramId: string | number): Promise<any>;
+
+    /**
+     * 29. Hapus Notifikasi Bot Telegram
+     * Menghapus ID Telegram yang terdaftar untuk menonaktifkan notifikasi bot
+     */
+    delnotifbot(): Promise<any>;
+
+
+
+    /**
+     * 31. Cek Detail Transfer Saldo
+     * Memverifikasi status transfer saldo antar member berdasarkan ID transfer
+     * @param idtransfer ID transaksi transfer (contoh: BankTF-xxxxxx)
+     */
+    checktransfer(idtransfer: string): Promise<any>;
+
+    /**
+     * 32. Cek Riwayat Transfer Saldo (Kirim / Terima / Semua)
+     * Melihat riwayat transaksi transfer saldo pada akun Anda
+     * @param type Tipe riwayat ('all' | 'kirim' | 'terima')
+     */
+    mytransfer(type?: 'all' | 'kirim' | 'terima' | string): Promise<any>;
+
+    /**
+     * 33. Cek Riwayat Topup Sukses
+     * Mengambil daftar seluruh riwayat pembayaran QRIS topup sukses beserta total volume
+     */
+    mytopup(): Promise<any>;
+
+    /**
+     * 34. Cek Alamat IP & Keamanan Server Anda
+     * Mengambil alamat IP publik server Anda terdeteksi oleh gateway beserta status keamanan (Aman/Whitelist/Blacklist)
+     */
+    cekmyip(): Promise<any>;
+
+    /**
+     * 35. Cek Status Keamanan Alamat IP Spesifik
+     * Memverifikasi status keamanan IP tertentu di list blacklist/whitelist sistem gateway
+     * @param ip Alamat IP yang ingin dicek
+     */
+    cekip(ip: string): Promise<any>;
 }
 
 export = ZakkiStore;

package/index.js

@@ -231,6 +231,22 @@ class ZakkiStore {
         return this._request('/tarik', 'POST', payload);
     }
 
+    /**
+     * 25. Cek Riwayat Mutasi Tarik/Tabung
+     * Melihat riwayat mutasi tarik/tabung pada akun Anda
+     * @param {string} [type='all'] Tipe mutasi ('all', 'tarik', 'tabung')
+     * @returns {Promise<Object>} Respon data riwayat mutasi
+     */
+    async checkmutasi(type = 'all') {
+        const payload = {
+            token: this.token,
+            type: String(type).trim()
+        };
+        if (this.iduser) payload.iduser = this.iduser;
+        if (this.email) payload.email = this.email;
+        return this._request('/checkmutasi', 'GET', payload);
+    }
+
     /**
      * 12. Transfer Saldo Antar Member
      * Mentransfer sebagian saldo Anda ke rekening VA member/user Zakki Store lainnya
@@ -317,12 +333,14 @@ class ZakkiStore {
 
     /**
      * 16. Cek Status Mining Global
-     * Melihat status, tingkat kesulitan, serta parameter global dari sistem Mining koin
+     * Melihat detail status transaksi mining koin spesifik berdasarkan ID
+     * @param {string} idmining ID Transaksi Mining (contoh: Mining-XXXXXX)
      * @returns {Promise<Object>} Detail status mining server
      */
-    async cekmining() {
+    async cekmining(idmining) {
+        if (!idmining) throw new Error('Parameter idmining wajib diisi.');
         return this._request('/cekmining', 'GET', {
-            token: this.token
+            idmining: String(idmining).trim()
         });
     }
 
@@ -337,6 +355,34 @@ class ZakkiStore {
         });
     }
 
+    /**
+     * Minta Tantangan (Challenge) Mining Baru
+     * Mendapatkan challenge kriptografi dan difficulty untuk komputasi Proof of Work
+     * @returns {Promise<Object>} Respon detail challenge mining
+     */
+    async miningStart() {
+        return this._request('/mining/start', 'GET', {
+            token: this.token
+        });
+    }
+
+    /**
+     * Submit Jawaban Mining (Proof of Work)
+     * Mengirimkan nonce tebakan dan signature untuk divalidasi oleh server
+     * @param {number|string} nonce Nonce hasil komputasi yang valid
+     * @param {string} signature Segel kriptografi signature dari server
+     * @returns {Promise<Object>} Respon hasil submit mining (sukses/denda)
+     */
+    async miningSubmit(nonce, signature) {
+        if (typeof nonce === 'undefined') throw new Error('Parameter nonce wajib disertakan.');
+        if (!signature) throw new Error('Parameter signature wajib disertakan.');
+        return this._request('/mining/submit', 'POST', {
+            token: this.token,
+            nonce: nonce,
+            signature: signature
+        });
+    }
+
     /**
      * 18. Cek Stok Nomor Telepon (Noktel)
      * Mengambil daftar nomor telepon (stok) yang tersedia untuk dibeli
@@ -420,6 +466,113 @@ class ZakkiStore {
     async status() {
         return this._request('/status', 'GET');
     }
+
+    /**
+     * 26. Set Callback URL
+     * Mendaftarkan URL callback HTTPS Anda untuk menerima laporan otomatis status pembayaran
+     * @param {string} site URL callback Anda (Wajib HTTPS dan harus mengembalikan 200 OK)
+     * @returns {Promise<Object>} Respon status pendaftaran callback
+     */
+    async setcallback(site) {
+        return this._request('/setcallback', 'GET', {
+            token: this.token,
+            site: String(site).trim()
+        });
+    }
+
+    /**
+     * 27. Hapus Callback URL
+     * Menghapus URL callback yang terdaftar agar tidak lagi menerima laporan otomatis
+     * @returns {Promise<Object>} Respon status penghapusan callback
+     */
+    async delcallback() {
+        return this._request('/delcallback', 'GET', {
+            token: this.token
+        });
+    }
+
+    /**
+     * 28. Set Notifikasi Bot Telegram
+     * Mendaftarkan ID Telegram Anda agar menerima laporan transaksi otomatis dari bot
+     * @param {string|number} telegramId ID Telegram member Anda
+     * @returns {Promise<Object>} Respon status pendaftaran Telegram ID
+     */
+    async setnotifbot(telegramId) {
+        return this._request('/setnotifbot', 'GET', {
+            token: this.token,
+            id: String(telegramId).trim()
+        });
+    }
+
+    /**
+     * 29. Hapus Notifikasi Bot Telegram
+     * Menghapus ID Telegram yang terdaftar untuk menonaktifkan notifikasi bot
+     * @returns {Promise<Object>} Respon status penghapusan
+     */
+    async delnotifbot() {
+        return this._request('/delnotifbot', 'GET', {
+            token: this.token
+        });
+    }
+
+
+
+    /**
+     * 31. Cek Detail Transfer Saldo
+     * Memverifikasi status transfer saldo antar member berdasarkan ID transfer
+     * @param {string} idtransfer ID transaksi transfer (contoh: BankTF-xxxxxx)
+     * @returns {Promise<Object>} Respon detail transfer saldo
+     */
+    async checktransfer(idtransfer) {
+        return this._request('/checktransfer', 'GET', {
+            idtransfer: String(idtransfer).trim()
+        });
+    }
+
+    /**
+     * 32. Cek Riwayat Transfer Saldo (Kirim / Terima / Semua)
+     * Melihat riwayat transaksi transfer saldo pada akun Anda
+     * @param {string} [type='all'] Tipe riwayat ('all', 'kirim', 'terima')
+     * @returns {Promise<Object>} Respon daftar transfer
+     */
+    async mytransfer(type = 'all') {
+        return this._request('/mytransfer', 'GET', {
+            token: this.token,
+            type: String(type).trim()
+        });
+    }
+
+    /**
+     * 33. Cek Riwayat Topup Sukses
+     * Mengambil daftar seluruh riwayat pembayaran QRIS topup sukses beserta total volume
+     * @returns {Promise<Object>} Daftar riwayat topup sukses
+     */
+    async mytopup() {
+        return this._request('/mytopup', 'GET', {
+            token: this.token
+        });
+    }
+
+    /**
+     * 34. Cek Alamat IP & Keamanan Server Anda
+     * Mengambil alamat IP publik server Anda terdeteksi oleh gateway beserta status keamanan (Aman/Whitelist/Blacklist)
+     * @returns {Promise<Object>} Detail IP & status keamanan
+     */
+    async cekmyip() {
+        return this._request('/cekmyip', 'GET');
+    }
+
+    /**
+     * 35. Cek Status Keamanan Alamat IP Spesifik
+     * Memverifikasi status keamanan IP tertentu di list blacklist/whitelist sistem gateway
+     * @param {string} ip Alamat IP yang ingin dicek
+     * @returns {Promise<Object>} Detail IP & status keamanan
+     */
+    async cekip(ip) {
+        return this._request('/cekip', 'GET', {
+            ip: String(ip).trim()
+        });
+    }
 }
 
 module.exports = ZakkiStore;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zakkistore-sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "SDK Node.js Resmi untuk Integrasi Layanan Payment Gateway QRIS & Host-to-Host (H2H) Zakki Store",
   "main": "index.js",
   "types": "index.d.ts",