Usage Examples

Examples and use cases for the discloud.app NPM library, covering application management, monitoring, team operations, and more.

Important: To obtain your API Token required in the examples below, see here.

Setup Required: Make sure you've completed the Getting Started guide before using these examples.

---

👤 User Management

📄 Fetching User Information

const { discloud } = require("discloud.app");

try {
  const user = await discloud.user.fetch();

  console.log("User information:", user);
} catch (error) {
  console.error("Failed to fetch user:", error.message);
}

📱 Application Management

🚀 Uploading a New Application

From File Path

const { discloud } = require("discloud.app");

try {
  await discloud.apps.create({
    file: "./my-bot.zip", // Path to your ZIP file
  });

  console.log("Upload successful!");
} catch (error) {
  console.error("Upload failed:", error.message);
}

From Buffer/Blob

From Stream

Before uploading: Ensure your ZIP file contains the discloud.config file and follows the preparation guidelines for your language.

🔄 Updating (Committing) an Application

File path / URL

const { discloud } = require("discloud.app");

await discloud.apps.update("APP_ID", {
  file: "FILE_PATH/FILE_NAME.zip",
});

Blob | Buffer | File | RawFile | ReadableStream

📱 Fetching Application Information

Single Application

const { discloud } = require("discloud.app");

try {
  const app = await discloud.apps.fetch("your_app_id");
  console.log("Application info:", app);
} catch (error) {
  console.error("Failed to fetch app:", error.message);
}

All Applications

🗑️ Deleting Applications

const { discloud } = require("discloud.app");

try {
  await discloud.apps.delete("your_app_id");
  console.log("App deleted successfully!");
} catch (error) {
  console.error("Failed to delete app:", error.message);
}

Warning: Deleting an application is permanent and cannot be undone. Make sure to backup your data before deletion.

---

⚡ Application Control

🟢 Starting Applications

Single App

const { discloud } = require("discloud.app");

try {
  await discloud.apps.start("your_app_id");
  console.log("App started successfully!");
} catch (error) {
  console.error("Failed to start app:", error.message);
}

All Apps

🔴 Stopping Applications

Single App

const { discloud } = require("discloud.app");

try {
  await discloud.apps.stop("your_app_id");
  console.log("App stopped successfully!");
} catch (error) {
  console.error("Failed to stop app:", error.message);
}

All Apps

🔄 Restarting Applications

Single App

const { discloud } = require("discloud.app");

try {
  await discloud.apps.restart("your_app_id");
  console.log("App restarted successfully!");
} catch (error) {
  console.error("Failed to restart app:", error.message);
}

All Apps

---

📊 Monitoring & Diagnostics

📈 Checking Application Status

Single App Status

const { discloud } = require("discloud.app");

try {
  const status = await discloud.apps.status("your_app_id");
  console.log("Status fetched successfully!");
} catch (error) {
  console.error("Failed to get status:", error.message);
}

All Apps Status

📋 Viewing Application Logs

Single App Logs

const { discloud } = require("discloud.app");

try {
  const logs = await discloud.apps.terminal("your_app_id");
  console.log("Logs fetched successfully!");
} catch (error) {
  console.error("Failed to get logs:", error.message);
}

All Apps Logs

💻 Sending Terminal Commands

const { discloud } = require("discloud.app");

try {
  const result = await discloud.apps.console("your_app_id", "ls -la");
  console.log("Command result:", result);
} catch (error) {
  console.error("Command failed:", error.message);
}

💾 Backup Operations

📦 Creating Backups

Single App Backup

const { discloud } = require("discloud.app");

try {
  const backup = await discloud.apps.backup("your_app_id");
  console.log("Backup created successfully!");
} catch (error) {
  console.error("Backup failed:", error.message);
}

All Apps Backup

---

👥 Team Management

👨‍💼 Managing Application Moderators

Fetch Team Members

const { discloud } = require("discloud.app");

try {
  const team = await discloud.appTeam.fetch("your_app_id");
  console.log("Team members fetched successfully!");
} catch (error) {
  console.error("Failed to fetch team:", error.message);
}

Add Team Member

Edit Permissions

Remove Team Member

---

⚙️ System Management

🔧 Managing RAM Allocation

const { discloud } = require("discloud.app");

try {
  await discloud.apps.ram("your_app_id", 512);
  console.log("RAM updated successfully!");
} catch (error) {
  console.error("RAM update failed:", error.message);
}

RAM Requirements

• Bot applications: minimum 100MB

• Website applications: minimum 512MB

• Check your plan limits before increasing RAM

🎨 Updating Application Profile

const { discloud } = require("discloud.app");

try {
  await discloud.apps.profile("your_app_id", {
    name: "My Awesome Bot",
    avatarURL: "https://example.com/avatar.png",
  });

  console.log("Profile updated successfully!");
} catch (error) {
  console.error("Profile update failed:", error.message);
}

Profile Update Details

• name: Optional. New name for your application (maximum 30 characters).

• avatarURL: Optional. URL of the new avatar image. Supported formats: GIF, JPG, JPEG, PNG.

📦 APT Package Management

📥 Installing APT Packages

const { discloud } = require("discloud.app");

try {
  await discloud.appApt.install("your_app_id", [
    "tools",
    "canvas",
    "tesseract",
    "puppeteer",
    "selenium",
    "java",
    "ffmpeg",
    "libgl",
    "openssl",
    "mysql",
    "unixodbc",
  ]);

  console.log("Packages installed successfully!");
} catch (error) {
  console.error("Installation failed:", error.message);
}

🗑️ Uninstalling APT Packages

const { discloud } = require("discloud.app");

try {
  await discloud.appApt.uninstall("your_app_id", ["canvas", "ffmpeg"]);
  console.log("Packages uninstalled successfully!");
} catch (error) {
  console.error("Uninstallation failed:", error.message);
}