●Change8

Migrating to Drizzle ORM 0.44.0

Version 0.44.0 introduces 1 breaking change. This guide details how to update your code.

Released: 5/28/2025

1
Breaking Changes
3
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

DrizzleQueryErrorupstashCachedrizzle-orm/cache/upstashCacheCacheConfigonMutate.$withCache()

Breaking Changes

●Issue #1

Errors from database drivers are now wrapped in DrizzleQueryError. This may break existing error handling logic that relies on catching raw driver-specific error types.

Migration Steps

  1. 1
    Update error handling blocks to account for the new DrizzleQueryError wrapper if you inspect error properties.
  2. 2
    To enable caching, initialize the drizzle client with the 'cache' option using upstashCache or a custom implementation.
  3. 3
    If using custom caching, implement the strategy(), get(), put(), and onMutate() methods as defined in the new Cache API.

Release Summary

This release introduces a robust error-handling wrapper called DrizzleQueryError and a new extensible caching module with a native Upstash integration.

Need More Details?

View the full release notes and all changes for Drizzle ORM 0.44.0.

View Full Changelog