@xstbot/cloudku-database 1.0.0

package/README.md

@@ -0,0 +1,118 @@
+# Cloudku S3
+npm install cloudku-sdk
+
+CONTOH PENGGUNAAN LENGKAP API
+
+1. Spesifikasi API
+Endpoint : https://db.cloudku.sbs/api/db/cloudku/sbs
+Method : POST
+Header : Content-Type: application/json
+Fungsi : Menyimpan data JSON apa pun (user, sensor, log, dll) ke database.
+
+
+
+2. Contoh 1 — Kirim Data User
+2.1 Tujuan : Menyimpan data pengguna aplikasi.
+2.2 cURL
+curl -X POST https://db.cloudku.sbs/api/db/cloudku/sbs \
+  -H "Content-Type: application/json" \
+  -d '{
+    "type": "user",
+    "username": "dev",
+    "role": "admin",
+    "created_at": "2025-01-01 10:00:00"
+  }'
+
+
+3. Contoh 2 — Kirim Data Sensor IoT
+3.1 Tujuan : Menyimpan data pembacaan sensor.
+3.2 cURL
+curl -X POST https://db.cloudku.sbs/api/db/cloudku/sbs \
+  -H "Content-Type: application/json" \
+  -d '{
+    "type": "sensor",
+    "device_id": "ESP32-01",
+    "sensor": "DHT22",
+    "temperature": 24.5,
+    "humidity": 60,
+    "status": "OK",
+    "timestamp": "2025-01-01 10:05:00"
+  }'
+
+
+4. Contoh 3 — Penggunaan di ESP32 (Arduino)
+#include <WiFi.h>
+#include <HTTPClient.h>
+
+const char* ssid = "NAMA_WIFI";
+const char* password = "PASSWORD_WIFI";
+
+void setup() {
+  Serial.begin(115200);
+  WiFi.begin(ssid, password);
+
+  while (WiFi.status() != WL_CONNECTED) {
+    delay(500);
+    Serial.print(".");
+  }
+
+  if (WiFi.status() == WL_CONNECTED) {
+    HTTPClient http;
+    http.begin("https://db.cloudku.sbs/api/db/cloudku/sbs");
+    http.addHeader("Content-Type", "application/json");
+
+    String jsonData = R"rawliteral(
+      {
+        "type": "sensor",
+        "device_id": "ESP32-01",
+        "sensor": "DHT22",
+        "temperature": 25.1,
+        "humidity": 58,
+        "status": "OK"
+      }
+    )rawliteral";
+
+    int httpResponseCode = http.POST(jsonData);
+    Serial.println(httpResponseCode);
+    http.end();
+  }
+}
+
+void loop() {
+}
+
+
+5. Contoh 4 — Penggunaan di Node.js
+const axios = require("axios");
+
+axios.post("https://db.cloudku.sbs/api/db/cloudku/sbs", {
+  type: "sensor",
+  device_id: "SERVER-01",
+  cpu_usage: 65,
+  ram_usage: 70,
+  status: "NORMAL"
+})
+.then(res => {
+  console.log("Success:", res.data);
+})
+.catch(err => {
+  console.error("Error:", err.message);
+});
+
+
+
+6. Contoh 5 — Penggunaan di Python
+import requests
+
+url = "https://db.cloudku.sbs/api/db/cloudku/sbs"
+
+data = {
+    "type": "user",
+    "username": "operator1",
+    "role": "operator"
+}
+
+response = requests.post(url, json=data)
+print(response.json())
+
+

package/index.js

@@ -0,0 +1,41 @@
+const axios = require('axios');
+
+class CloudkuDB {
+
+  constructor(baseURL = 'https://db.cloudku.sbs/api/db/cloudku/sbs') {
+    this.api = axios.create({
+      baseURL: baseURL,
+      headers: { 
+        'Content-Type': 'application/json',
+        'Accept': 'application/json'
+      }
+    });
+  }
+
+  async postUser(user, role) {
+    try {
+      const response = await this.api.post('', { user, role });
+      return response.data;
+    } catch (error) {
+      this._handleError(error);
+    }
+  }
+
+  async postSensor(id, temp, status) {
+    try {
+      const response = await this.api.post('', { id, temp, status });
+      return response.data;
+    } catch (error) {
+      this._handleError(error);
+    }
+  }
+
+  _handleError(error) {
+    if (error.response) {
+      throw new Error(`API Error: ${error.response.status} - ${JSON.stringify(error.response.data)}`);
+    }
+    throw new Error(`Network Error: ${error.message}`);
+  }
+}
+
+module.exports = CloudkuDB;

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@xstbot/cloudku-database",
+  "version": "1.0.0",
+  "description": "SDK DATABASE untuk akses Database Cloudku",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cloudku",
+    "database",
+    "iot",
+    "sdk"
+  ],
+  "author": "Arsyilla Official",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.13.2"
+  }
+}