SDK تایپ‌اسکریپت

npm install @cloudhost/sdk

import { Cloudhost } from "@cloudhost/sdk";

// the key from CLOUDHOST_API_KEY, or: new Cloudhost({ apiKey: "chk_live_..." })
const client = new Cloudhost();

const me = await client.account.whoami();
console.log(me.team, me.role);

import { Cloudhost } from "@cloudhost/sdk";
const client = new Cloudhost();

await client.functions.get("my-api"); // GET /v1/functions/my-api
await client.functions.deploy("my-api", { version: 12 }); // a JSON body
await client.functions.getLogs("my-api", { since: "1h", level: "error" }); // query parameters
await client.flags.functions.list("my-api"); // a product's part of another namespace

import { Cloudhost, ApiError, ConflictError, RateLimitError } from "@cloudhost/sdk";
const client = new Cloudhost();

try {
  await client.databases.create({ name: "shop" });
} catch (err) {
  if (err instanceof ConflictError && err.is("name_taken")) console.log("the name is taken");
  else if (err instanceof RateLimitError) console.log("try again in", err.retryAfter, "s");
  else if (err instanceof ApiError) console.log(err.status, err.code, err.message);
  else throw err;
}

import { Cloudhost } from "@cloudhost/sdk";
const client = new Cloudhost({ maxRetries: 5, timeout: 30_000 });
client.transport.onRetry = ({ attempt, delayMs, error }) => console.warn("retry", attempt, "in", delayMs, "ms:", error.message);

// per call: a signal, a timeout, retries, headers
const ctl = new AbortController();
await client.functions.list({ signal: ctl.signal, maxRetries: 0 });

import { Cloudhost } from "@cloudhost/sdk";
const client = new Cloudhost();

for await (const event of client.account.listAuditAll({ type: "deploy" })) {
  console.log(event.at, event.action);
}
const errors = await client.functions.getLogsAll("my-api", { since: "24h", level: "error" }).toArray({ max: 500 });
for await (const page of client.support.listAll({ status: "active" }).pages()) console.log(page.total);

import { Cloudhost } from "@cloudhost/sdk";
const client = new Cloudhost();

await client.functions.create({ name: "my-api" });
const v = await client.functions.uploadVersion("my-api", {
  main_module: "index.js",
  modules: { "index.js": `export default { fetch: () => new Response("hello") }` },
});
const live = await client.functions.deploy("my-api", { version: v.version });
await client.functions.putSecret("my-api", "PAYMENT_KEY", { value: "..." });

const tail = await client.functions.tail("my-api"); // the live log
for await (const entry of tail) {
  console.log(entry.level, entry.msg);
  if (entry.level === "error") break;
}

import { Cloudhost } from "@cloudhost/sdk";

export default {
  async fetch(request: Request, env: Record<string, string>) {
    const client = new Cloudhost({ env }); // reads CLOUDHOST_API_KEY from the function's env
    const { functions } = await client.functions.list();
    return Response.json(functions.map((f) => f.name));
  },
};