TypeScript SDK

npm install @vendodev/sdk

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

const vendo = new Vendo({
  apiKey?: string,      // defaults to process.env.VENDO_API_KEY
  baseUrl?: string,     // defaults to process.env.VENDO_BASE_URL || "https://vendo.run/api"
  apiVersion?: string,  // defaults to "2026-05-02"
});

await vendo.token(slug: string): Promise<string>
await vendo.tokens(slugs: string[]): Promise<Record<string, string | null>>
await vendo.invalidate(slug: string): Promise<void>
vendo.forRequest(headers: HeadersLike): Vendo  // Vendo mode only
vendo.forUser(jwt: string): Vendo              // Vendo mode only
await vendo.connectUrl(slug: string, opts?: { returnTo?: string }): Promise<string>

// Sub-APIs
vendo.connections   // ConnectionsAPI
vendo.integrations  // IntegrationsAPI
vendo.billing       // BillingAPI (Vendo mode only)
vendo.events        // EventsAPI (Vendo mode only)
vendo.webhooks      // WebhooksAPI (both modes)
vendo.sso           // SSOAPI
vendo.deployment    // DeploymentAPI

import { isVendoMode, connectUrl, getCredential } from "@vendodev/sdk";

isVendoMode(): boolean
connectUrl(slug, opts): string
getCredential(slug)  // legacy 0.0.x compat

await vendo.connections.list(): Promise<Connection[]>
await vendo.connections.get(slug: string): Promise<Connection | null>

await vendo.integrations.list(): Promise<Integration[]>
await vendo.integrations.get(slug: string): Promise<Integration | null>
await vendo.integrations.envVars(slug: string): Promise<string[]>

await vendo.billing.balance(): Promise<Balance>

for await (const event of vendo.events.subscribe()) { ... }
for await (const event of vendo.events.subscribe({ signal: AbortSignal })) { ... }

vendo.webhooks.verify(
  headers: Record<string, string>,
  body: string
): WebhookEvent

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

await reconciler.start({
  envFile: string,
  mapping: () => Promise<Record<string, string>>,
  onChange: "restart" | ((diff: Record<string, string>) => void),
})

import {
  VendoError,
  NotConnected,
  NeedsReauth,
  AuthError,
  RateLimited,
  BalanceExhausted,
  SpendCapExceeded,
  UpstreamError,
  ValidationError,
  IdempotencyConflict,
  VendoOnlyFeature,
  IdentityNotPresent,
} from "@vendodev/sdk";

import { MockClient, fakeConnection } from "@vendodev/sdk";

import { register, VendoConnectButton, VendoConnectionCard } from "@vendodev/sdk/browser";