# What changed in @turbopuffer/turbopuffer

> 34 changes in @turbopuffer/turbopuffer 1 to 2 from its official release notes, upgrade guides and advisories: 2 breaking, 26 new APIs and options. Each one cited. Sources checked 2026-11-13. HTML: https://unstale.sh/npm/@turbopuffer/turbopuffer/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @turbopuffer/turbopuffer 2

### Breaking changes

- Exposes computed attributes and types compute_attributes as the Expr union. (2.7.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.7.0)

### New APIs and options

- Splits query consistency into strong and eventual variants. (2.13.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.13.0)
- Adds encryption_context to customer-managed encryption. (2.13.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.13.0)
- Adds max_staleness_seconds to eventual consistency. (2.13.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.13.0)
- The client can listen via a request observer and send client telemetry. (2.12.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.12.0)
- Embedding stats are exposed in the OpenAPI specification. (2.11.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.11.0)
- Index status now exposes unindexed_rows. (2.11.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.11.0)
- Add drop to attribute schemas to remove an attribute from a namespace's schema. (2.10.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.10.0)
- Add create_namespace to writes to create a namespace even if the write contains no documents. (2.10.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.10.0)
- Adds asynchronous copy_from_namespace endpoints. (2.9.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.9.0)
- Adds the read_only field to namespaces. (2.9.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.9.0)
- Adds pagination through offset. (2.9.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.9.0)
- Exposes billed_replicas in pinning metadata. (2.9.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.9.0)
- Adds the RRF weights parameter. (2.7.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.7.0)
- SDKs support the late_interaction parameter. (2.6.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.6.0)
- The OpenAPI spec adds sharding config, making it available in the SDK API surface. (2.6.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.6.0)
- Supports dest_encryption in copy_from_namespace, allowing destination encryption to be specified when copying from a namespace. (2.5.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.5.0)
- The SDKs now support case-insensitive fuzzy filters. (2.4.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.4.0)
- Adds support for the word_v4 tokenizer. (2.3.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.3.0)
- Adds transparent async polling to the SDK. (2.2.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.2.0)

### Behavior and default changes

- The Node transport now respects Node's env proxy settings. (2.14.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.14.0)
- The client now sends client-generated request IDs. (2.13.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.13.0)

### Fixes and other changes

- Corrects async copy requests. (2.9.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.9.0)
- Requests with an omitted optional body now send the Content-Type header. (2.5.1) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v2.5.1)

## @turbopuffer/turbopuffer 1

### Breaking changes

- The default FTS tokenizer is now word_v2. (1.0.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.0.0)

### New APIs and options

- The /metadata response now includes pinning status. (1.22.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.22.0)
- Adds a method to configure pinning. (1.22.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.22.0)
- A verbose form of branch_from_namespace is available. (1.21.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.21.0)
- Adds branching to the tpuf OpenAPI spec. (1.20.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.20.0)
- Adds a performance object to responses, making response performance information available to developers. (1.20.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.20.0)
- MCP is hosted on Stainless, making it available for developers to use. (1.19.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.19.0)
- An MCP code execution tool was added. (1.0.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.0.0)

### Fixes and other changes

- Escapes backticks in MCP instructions when necessary. (1.20.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.20.0)
- Uses higher precision for client retry delays. (1.20.0) — [release notes](https://github.com/turbopuffer/turbopuffer-typescript/releases/tag/v1.20.0)
