# cloudflare/workers-sdk · Reposen Release & Migration Intelligence

> Add images url transformations and trigger deploy diff flags. Update wrangler to 4.166.0. Migration: Low.

## Metadata
- **Repository URL**: https://github.com/cloudflare/workers-sdk
- **Primary Package**: `wrangler` (NPM)
- **Categories**: `FRAMEWORK`, `RUNTIME`, `BUILD_TOOL`
- **Latest Version**: `wrangler@4.166.0`
- **Semantic Status**: `COMPATIBLE`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/cloudflare/workers-sdk/releases.atom

## The Human Context (Plain-English Pitch)
Wrangler is the official command-line tool and development framework for building, testing, and deploying applications on Cloudflare Workers. It helps developers manage configurations, preview serverless functions locally, and ship production code to Cloudflare's edge network. This release introduces helpful configuration options for image transformations and improves deployment dry runs and diff views.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Add images url transformations and trigger deploy diff flags. Update wrangler to 4.166.0. Migration: Low.

## Breaking Changes & Required Actions
- Added `images.url_transformations` to configure `/cdn-cgi/image/` transformations directly within `wrangler.toml` or `cloudflare.config.ts`.
- Added `--show-diff` and expanded dry-run summaries to `wrangler triggers deploy` for inspecting route and schedule changes prior to publishing.
- Updated `Undici` to version `7.30.2` to incorporate upstream security fixes for caching, redirects, and integrity verification.
- Improved deployment resilience by automatically retrying newly uploaded worker versions that temporarily return not-found errors.

## Migration Snippet
```ts
npm install --save-dev wrangler@4.166.0
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **Node.js >=18** [`COMPATIBLE`]: Requires standard modern Node.js runtime environments for CLI execution.

## Zero-Noise Release Timeline
- **wrangler@4.166.0** (2026-11-20) [COMPATIBLE]: Add images url transformations and trigger deploy diff flags. Update wrangler to 4.166.0. Migration: Low.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is cloudflare/workers-sdk wrangler@4.166.0 safe to upgrade in production?
cloudflare/workers-sdk wrangler@4.166.0 is classified as COMPATIBLE (MINOR release). Add images url transformations and trigger deploy diff flags. Update wrangler to 4.166.0. Migration: Low.

### What breaking changes or compatibility risks exist in cloudflare/workers-sdk wrangler@4.166.0?
No breaking API changes or peer dependency conflicts are recorded for cloudflare/workers-sdk wrangler@4.166.0 in the Reposen compatibility graph.

### What is the bundle size impact of wrangler wrangler@4.166.0?
Measured bundle size telemetry is currently unavailable for wrangler wrangler@4.166.0; verify build output locally before deploying.

### How do I upgrade wrangler to wrangler@4.166.0?
Upgrade wrangler to wrangler@4.166.0 by running "npm install wrangler@wrangler@4.166.0" and applying the migration steps: npm install --save-dev wrangler@4.166.0
