TypeScript SDK

import { listWorlds } from "@wazoo/client";

// Connects to https://api.wazoo.dev and reads process.env.WAZOO_PLATFORM_TOKEN out of the box
const { data, error } = await listWorlds();
console.log(data?.worlds);

import {
  listWorlds,
  createWorld,
  getWorld,
  updateWorld,
  deleteWorld,
} from "@wazoo/client";

// List active worlds
const { data } = await listWorlds();
console.log(data?.worlds);

// Create a world
const created = await createWorld({
  body: {
    worldId: "support-knowledge",
    world: { displayName: "Support Knowledge", region: "auto" },
  },
});

// Get a world by ID
const world = await getWorld({
  path: { worldId: "support-knowledge" },
});

// Update display name
await updateWorld({
  path: { worldId: "support-knowledge" },
  body: {
    updateMask: "displayName",
    world: { displayName: "Support Knowledge Base" },
  },
});

// Soft-delete (recoverable for 30 days)
await deleteWorld({ path: { worldId: "support-knowledge" } });

import {
  listPlatformTokens,
  createPlatformToken,
  deletePlatformToken,
} from "@wazoo/client";

// List tokens
const { data } = await listPlatformTokens();

// Create a token (secret shown once)
const created = await createPlatformToken({
  body: {
    name: "my-read-token",
    scope: "users.read worlds.read usage.read",
  },
});
console.log(created.data?.token); // wzp_...

// Revoke a token by name
await deletePlatformToken({ path: { tokenName: "my-read-token" } });

import {
  listWorldTokens,
  createWorldToken,
  deleteWorldToken,
} from "@wazoo/client";

const { data } = await listWorldTokens({
  path: { worldId: "support-knowledge" },
});

const created = await createWorldToken({
  path: { worldId: "support-knowledge" },
});
console.log(created.data?.token); // one-time secret

await deleteWorldToken({
  path: { worldId: "support-knowledge", tokenUid: created.data!.token.uid },
});

import { getWorldUsage, getWorldLimits } from "@wazoo/client";

const usage = await getWorldUsage({
  path: { worldId: "support-knowledge" },
});
console.log(usage.data?.usage.total);

const limits = await getWorldLimits({
  path: { worldId: "support-knowledge" },
});

import { getWorldBilling } from "@wazoo/client";

const billing = await getWorldBilling({
  path: { worldId: "support-knowledge" },
});
console.log(billing.data?.billing.state);

import { client, createClient, listWorlds } from "@wazoo/client";

// Configure default client globally (e.g. set global headers or custom token)
client.setConfig({
  auth: process.env.CUSTOM_PLATFORM_TOKEN,
});

// Or create an isolated client instance for multi-tenant setups
const customClient = createClient({
  baseUrl: "https://api.wazoo.dev",
  auth: "wzp_custom_token",
});

const { data } = await listWorlds({ client: customClient });

const r = await listWorlds();
if (r.error) {
  console.error(r.error.error.code, r.error.error.message);
} else {
  console.log(r.data?.worlds);
}