TypeScript / Node / Bun

npm install @hyzecloud/sdk
# or
bun add @hyzecloud/sdk

import { HyzeCloud, HyzeError } from "@hyzecloud/sdk";

const hyze = new HyzeCloud({
  apiKey: process.env.HYZE_API_KEY, // hyze_...
  // baseUrl: "https://api.hyzecloud.com/api", // default
  // workspaceId: "org_...", // optional
});

const { apps } = await hyze.apps.list();
console.log(apps.map((a) => `${a.name} (${a.status})`));

try {
  await hyze.apps.restart("app_001");
} catch (err) {
  if (err instanceof HyzeError) {
    console.error(err.status, err.code, err.message);
    if (err.isRateLimited) {
      console.error("Retry after", err.retryAfterSeconds, "s");
    }
  }
  throw err;
}

// List / get
const list = await hyze.apps.list();
const detail = await hyze.apps.get("app_001");
// detail.container: status, publicUrl, stats, runtime, ...

// Lifecycle
await hyze.apps.start("app_001");
await hyze.apps.stop("app_001");
await hyze.apps.restart("app_001");

// Logs & env
await hyze.apps.logs("app_001", { tail: 200, timestamps: true });
await hyze.apps.getEnv("app_001");
await hyze.apps.setEnv("app_001", {
  APP_ENV: "production",
  LOG_LEVEL: "info",
});

// Settings
await hyze.apps.updateSettings("app_001", {
  name: "my-api",
  memoryMB: 512,
  autoRestart: true,
});

import { readFileSync } from "node:fs";

await hyze.apps.deployFromZip({
  file: readFileSync("./app.zip"),
  name: "my-api",
  runtime: "node", // "node" | "bun" | "python"
  memoryMB: 512,
  // startupCommand optional — omit or "auto" to let Hyze detect
  exposePort: 3000,
  subdomain: "my-api.hyzecloud.app",
  envVars: {
    APP_ENV: "production",
  },
});

// Custom start when you need full control:
// await hyze.apps.deployFromZip({ ..., startupCommand: "node server.js" });

await hyze.apps.deployFromRepo({
  name: "my-api",
  runtime: "bun",
  memoryMB: 512,
  exposePort: 3000,
  subdomain: "my-api.hyzecloud.app",
  repository: {
    id: 123,
    owner: "acme",
    name: "api",
    branch: "main",
  },
});

await hyze.apps.createBackup("app_001");
await hyze.apps.listBackups("app_001");
await hyze.apps.restoreBackup("app_001", "backup_001");

await hyze.databases.create({
  name: "prod-postgres",
  engine: "postgresql", // postgresql | mysql | mongodb | redis
  memoryMB: 1024,
  storageGB: 20,
});

const { databases } = await hyze.databases.list();
await hyze.databases.get("db_001");
await hyze.databases.stats("db_001");
await hyze.databases.logs("db_001", { tail: 100 });

await hyze.databases.start("db_001");
await hyze.databases.stop("db_001");

await hyze.databases.createBackup("db_001");
await hyze.databases.listBackups("db_001");

const { keys } = await hyze.apiKeys.list();
const created = await hyze.apiKeys.create({ name: "ci" });
// created.key.key — one-time secret (only on create)

const { invoices } = await hyze.invoices.list();
const pix = await hyze.invoices.createPix({
  planId: "pro",
  interval: "month",
});
// pix.invoice.brCode / brCodeBase64

await hyze.github.status();
await hyze.github.repos();

const current = await hyze.plans.current();
// current.plan + current.usage

await hyze.get("/apps/");
await hyze.post("/apps/app_001/restart");
await hyze.request("/apps/", {
  method: "GET",
  query: { workspaceId: "org_1" },
});