> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braintrust.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate from v1.x to v2.x

> Guide for migrating from TypeScript SDK v1.x to v2.x

## What's changed

Starting in v2.0.0, [Zod](https://zod.dev) is now a **peer dependency** instead of a bundled dependency. This gives you control over the Zod version in your project and reduces bundle size if you're already using Zod.

The SDK requires **Zod v3.25.34 or later**.

## Migration steps

**1. Install Zod**

Add Zod v3.25.34+ to your project alongside the Braintrust SDK:

```bash npm theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
npm install zod@^3.25.34
```

```bash pnpm theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
pnpm add zod@^3.25.34
```

```bash yarn theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
yarn add zod@^3.25.34
```

**2. Upgrade the SDK**

```bash npm theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
npm install braintrust@latest
```

```bash pnpm theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
pnpm add braintrust@latest
```

```bash yarn theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
yarn add braintrust@latest
```

**3. Verify your setup**

Run your build to ensure everything works:

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
npm run build
```

If you see any Zod-related type errors, ensure your Zod version is v3.25.34 or later.

## Troubleshooting

**"Cannot find module 'zod'"** — You need to install Zod as shown in Step 1.

**Type mismatches with Zod schemas** — If you're passing Zod schemas between your code and the Braintrust SDK, ensure you're using the same Zod version. Check for duplicate Zod installations:

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
npm ls zod
```

> [!NOTE]
>
> If you encounter issues during migration, please [open an issue](https://github.com/braintrustdata/braintrust-sdk-javascript/issues) with details about your setup.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.