TypeScript quickstart

npm install @vendodev/sdk
# or
yarn add @vendodev/sdk
# or
pnpm add @vendodev/sdk

# .env — no VENDO_API_KEY needed
OPENAI_API_KEY=sk-...
TELEGRAM_BOT_TOKEN=12345:abcde

import { Vendo } from "@vendodev/sdk";

const vendo = new Vendo(); // reads VENDO_API_KEY from env; absent = OSS mode

const openaiKey = await vendo.token("openai");   // returns OPENAI_API_KEY
const botToken = await vendo.token("telegram");  // returns TELEGRAM_BOT_TOKEN

VENDO_API_KEY=vendo_sk_...

import { Vendo } from "@vendodev/sdk";

const vendo = new Vendo(); // detects mode from VENDO_API_KEY automatically

const openaiKey = await vendo.token("openai");

// List connections
const connections = await vendo.connections.list();

// Check balance
const balance = await vendo.billing.balance();

const vendo = new Vendo({
  apiKey: "vendo_sk_...",
  baseUrl: "https://vendo.run/api",
  apiVersion: "2026-05-02",
});

const tokens = await vendo.tokens(["openai", "slack", "telegram"]);
// { openai: "sk-...", slack: "xoxb-...", telegram: null }

import { isVendoMode } from "@vendodev/sdk";
isVendoMode(); // true if VENDO_API_KEY is set