@astrojs/[email protected]

Patch Changes

• #344 8d7766e Thanks @Fryuni! - Updates a dependency to align the peer dependency version for Astro

@astrojs/[email protected]

Minor Changes

• #326 6dd65a0 Thanks @ascorbic! - Sets immutable cache headers for static assets

@astrojs/[email protected]

Patch Changes

• #341 a430ab1 Thanks @alexanderniebuhr! - Fixes an issue if environment variables where used inside the middleware and a prerendering occured.

• #335 237f332 Thanks @alexanderniebuhr! - Fixes an issue displaying images which are optimized during astro build

@astrojs/[email protected]

Patch Changes

• #340 45d0abb Thanks @alexanderniebuhr! - Fixes an issue if environment variables where used inside the middleware and a prerendering occured.

@astrojs/[email protected]

Minor Changes

• #315 a45eb36 Thanks @eduardoboucas! - Refactors the adapter to use the Netlify Frameworks API

Patch Changes

• #286 e2ecf64 Thanks @theoephraim! - Allows support for node: prefixed imports if using the Adapter with edgeMiddleware: true

@astrojs/[email protected]

Patch Changes

• #316 d81806a Thanks @ascorbic! - Fixes a regression where edge middleware tried to bundle node builtins

@astrojs/[email protected]

Patch Changes

• #313 55a3e1a Thanks @ascorbic! - Fixes an issue where files were not included in the SSR function when built in a monorepo

@astrojs/[email protected]

Patch Changes

• #296 8a00cad Thanks @ascorbic! - Improves performance for serverless function builds by not bundling dependencies

@astrojs/[email protected]

Patch Changes

• #302 dc0039f Thanks @alexanderniebuhr! - Fixes an issue where projects break when no wrangler.toml file was present

@astrojs/[email protected]

Major Changes

• #290 1c4145e Thanks @alexanderniebuhr! - Cloudflare v11

  Upgrades

  Supported Astro versions

  This release drops support for Astro versions <= 4.10.2. The new supported and required Astro versions are >= 4.10.3. This allowed us to remove additional workarounds related to projects with many prerendered pages. This should fix all bundling issues that are not caused by an upstream package.

  What should I do?

  If you still observe an issue, please check current open issues or create a new one in the repository.

  To upgrade an existing project, use the automated @astrojs/upgrade CLI tool. Alternatively, upgrade manually by running the upgrade command from your package manager:

  # Recommended:
  npx @astrojs/upgrade
  
  # Manual:
  npm install astro@latest
  pnpm upgrade astro --latest
  yarn upgrade astro --latest
  

  Changes

  astro:env

  This release adds experimental support for astro:env, which helps to streamline the usage of environment variables for Astro projects. You can read more about it in Astro Docs. IMPORTANT: Cloudflare Bindings are not supported by astro:env, and still should be accessed by using Astro.locals.runtime.env or context.locals.runtime.env. astro:env supports environment variables only.

  What should I do?

  If you observe any issues, please check current open issues or create a new one in the repository.

  To add environment variables to your project, you still need to make sure they are available in three places. You're setup might require different steps to achieve this, so we can't give you a complete step-by-step guide, on how to achieve the requirements, but here are some guidance to get you started:

  • process.env during build in your node process (astro build)
  • wrangler.toml for local development (astro dev)
  • Cloudflare Pages Dashboard for production deployments

  Add "public" environment variables to your wrangler.toml. (If you add pages_build_output_dir = "./dist" to your wrangler.toml, these will be synced to your Cloudflare Pages Dashboard, and you don't have to add them there manually):

  # wrangler.toml
  name = "test"
  
  +[vars]
  +API_URL = "https://google.de"
  +PORT = 4322
  
  # ...

  If you also need "secret" environment variables (e.g. API Keys, etc.), you add them to your .dev.vars file. (These won't be synced automatically, and you need to add them manually as encrypted variables to the Cloudflare Pages Dashboard or use wrangler CLI to push them):

  # .dev.vars
  + API_SECRET=123456789

  With your environment variables added to those two files and synced to the Cloudflare Pages Dashboard, you should be able to use them with astro:env when running astro dev & astro build, but you need to use Cloudflare's Build Pipeline and Cloudflare's GitHub App connection.

  However if you build your project locally or inside a custom GitHub Action and deploy with direct upload to Cloudflare, you need to ensure that the environment variables are also available for your build process. The simplest but not safest is to use your shell, e.g. API_URL=https://google.de PORT=4322 API_SECRET=123456789 astro build. For more complex setups, you should find out the way for your specific setup to provide environment variables to the build process.

  Additionally, you need to define your schema inside your astro.config.mjs file:

  import { defineConfig, envField } from "astro/config"
  
  export default defineConfig({
  +  experimental: {
  +    env: {
  +      schema: {
  +        API_URL: envField.string({ context: "client", access: "public", optional: true }),
  +        PORT: envField.number({ context: "server", access: "public", default: 4321 }),
  +        API_SECRET: envField.string({ context: "server", access: "secret" }),
  +      }
  +    }
  +  }
  })

  Finally, you should be able to access your environment variables in your Astro project, according to the Astro Docs, e.g. import { API_URL } from "astro:env/client" or import { PORT, API_SECRET } from "astro:env/server".

  NOTE: If you want to use environment variables in other files that are not .astro or middleware files, you still need to make sure you don't access the variable in a global scope. We recommend wrapping your logic with a function, which you then call from your .astro or middleware files inside the request scope.

  // foo.ts
  import { MY_SECRET } from 'astro:env/server';
  
  // DOESN'T WORK
  const client = myLib(MY_SECRET);
  
  // WORKS
  export const bar = () => {
    const client = myLib(MY_SECRET);
    return client;
  };

  watch config files

  This release starts monitoring your wrangler.toml and .dev.vars files for changes and restarting the dev server if you update them.

  What should I do?

  If you observe any issues, please check current open issues or create a new one in the repository.

  BREAKING: imageService

  This release changes the default behavior of imageService. In the past the default behavior was falling back to a noop service, which disabled image optimization for your project, because Cloudflare doesn's support it. The new default is compile, which enables image optimization for prerendered pages during build, but disallows the usage of any astro:assets feature inside of on-demand pages.

  What should I do?

  If you experience issues with the new setting, you can revert back to the old setting by setting imageService to passthrough. Furthermore if you observe any issues, please check current open issues or create a new one in the repository.

  // astro.config.mjs
  
  // ...
  adapter: cloudflare({
  -  imageService: 'compile',
  }),
  // ...

  BREAKING: platformProxy

  This release enables platformProxy by default. While most projects shouldn't be affected, this is a breaking change on paper.

  What should I do?

  If you experience issues with the new default, you can deactivate it by setting platformProxy.enabled to false. Furthermore if you observe any issues, please check current open issues or create a new one in the repository.

  // astro.config.mjs
  
  // ...
  adapter: cloudflare({
  -  platformProxy: {
  -    enabled: true,
  -  },
  }),
  // ...

  BREAKING: passThroughOnException

  This release throws an error if you use Cloudflare's passThroughOnException function because, as stated in Cloudflare docs, the function doesn't work with Cloudflare Pages.

  What should I do?

  If you observe any issues, please check current open issues or create a new one in the repository.

  Deprecations

  wasmModuleImports

  This release removes the previous deprecated wasmModuleImports adapter option and replaces it with the cloudflareModules option, which offers flexibility and support for more file types.

  What should I do?

  If you observe any issues, please check current open issues or create a new one in the repository.

  // astro.config.mjs
  
  // ...
  adapter: cloudflare({
  -  wasmModuleImports: true,
  }),
  // ...