Swift SDK

.package(
    url: "https://github.com/runvendo/vendo-sdk-swift",
    from: "1.0.0"
)

import Vendo

// Vendo mode (reads VENDO_API_KEY from env)
let vendo = try Vendo()

// OSS/BYOK mode
let vendo = try Vendo(apiKey: "byok")

// Explicit
let vendo = try Vendo(apiKey: "vendo_sk_...", baseURL: URL(string: "https://vendo.run/api")!)

try await vendo.token(_ slug: String) -> String
try await vendo.tokens(_ slugs: [String]) -> [String: String?]

vendo.forRequest(headers: [String: String]) throws -> Vendo  // Vendo mode only
vendo.forUser(jwt: String) -> Vendo                          // Vendo mode only

try vendo.connectURL(slug: String, returnTo: String? = nil) -> URL  // Vendo mode only

vendo.connections    // ConnectionsAPI
vendo.integrations   // IntegrationsAPI
vendo.billing        // BillingAPI (Vendo mode only)
vendo.events         // EventsAPI (Vendo mode only)
vendo.webhooks       // WebhooksAPI (both modes)

try await vendo.connections.list() -> [Connection]
try await vendo.connections.get(slug: String) -> Connection?

try await vendo.integrations.list() -> [Integration]
try await vendo.integrations.get(slug: String) -> Integration?
vendo.integrations.envVars(for slug: String) -> [String]  // no network call

try await vendo.billing.balance() -> Balance
try await vendo.billing.spendCaps() -> [SpendCap]
try await vendo.billing.usage(period: BillingPeriod) -> Usage

let stream = try vendo.events.subscribe()  // AsyncThrowingStream<VendoEvent, Error>

for try await event in stream {
    print(event.type, event.data)
}

let webhooks = WebhooksAPI(secret: "whsec_...")
// or:
vendo.webhooks.verify(
    headers: [String: String],
    body: String,
    maxAgeSeconds: Int = 300
) throws -> WebhookEvent

public enum VendoError: Error {
    case auth(String)
    case notConnected(String, String)
    case needsReauth(String, String, URL?)
    case balanceExhausted(String)
    case spendCapExceeded(String)
    case rateLimited(Int?)
    case upstream(String)
    case validation(String)
    case idempotencyConflict(String)
    case vendoOnlyFeature(String)
    case identityNotPresent
    case other(String)
}