@astrojs/cloudflare

Patch Changes

• Fixes Cannot find package 'prismjs' errors when prismjs isn't hoisted, such as with pnpm's global virtual store or hoist=false

Minor Changes

• Reworks image processing on prerendered pages to use Astro's built-in image pipeline. Requires astro@^7.4.0

  Images on prerendered pages now behave the same as on other adapters. Images optimized with the Cloudflare Images binding are now properly cached between builds, and image options such as assetQueryParams and build.assetsPrefix are applied the same way as everywhere else.

Patch Changes

• Fixes the globalThis.process shim being prepended to client-side scripts. The shim is now only added to the server output.

• Fixes the @astrojs/cloudflare/hono usage example so i18n() is mounted before pages(). In the old order, i18n() never ran, so locale redirects and fallbacks were skipped.

• Fixes dev dependency scan failing when a frontmatter line starts with import.meta or import(

• Fixes remote images without a file extension failing with 400 Unsupported format: null when using the cloudflare-binding image service

  Astro only adds the f (format) parameter to /_image URLs when it can infer a format from the source, and otherwise leaves it off so the image service resolves the format from the source itself. Extensionless remote images, such as GitHub avatars like https://avatars.githubusercontent.com/u/1234, take that path. The image transform endpoint now falls back to the source's media type when f is absent, passing SVG sources through unchanged and encoding everything else as WebP. This also fixes SVG images, which are requested as f=svg and previously failed the same way.

• Fixes astro build failing with fetch failed / connect ECONNREFUSED 127.0.0.1:<port> during prerendering on hosts where localhost resolves to IPv6

  The prerenderer started its Vite preview server with host: 'localhost' and then built the fetch URL by re-stating that same hostname. localhost was therefore resolved twice, independently — once by listen() to pick a bind address and once by fetch() to pick a connect address — with nothing making the two agree. On hosts where those resolutions land on different families, the preview server listens on ::1 while fetch dials 127.0.0.1, and every prerender request is refused. The URL is now derived from the address actually bound, so bind and connect agree by construction.

Patch Changes

• Fixes image transforms without a specified quality outputting an higher quality than expected on certain formats

• Fixes optimizeDeps.include glob astro/runtime/** matching .d.ts files, which caused 83 unnecessary optimizer entries and empty output chunks per environment during dev

• Fixes image requests when using imageService: 'compile' with passthroughImageService().

Patch Changes

• Fixes a build failure when the wrangler config uses the exports field to declare Durable Object classes

• Fixes cold astro dev crashes when using the passthrough image service

• Fixes broken images on static sites by transforming prerendered images at build time with the default Cloudflare Images binding

• Pre-bundles renderer server entrypoints and the default console logger during dev so they are included in the initial optimization pass, preventing a mid-request re-optimization that could crash the dev server on Cloudflare (workerd).

Patch Changes

• Fixes a build crash when a custom worker entrypoint exports Durable Object classes alongside prerendered pages. The prerender worker no longer inherits durable_objects, migrations, or workflows from the entry worker config.

Minor Changes

• Adds concurrent rendering support for experimental.incrementalBuild, including when using @astrojs/cloudflare

  Incremental builds no longer disable caching when build.concurrency is greater than 1. Projects that set build.concurrency: 1 to keep the cache enabled can remove that workaround. Cloudflare builds also reduce serialization overhead for large prerendered pages.

• Adds a Cloudflare finalize() response handler for custom request handlers

  Call finalize() to apply cookies and Cloudflare CDN cache defaults to the response from an astro/fetch pipeline:

  import { astro, FetchState } from 'astro/fetch';
  import { cf, finalize } from '@astrojs/cloudflare/fetch';
  
  export default {
    async fetch(request: Request, env: Env, context: ExecutionContext) {
      const state = new FetchState(request);
      const asset = await cf(state, env, context);
      if (asset) return asset;
  
      return finalize(state, await astro(state));
    },
  };

  The @astrojs/cloudflare/hono middleware applies these response headers automatically. Cloudflare custom entrypoints also fall back to static assets when no Astro route matches and use the default server entrypoint when prerendering through workerd.

Patch Changes

• Fixes cold astro dev crashes by adding astro/app/manifest and @astrojs/cloudflare/cache/provider to the optimizeDeps.include list

Patch Changes

• Added @astrojs/prism to the list of dependencies to optimise. The dev server is now faster for sites that use Prism as code highlighter.

• Fixes React SSR failures on the first Cloudflare dev request when JSON logging is enabled

Patch Changes

• Updates generated and default Cloudflare compatibility_date values to match the installed runtime and requires Wrangler ^4.125.0

• Adds the Worker version to the cache metadata of cached responses when the CF_VERSION_METADATA binding is configured. Responses carry an astro-version:<id> cache tag for version-specific purging, and responses that already send Last-Modified get a weak ETag that folds the version in. Conditional revalidation then returns fresh content after a deploy that changes rendered output but not content — most commonly the hashed asset URLs in server-rendered HTML. Without the binding, nothing changes.

Patch Changes

• Fixes dep scanning failure when .astro frontmatter contains regex literals with quote characters (e.g. /"/g)

Patch Changes

• Fixes the astro peer dependency range from ^7.0.0 to ^7.2.0. The adapter imports symbols (beginContentEntryCollection, beginImageCollection, endContentEntryCollection, endImageCollection) from astro/app that were added in Astro 7.2.0, so earlier versions fail at build time with a MISSING_EXPORT error.

Minor Changes

• Adds opt-in build-time image optimization for the cloudflare-binding image service.

  When enabled, the Cloudflare IMAGES binding transforms static images in the workerd prerender environment, and the optimized bytes are written directly to the output directory. If the binding fails, it falls back to Sharp.

  To opt in, use the compound configuration form:

  export default defineConfig({
    adapter: cloudflare({
      imageService: { build: 'cloudflare-binding', runtime: 'cloudflare-binding' },
    }),
  });

  The string shorthand imageService: 'cloudflare-binding' preserves the current runtime-only behavior and is unaffected.

• When session: false is set in astro.config, the adapter no longer auto-wires the Cloudflare KV session driver. Combined with the matching astro change, this lets the session runtime tree-shake out of the Worker bundle.

• Supports Astro's experimental incremental static builds. When experimental.incrementalBuild is enabled, the adapter skips unchanged pages between builds.

Patch Changes

• Fixes /_image returning 500 in dev mode when using imageService: 'custom'. Astro's default dev image endpoint imports vite and node:fs, which cannot be loaded inside workerd. The custom and fallback cases now use the generic fetch-based endpoint in dev, matching the other image service modes. A user-configured image.endpoint is left untouched.

  Additionally, a dev-time warning is now logged when imageService: 'custom' resolves to the Sharp service (including when no image.service is configured), since Sharp's native binding cannot run inside workerd in dev or production.

• Fixes a crash on /_image cache hits when the Cloudflare cache provider is enabled. Responses served from the Workers Cache API have immutable headers, and the request handler crashed with "Can't modify immutable headers" when applying its default Cloudflare-CDN-Cache-Control: no-store header to them. The handler now rebuilds the response with mutable headers when needed.

• Fixes imageService: 'compile' producing unoptimized images when prerenderEnvironment is set to 'node'

• Fixes a type-checking error when using app.use(cf()) from @astrojs/cloudflare/hono in projects with wrangler types-generated ExecutionContext declarations

Patch Changes

• Fixes a bug where Cloudflare couldn't load chunked collections via experimental.collectionStorage: 'chunked'.

Patch Changes

• Fixes a bug where an explicit cache: { enabled: false } in your wrangler config was overridden and forced to true when a Workers cache provider was configured