A TypeScript SDK for the Hevy API – compatible with Node.js, JavaScript frameworks, and browser environments.

• Fully typed API client for Hevy
• Supports both ESM and CommonJS
• Works in Node.js and browser environments
• Includes helpers for workouts, users, and error handling
• Built-in Zod validation for workout data

npm install hevy-sdk

import { HevyClient, HevyClientConfig, Workout } from "hevy-sdk";

const config: HevyClientConfig = { apiKey: "your-api-key" };
const client: HevyClient = new HevyClient(config);

// Get specific workout info
const workout: Workout = await client.workouts.getWorkout("workout-id");

The SDK throws rich error types:

• NetworkError: For network/fetch issues
• ValidationError: For Zod validation failures
• APIError: For errors from Hevy API

• HevyClient: Main SDK client
• Workouts: Workouts API section
• Users: Users API section
• Routines: Routines API section

MIT