import { login, logout, checkAuth, getToken } from "@poe-code/poe-auth";

// Interactive login (opens browser for OAuth, or pass apiKey directly)
const apiKey = await login();

// Check stored credentials and fetch identity
const identity = await checkAuth(); // { email, balance } | null

// Retrieve stored API key
const token = await getToken(); // string | null

// Remove stored credentials
await logout();

import { createOAuthClient } from "@poe-code/poe-auth";

const client = createOAuthClient({
  clientId: "your-client-id",
  authorizationEndpoint: "https://poe.com/oauth/authorize",
  tokenEndpoint: "https://api.poe.com/token",
  openBrowser: async (url) => { /* open url in browser */ },
  readLine: async () => { /* read manual paste from terminal */ }
});

const authorization = await client.authorize();
// authorization.authorizationUrl — URL to open in browser
const result = await authorization.waitForResult();
// result.apiKey, result.expiresIn

import { isValidApiKeyFormat, normalizeApiKey } from "@poe-code/poe-auth";

isValidApiKeyFormat("sk-poe-abc123..."); // true
normalizeApiKey("  sk-poe-abc123...  "); // trimmed + validated