@astrojs/cloudflare

12.6.12
Nov 26, 2025
🐞 Patch Changes
- #14777 9720b70 Thanks @iclectic! - Updates assets handling to use @astrojs/internal-helpers
- Updated dependencies []:
  - @astrojs/underscore-redirects@1.0.0
12.6.11
Nov 17, 2025
🐞 Patch Changes
- Updated dependencies [9e9c528, 0f75f6b]:
  - @astrojs/internal-helpers@0.7.5
  - @astrojs/underscore-redirects@1.0.0
12.6.10
Oct 9, 2025
🐞 Patch Changes
- b8ca69b Thanks @ascorbic! - Refactor remote path detection
- Updated dependencies [b8ca69b]:
  - @astrojs/internal-helpers@0.7.4
  - @astrojs/underscore-redirects@1.0.0
12.6.9
Sep 22, 2025
🐞 Patch Changes
- Updated dependencies [1e2499e]:
  - @astrojs/internal-helpers@0.7.3
  - @astrojs/underscore-redirects@1.0.0
12.6.8
Sep 8, 2025
🐞 Patch Changes
- #14326 c24a8f4 Thanks @jsparkdev! - Updates vite version to fix CVE
- Updated dependencies []:
  - @astrojs/underscore-redirects@1.0.0
12.6.7
Aug 29, 2025
🐞 Patch Changes
- #14281 dfd88de Thanks @ascorbic! - Fixes a regression that broke sites that used the compile image service without nodejs_compat set
- Updated dependencies []:
  - @astrojs/underscore-redirects@1.0.0
12.6.6
Aug 27, 2025
🐞 Patch Changes
- 9ecf359 Thanks @alexanderniebuhr! - Improves the image proxy endpoint when using the default compile option to adhere to user configuration regarding the allowed remote domains
- Updated dependencies []:
  - @astrojs/underscore-redirects@1.0.0
12.6.5
Aug 22, 2025
🐞 Patch Changes
- #14259 02366e9 Thanks @ascorbic! - Removes warning when using the adapter with a static build.
  
  The Cloudflare adapter now has several uses outside of on-demand rendered pages, so this warning is misleading. Similar warnings have already been removed from other adapters.
- #14234 15b55f3 Thanks @yanthomasdev! - Fixes an issue that could cause duplicate exports when configuring workerEntrypoint.namedExports
- #14240 77b18fb Thanks @delucis! - Increases the minimum supported version of Astro to 5.7.0
- Updated dependencies []:
  - @astrojs/underscore-redirects@1.0.0
12.6.4
Aug 15, 2025
🐞 Patch Changes
- Updated dependencies [4d16de7]:
  - @astrojs/internal-helpers@0.7.2
  - @astrojs/underscore-redirects@1.0.0
12.6.3
Aug 8, 2025
🐞 Patch Changes
- #14066 7abde79 Thanks @alexanderniebuhr! - Refactors the internal solution which powers Astro Sessions when running local development with ˋastro devˋ.
  
  The adapter now utilizes Cloudflare’s local support for Cloudflare KV. This internal change is a drop-in replacement and does not require any change to your projectct code.
  
  However, you now have the ability to connect to the remote Cloudflare KV Namespace if desired and use production data during local development.
- Updated dependencies []:
  - @astrojs/underscore-redirects@1.0.0
12.6.2
Aug 1, 2025
🐞 Patch Changes
- #13894 b36e72f Thanks @florian-lefebvre! - Removes special handling of the ASTRO_STUDIO_APP_TOKEN environment variable
- Updated dependencies [0567fb7]:
  - @astrojs/internal-helpers@0.7.1
  - @astrojs/underscore-redirects@1.0.0
12.6.1
Jul 31, 2025
🐞 Patch Changes
- Updated dependencies [f4e8889]:
  - @astrojs/internal-helpers@0.7.0
  - @astrojs/underscore-redirects@1.0.0

12.6.0

Jun 19, 2025

🍿 Minor Changes

#13837 7cef86f Thanks @alexanderniebuhr! - Adds new configuration options to allow you to set a custom workerEntryPoint for Cloudflare Workers. This is useful if you want to use features that require handlers (e.g. Durable Objects, Cloudflare Queues, Scheduled Invocations) not supported by the basic generic entry file.

This feature is not supported when running the Astro dev server. However, you can run astro build followed by either wrangler deploy (to deploy it) or wrangler dev to preview it.

The following example configures a custom entry file that registers a Durable Object and a queue handler:

import cloudflare from '@astrojs/cloudflare';
import { defineConfig } from 'astro/config';

export default defineConfig({
  adapter: cloudflare({
    workerEntryPoint: {
      path: 'src/worker.ts',
      namedExports: ['MyDurableObject'],
    },
  }),
});

import type { SSRManifest } from 'astro';

import { App } from 'astro/app';
import { handle } from '@astrojs/cloudflare/handler';
import { DurableObject } from 'cloudflare:workers';

class MyDurableObject extends DurableObject<Env> {
  constructor(ctx: DurableObjectState, env: Env) {
    super(ctx, env);
  }
}

export function createExports(manifest: SSRManifest) {
  const app = new App(manifest);
  return {
    default: {
      async fetch(request, env, ctx) {
        await env.MY_QUEUE.send('log');
        return handle(manifest, app, request, env, ctx);
      },
      async queue(batch, _env) {
        let messages = JSON.stringify(batch.messages);
        console.log(`consumed from our queue: ${messages}`);
      },
    } satisfies ExportedHandler<Env>,
    MyDurableObject,
  };
}

🐞 Patch Changes

#13963 c667c55 Thanks @florian-lefebvre! - Fixes a case where the platform proxy would not be disposed when the dev process ended
Updated dependencies []:
- @astrojs/underscore-redirects@1.0.0

12.5.5
Jun 17, 2025
🐞 Patch Changes
- #13930 acb9b30 Thanks @alexanderniebuhr! - Fixes an issue where setting values for Astro.response resulted in a Cloudflare runtime exception.
- Updated dependencies [de82ef2, de82ef2, de82ef2]:
  - @astrojs/underscore-redirects@1.0.0
12.5.4
Jun 5, 2025
🐞 Patch Changes
- #13817 b7258f1 Thanks @yanthomasdev! - Clarifies and reduces a few logs when starting the dev server with @astrojs/cloudflare.
  
  Warnings about sharp support will now be suppressed when you have explicitly set an imageService option.
- Updated dependencies []:
  - @astrojs/underscore-redirects@0.6.1
12.5.3
May 13, 2025
🐞 Patch Changes
- #13792 7910fea Thanks @alexeyzimarev! - Unify imported images detection across adapters
- Updated dependencies []:
  - @astrojs/underscore-redirects@0.6.1
12.5.2
Apr 30, 2025
🐞 Patch Changes
- #13731 c3e80c2 Thanks @jsparkdev! - update vite to latest version for fixing CVE
- Updated dependencies []:
  - @astrojs/underscore-redirects@0.6.1
12.5.1
Apr 23, 2025
🐞 Patch Changes
- #13591 5dd2d3f Thanks @florian-lefebvre! - Removes unused code
- Updated dependencies [5dd2d3f]:
  - @astrojs/underscore-redirects@0.6.1
12.5.0
Apr 15, 2025
🍿 Minor Changes
- #13527 2fd6a6b Thanks @ascorbic! - The experimental session API introduced in Astro 5.1 is now stable and ready for production use.
  
  Sessions are used to store user state between requests for on-demand rendered pages. You can use them to store user data, such as authentication tokens, shopping cart contents, or any other data that needs to persist across requests:
  --- export const prerender = false; // Not needed with 'server' output const cart = await Astro.session.get('cart'); --- <a href="/checkout">🛒 {cart?.length ?? 0} items</a>
  Configuring session storage
  
  Sessions require a storage driver to store the data. The Node, Cloudflare and Netlify adapters automatically configure a default driver for you, but other adapters currently require you to specify a custom storage driver in your configuration.
  
  If you are using an adapter that doesn’t have a default driver, or if you want to choose a different driver, you can configure it using the session configuration option:
  import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ adapter: vercel(), session: { driver: 'upstash', }, });
  Using sessions
  
  Sessions are available in on-demand rendered pages, API endpoints, actions and middleware.
  
  In pages and components, you can access the session using Astro.session:
  --- const cart = await Astro.session.get('cart'); --- <a href="/checkout">🛒 {cart?.length ?? 0} items</a>
  In endpoints, actions, and middleware, you can access the session using context.session:
  export async function GET(context) { const cart = await context.session.get('cart'); return Response.json({ cart }); }
  If you attempt to access the session when there is no storage driver configured, or in a prerendered page, the session object will be undefined and an error will be logged in the console:
  --- export const prerender = true; const cart = await Astro.session?.get('cart'); // Logs an error. Astro.session is undefined ---
  Upgrading from Experimental to Stable
  
  If you were previously using the experimental API, please remove the experimental.session flag from your configuration:
  import { defineConfig } from 'astro/config'; import node from '@astrojs/node'; export default defineConfig({ adapter: node({ mode: "standalone", }), experimental: { session: true, }, });
  See the sessions guide for more information.
🐞 Patch Changes
- Updated dependencies []:
  - @astrojs/underscore-redirects@0.6.0
12.4.1
Apr 14, 2025
🐞 Patch Changes
- #13596 3752519 Thanks @jsparkdev! - update vite to latest version to fix CVE
- #13547 360cb91 Thanks @jsparkdev! - Updates vite to the latest version
- Updated dependencies []:
  - @astrojs/underscore-redirects@0.6.0

@astrojs/cloudflare

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🍿 Minor Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🐞 Patch Changes

🍿 Minor Changes

Configuring session storage

Using sessions

Upgrading from Experimental to Stable

🐞 Patch Changes

🐞 Patch Changes