TypeScript and Python SDK setup and usage

npm install @yoshi-ai/sdk
# or
pnpm add @yoshi-ai/sdk

import Yoshi from "@yoshi-ai/sdk";

const yoshi = new Yoshi(); // reads YOSHI_API_KEY from env

const accounts = await yoshi.accounts.list();
const scores = await yoshi.scores.list();
const me = await yoshi.me.retrieve();
const summary = await yoshi.me.summary();

import Yoshi from "@yoshi-ai/sdk";

const yoshi = new Yoshi({
  apiKey: "yoshi_3xK9mP...",
  environment: "staging",
  maxRetries: 3,
  timeout: 60_000,
});

// Iterate over all transactions automatically
for await (const tx of yoshi.transactions.list({ limit: 100 })) {
  console.log(tx.merchant_name, tx.amount);
}

const page = await yoshi.transactions.list({ limit: 50 });
console.log(page.data);
console.log(page.has_more);

import Yoshi from "@yoshi-ai/sdk";

try {
  await yoshi.accounts.list();
} catch (err) {
  if (err instanceof Yoshi.AuthenticationError) {
    // 401 — invalid or revoked API key
  } else if (err instanceof Yoshi.RateLimitError) {
    // 429 — rate limited
    console.log("Retry after:", err.headers["retry-after"]);
  } else if (err instanceof Yoshi.NotFoundError) {
    // 404 — resource not found
  }
}