JavaScript SDK: manage applications

import { SquareCloudAPI } from "@squarecloud/api";

const api = new SquareCloudAPI(process.env.SQUARECLOUD_API_KEY!);
const appId = "abc123def456abc123def456";

const app = await api.apps.get(appId);

console.log(app.id, app.name, app.language, app.ram, app.cluster, app.created_at);

const status = await api.apps.status(appId);

console.log(status.status);  // e.g. "running", "exited"
console.log(status.running); // true
console.log(status.cpu);     // "0.5%"
console.log(status.ram);     // "120.4MB" (RAM in use)
console.log(status.storage, status.network.total, status.network.now);
console.log(status.uptime);  // Unix ms of the last start, null when stopped

const raw = await api.apps.status(appId, { raw: true });

console.log(raw.cpu, raw.ram, raw.network.total); // 0.5 120.4 [1024, 2048]

for (const { id, running, cpu, ram } of await api.apps.statusAll()) {
    console.log(id, running ? `${cpu} ${ram}` : "stopped");
}

// Only the apps of one workspace
const shared = await api.apps.statusAll({ workspaceId });

await api.apps.start(appId);
await api.apps.stop(appId);
await api.apps.restart(appId);

import { SquareCloudAPIError } from "@squarecloud/api";

try {
    await api.apps.start(appId);
} catch (error) {
    if (!(error instanceof SquareCloudAPIError && error.code === "CONTAINER_ALREADY_STARTED")) {
        throw error;
    }
}

console.log(await api.apps.logs(appId));

const [latest] = await api.apps.metrics(appId);

console.log(latest.date, latest.cpu, latest.ram, latest.net);

for (const { app_id, hostname, type } of await api.apps.domains()) {
    console.log(app_id, hostname, type); // type: "subdomain" | "custom"
}

const { limit, balancers } = await api.apps.loadBalancers();
for (const { hostname, apps } of balancers) {
    console.log(hostname, apps.map((app) => app.id));
}

await api.apps.delete(appId);