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 []:
#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 []:
4d16de7]:
#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 []:
#13894 b36e72f Thanks @florian-lefebvre! - Removes special handling of the ASTRO_STUDIO_APP_TOKEN environment variable
Updated dependencies [0567fb7]:
f4e8889]:
#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, };}#13963 c667c55 Thanks @florian-lefebvre! - Fixes a case where the platform proxy would not be disposed when the dev process ended
Updated dependencies []:
#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 []:
#13792 7910fea Thanks @alexeyzimarev! - Unify imported images detection across adapters
Updated dependencies []:
#13731 c3e80c2 Thanks @jsparkdev! - update vite to latest version for fixing CVE
Updated dependencies []:
#13591 5dd2d3f Thanks @florian-lefebvre! - Removes unused code
Updated dependencies [5dd2d3f]:
#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' outputconst cart = await Astro.session.get('cart');---
<a href="/checkout">π {cart?.length ?? 0} items</a>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', },});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---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.
#13596 3752519 Thanks @jsparkdev! - update vite to latest version to fix CVE
#13547 360cb91 Thanks @jsparkdev! - Updates vite to the latest version
Updated dependencies []:
#13514 a9aafec Thanks @ascorbic! - Automatically configures Cloudflare KV storage when experimental sessions are enabled
If the experimental.session flag is enabled when using the Cloudflare adapter, Astro will automatically configure the session storage using the Cloudflare KV driver. You can still manually configure the session storage if you need to use a different driver or want to customize the session storage configuration. If you want to use sessions, you will need to create the KV namespace and declare it in your wrangler config. You can do this using the Wrangler CLI:
npx wrangler kv namespace create SESSIONThis will log the id of the created namespace. You can then add it to your wrangler.json/wrangler.toml file like this:
{ "kv_namespaces": [ { "binding": "SESSION", "id": "<your kv namespace id here>", }, ],}By default it uses the binding name SESSION, but if you want to use a different binding name you can do so by passing the sessionKVBindingName option to the adapter. For example:
import { defineConfig } from 'astro/config';import cloudflare from '@astrojs/cloudflare';export default defineConfig({ output: 'server', site: `http://example.com`, adapter: cloudflare({ platformProxy: { enabled: true, }, sessionKVBindingName: 'MY_SESSION', }), experimental: { session: true, },});See the Cloudflare KV docs for more details on setting up KV namespaces.
See the experimental session docs for more information on configuring session storage.
#13526 ff9d69e Thanks @jsparkdev! - update vite to the latest version
Updated dependencies []:
#13505 a98ae5b Thanks @ematipico! - Updates the dependency vite to the latest.
Updated dependencies []:
#13444 9721f4a Thanks @florian-lefebvre! - Adds global astro:env support
Cloudflare workers now support importing env in the global scope. Until now, calling astro:env APIs had to be done within request scope or the values were undefined.
With this release, they can be called anywhere server-side, like any other official adapter.
042d1de]:
#13323 80926fa Thanks @ematipico! - Updates esbuild and vite to the latest to avoid false positives audits warnings caused by esbuild.
Updated dependencies [1e11f5e]:
#13304 6efd57d Thanks @ematipico! - Fixes a small issue where the package was pulling an outdated version of its internal dependencies.
#13201 065157c Thanks @ekwoka! - Includes onerror passthrough param for Cloudflare Image Service
#13299 2e1321e Thanks @bluwy! - Uses tinyglobby for globbing files
Updated dependencies []: