Discloud.app

Instalation

npm i discloud.app
yarn add discloud.app

Links

Examples usage

// index.js
// Get instanced discloud
const { discloud } = require("discloud.app");
// Set token and authenticate
await discloud.login("DISCLOUD_TOKEN");

// Other file
// Get instanced discloud
const { discloud } = require("discloud.app");
// ...
await discloud.apps.fetch("ID"); // Promise<App>

How to upload/commit your application

const { discloud } = require("discloud.app");
await discloud.apps.create({
 file: "FILE_PATH/FILE_NAME.zip"
}); // Promise<RESTPostApiUploadResult>

const { discloud } = require("discloud.app");
await discloud.apps.create({
 file: {
 data: readFileSync("FILE_PATH/FILE_NAME.zip"), // Blob | Buffer
 name: "FILE_NAME.zip"
 }
}); // Promise<RESTPostApiUploadResult>

const { discloud } = require("discloud.app");
await discloud.apps.update("APP_ID", {
 file: "FILE_PATH/FILE_NAME.zip"
}); // Promise<RESTPutApiAppCommitResult>

const { discloud } = require("discloud.app");
await discloud.apps.update("APP_ID", {
 file: {
 data: readFileSync("FILE_PATH/FILE_NAME.zip"), // Blob | Buffer
 name: "FILE_NAME.zip"
 }
}); // Promise<RESTPutApiAppCommitResult>

const { discloud, streamToFile } = require("discloud.app");
const file = await streamToFile(stream, "FILE_NAME.zip");
await discloud.apps.create({ file }); // Promise<RESTPostApiUploadResult>

How to fetch your application

const { discloud } = require("discloud.app");
await discloud.apps.fetch("APP_ID"); // Promise<App>
await discloud.apps.fetch(/* "all" | undefined */); // Promise<Map<string, App>>

How to start, stop, restart or delete your application

const { discloud } = require("discloud.app");
await discloud.apps.start("APP_ID"); // Promise<RESTApiBaseResult>
await discloud.apps.start(/* "all" | undefined */); // Promise<ApiAppManagerStartedAll>
await discloud.apps.stop("APP_ID"); // Promise<RESTApiBaseResult>
await discloud.apps.stop(/* "all" | undefined */); // Promise<ApiAppManagerStopedAll>
await discloud.apps.restart("APP_ID"); // Promise<RESTApiBaseResult>
await discloud.apps.restart(/* "all" | undefined */); // Promise<ApiAppManagerRestartedAll>
await discloud.apps.delete("APP_ID"); // Promise<RESTDeleteApiAppDeleteResult>
await discloud.apps.delete(/* "all" | undefined */); // Promise<ApiAppManagerRemovedAll>

How to view app logs

const { discloud } = require("discloud.app");
await discloud.apps.terminal("APP_ID"); // Promise<ApiTerminal>
await discloud.apps.terminal(/* "all" | undefined */); // Promise<Map<string, ApiTerminal>>

How to send a terminal command

const { discloud } = require("discloud.app");
await discloud.apps.console("APP_ID", "bash command"); // Promise<ApiConsoleAppShell>

How to backup apps

const { discloud } = require("discloud.app");
await discloud.apps.backup("APP_ID"); // Promise<AppBackup>
await discloud.apps.backup(/* "all" | undefined */); // Promise<Map<string, AppBackup>>

How to see your app statuses

const { discloud } = require("discloud.app");
await discloud.apps.status("APP_ID"); // Promise<AppStatus>
await discloud.apps.status(/* "all" | undefined */); // Promise<Map<string, AppStatus>>

How to change your app's name and/or avatar

const { discloud } = require("discloud.app");
await discloud.apps.profile("APP_ID", {
 avatarURL // Optional URL ending with GIF, JPG, JPEG or PNG
 name // Optional text up to 30 characters
}); // Promise<RESTApiBaseResult>

How to change the amount of RAM in the app

const { discloud } = require("discloud.app");
await discloud.apps.ram("APP_ID", 100 /* number greater than 100 */); // Promise<RESTPutApiAppRamResult>
// Remember that if your app type is site, the minimum is 512

How to install or uninstall APT

const { discloud } = require("discloud.app");
// Install APTs
await discloud.appApt.install("APP_ID", [
 "canvas",
 "ffmpeg",
 "java",
 "libgl",
 "openssl",
 "puppeteer",
 "tools",
]); // Promise<RESTPutApiAppAptResult>
// Uninstall APTs
await discloud.appApt.uninstall("APP_ID", ["canvas", "ffmpeg"]); // Promise<RESTDeleteApiAppAptResult>

How to fetch/add/edit/remove moderators for your application

const { discloud, ModPermissions } = require("discloud.app");
// Fetch mods and permissions
await discloud.appTeam.fetch("APP_ID"); // Promise<ApiAppTeam[]>
// Add a mod
await discloud.appTeam.create("APP_ID", "MOD_ID", [
 "backup_app",
 "commit_app",
 "edit_ram",
 "logs_app",
 "restart_app",
 "start_app",
 "status_app",
 "stop_app",
]); // Promise<ApiAppTeamManager>
// Edit mod permissions
await discloud.appTeam.edit("APP_ID", "MOD_ID", [
 ModPermissions.backup_app,
 ModPermissions.commit_app,
 ModPermissions.edit_ram,
 ModPermissions.logs_app,
 ModPermissions.restart_app,
 ModPermissions.start_app,
 ModPermissions.status_app,
 ModPermissions.stop_app,
]); // Promise<ApiAppTeamManager>
// Remove a mod
await discloud.appTeam.delete("APP_ID", "MOD_ID"); // Promise<RESTApiBaseResult>