The typed access layer for the cPod platform.

import { CpodClient } from "@cpod/sdk";

// 1. Open Keycloak — your app starts the login (the SDK builds the URL):
const { loginUrl } = CpodClient.beginLogin({
  backendUrl: "https://api.cyberpod.app",
  returnTo: "https://app.example.com/auth/callback",
});
// → redirect the browser to loginUrl (Keycloak)

// 2. Back on /auth/callback?code=… — swap the one-time code for a token:
const { accessToken, refreshToken } = await CpodClient.exchangeCode({
  backendUrl: "https://api.cyberpod.app",
  code, // from the callback query
});

// 3. Zero credentials: build the client and run as that user.
const client = CpodClient.fromToken(accessToken, { refreshToken });
const people = await client.people.persons.list();
console.log(people.data);