cashi-id 1.0.0

package/.history/.npmignore_20251225201808

@@ -0,0 +1,3 @@
+test.js
+.git
+node_modules

package/.history/.npmignore_20251225201811

@@ -0,0 +1,2 @@
+.git
+node_modules

package/.history/.npmignore_20251225201832

@@ -0,0 +1,3 @@
+.git
+node_modules
+history

package/.history/.npmignore_20251225202057

@@ -0,0 +1,4 @@
+.git
+node_modules
+history
+.npm_recovery_codes

package/README.md

@@ -0,0 +1,99 @@
+# CASHI.ID Node.js SDK 🚀
+
+[![NPM Version](https://img.shields.io/npm/v/cashi-id.svg?style=flat-square)](https://www.npmjs.com/package/cashi-id)
+[![License](https://img.shields.io/npm/l/cashi-id.svg?style=flat-square)](https://github.com/cashi-id/sdk/blob/main/LICENSE)
+
+**CASHI.ID SDK** adalah library resmi Node.js untuk memudahkan integrasi pembayaran **QRIS Dinamis** ke dalam aplikasi Anda. Cocok digunakan untuk Website, Bot Telegram, Backend API, hingga Sistem Kasir.
+
+---
+
+## ✨ Fitur Utama
+- ✅ **Simple Order Creation**: Buat tagihan QRIS cuma dengan 1 baris kode.
+- ✅ **Real-time Polling**: Cek status transaksi secara instan (Sangat berguna untuk Bot).
+- ✅ **Promise Based**: Menggunakan `async/await` yang modern dan bersih.
+- ✅ **Hybrid Support**: Support CommonJS (`require`) & ES Modules (`import`).
+
+## 📦 Instalasi
+
+Instal melalui npm:
+
+```
+npm install cashi-id
+```
+
+🚀 Penggunaan Cepat
+
+1. Inisialisasi
+Dapatkan API Key Anda melalui Dashboard Merchant Cashi.id.
+
+
+```javascript
+const Cashi = require('cashi-id');
+const cashi = new Cashi('YOUR_API_KEY_HERE');
+```
+2. Membuat Pembayaran (QRIS)
+Gunakan fungsi ini untuk membuat transaksi baru.
+
+```javascript
+const createPayment = async () => {
+  try {
+    const order = await cashi.createOrder(15000); // Nominal Rp 15.000
+    
+    console.log("Order ID:", order.order_id);
+    console.log("Nominal + Kode Unik:", order.amount);
+    console.log("Link Pembayaran:", order.checkout_url);
+  } catch (err) {
+    console.error("Gagal membuat order:", err.message);
+  }
+};
+
+createPayment();
+```
+
+3. Cek Status Transaksi (Polling)
+Metode ini sangat disarankan jika Anda membangun Bot Telegram atau aplikasi yang tidak memiliki URL publik untuk menerima Webhook.
+
+```javascript
+const checkStatus = async (orderId) => {
+  const result = await cashi.checkStatus(orderId);
+  
+  if (result.status === 'SETTLED') {
+    console.log("Pembayaran Berhasil Diterima! ✅");
+  } else if (result.status === 'PENDING') {
+    console.log("Menunggu Pembayaran... ⏳");
+  } else {
+    console.log("Transaksi Kadaluarsa atau Gagal ❌");
+  }
+};
+```
+
+🛡️ Webhook Handler
+Jika Anda menggunakan Webhook, server Cashi.id akan mengirimkan POST request dengan payload berikut:
+
+```JSON
+
+{
+  "order_id": "ORD-1766-999",
+  "amount": 50000,
+  "status": "SETTLED",
+  "timestamp": "2025-12-25 20:00:00"
+}
+```
+Penting: Pastikan server Anda merespon dengan status code 200 untuk menghentikan retrying notifikasi.
+
+
+🛠️ Error Handling
+SDK ini akan melempar error jika API Key tidak valid atau terjadi masalah jaringan. Selalu gunakan blok try...catch untuk menjaga stabilitas aplikasi Anda.
+
+```javascript
+try {
+  const res = await cashi.checkStatus('ORD-123');
+} catch (error) {
+  console.log("Terjadi Kesalahan:", error.message);
+}
+
+```
+📄 Lisensi
+Distribusi di bawah lisensi MIT. Bebas digunakan untuk proyek personal maupun komersial.
+
+<p align="center"> Dibuat dengan ❤️ oleh <b>CASHI.ID Developer Team</b> </p>

package/index.js

@@ -0,0 +1,51 @@
+// index.js
+const axios = require('axios');
+
+class Cashi {
+    /**
+     * @param {string} apiKey - API Key dari Dashboard Cashi.id
+     */
+    constructor(apiKey) {
+        if (!apiKey) throw new Error("API Key is required!");
+        
+        this.apiKey = apiKey;
+        this.baseURL = "http://localhost:5012/api"; // Sesuaikan dengan domain asli lu nanti
+        
+        // Inisialisasi Axios instance
+        this.client = axios.create({
+            baseURL: this.baseURL,
+            headers: {
+                'x-api-key': this.apiKey,
+                'Content-Type': 'application/json'
+            }
+        });
+    }
+
+    /**
+     * Membuat Order QRIS Baru
+     * @param {number} amount - Nominal pembayaran
+     */
+    async createOrder(amount) {
+        try {
+            const response = await this.client.post('/create-order', { amount });
+            return response.data;
+        } catch (error) {
+            throw new Error(error.response?.data?.message || "Failed to create order");
+        }
+    }
+
+    /**
+     * Cek Status Transaksi secara Manual (Polling)
+     * @param {string} orderId - ID Order dari Cashi (Contoh: ORD-XXXX)
+     */
+    async checkStatus(orderId) {
+        try {
+            const response = await this.client.get(`/check-status/${orderId}`);
+            return response.data;
+        } catch (error) {
+            throw new Error(error.response?.data?.message || "Failed to check status");
+        }
+    }
+}
+
+module.exports = Cashi;

package/npm_recovery_codes.txt

@@ -0,0 +1,5 @@
+f540a22744d8cb3d226f79deb8c26ec26d8e946fdb024e2183758140fd5668f7
+dcd64ae8959ed8ce26e73dca10935a4c42aa8cbdd4682298584b3faa48f30d77
+cf044a2270913664fa58b364b5fe7452d4bf4928dc10e4214dc8942e9a46463e
+6afa1964610606261395542f23fcf0a1f388216e1e326dd5fbbb388320634495
+06bba8b0e9911ecdbb30f94e3425042c3b539e5ddbdc92b07f7ad0248a47019d

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "cashi-id",
+  "version": "1.0.0",
+  "description": "Official Node.js SDK for Cashi.id QRIS Dynamic Payment Gateway",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "qris",
+    "payment-gateway",
+    "cashi",
+    "indonesia",
+    "automation"
+  ],
+  "author": "Pitucode.com / Cashi.id Team",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0"
+  }
+}

package/test.js

@@ -0,0 +1,15 @@
+const Cashi = require('./index.js');
+
+const cashi = new Cashi('YOURAPIKEY');
+
+async function runTest() {
+    try {
+        console.log("--- Mengetes Check Status ---");
+        const status = await cashi.checkStatus('ORD-XXXX5404XX710-721');
+        console.log("Hasil:", status);
+    } catch (err) {
+        console.error("Error Test:", err.message);
+    }
+}
+
+runTest();