Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vibefollow.com/llms.txt

Use this file to discover all available pages before exploring further.

Semver. Major versions are breaking; minor are additive; patch are bug fixes and metadata.
The SDK version is exported as SDK_VERSION and flows into the User-Agent header on every request — the backend can flag outdated clients.
npm install @vibefollow/sdk@latest
This page mirrors packages/sdk/CHANGELOG.md — the npm package’s CHANGELOG.md is the canonical record.
​
1.0.0
2026-05-17 — initial public release
Added
  • VibeFollow class with users, events, and webhooks resources.
  • 9 typed lifecycle helpers on vf.users.* (signedUp, trialStarted, …).
  • events.track() for custom events and events.batch() for buffered emission.
  • webhooks.constructEvent() for signed delivery verification.
  • Typed error hierarchy: AuthError, ValidationError, RateLimitError, ServerError, NetworkError, WebhookSignatureError.
  • Auto-retry with exponential backoff plus jitter on transient failures.
  • Auto-Idempotency-Key on every POST.
  • Edge-runtime support: Node 20+, Cloudflare Workers (with nodejs_compat), Vercel Edge, Deno.
Endpoints documented
  • POST /api/v1/users — upsert user
  • POST /api/v1/events — track event
  • POST /api/v1/events/batch — batch track events
Not yet shipped
  • Outbound webhook delivery from the backend — SDK-side verification is fully tested, backend emission targets end of June 2026.
  • Sandbox API keys (sk_test_… prefix) — production keys (sk_live_…) work today.
For the full per-commit history see the SDK repository.