⚠️ Breaking Change
Impact Score: 7/10
Astro [email protected] — Release Notes & Engineering Impact
Source available — automated, not human-reviewed
Component: astro · Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
Breaking-change evidence from the source
- [#14286](https://github.com/withastro/astro/pull/14286) [`09c5db3`](https://github.com/withastro/astro/commit/09c5db37d12862eef8d4ecf62389e10f30a22de9) Thanks [@ematipico](https://github.com/ematipico)! - **BREAKING CHANGES only to the experimental CSP feature**
⚡ Executive Summary (TL;DR)
Astro [email protected]. Source highlight: **BREAKING CHANGES only to the experimental CSP feature**
Who Does This Impact? (Role-Based Analysis)
💻 Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
📊 Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
⚙️ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
⚠️ Breaking Changes & Deprecations (1)
- - [#14286](https://github.com/withastro/astro/pull/14286) [`09c5db3`](https://github.com/withastro/astro/commit/09c5db37d12862eef8d4ecf62389e10f30a22de9) Thanks [@ematipico](https://github.com/ematipico)! - **BREAKING CHANGES only to the experimental CSP feature**
🔧 Bug Fixes & Patches (6)
- **BREAKING CHANGES only to the experimental CSP feature**
- `Astro.insertDirective` to `Astro.csp.insertDirective`
- `Astro.insertStyleResource` to `Astro.csp.insertStyleResource`
- `Astro.insertStyleHash` to `Astro.csp.insertStyleHash`
- `Astro.insertScriptResource` to `Astro.csp.insertScriptResource`
- `Astro.insertScriptHash` to `Astro.csp.insertScriptHash`
📄 View Raw Release Notes (Original Developer Log)
### Patch Changes
- [#14286](https://github.com/withastro/astro/pull/14286) [`09c5db3`](https://github.com/withastro/astro/commit/09c5db37d12862eef8d4ecf62389e10f30a22de9) Thanks [@ematipico](https://github.com/ematipico)! - **BREAKING CHANGES only to the experimental CSP feature**
The following runtime APIs of the `Astro` global have been renamed:
- `Astro.insertDirective` to `Astro.csp.insertDirective`
- `Astro.insertStyleResource` to `Astro.csp.insertStyleResource`
- `Astro.insertStyleHash` to `Astro.csp.insertStyleHash`
- `Astro.insertScriptResource` to `Astro.csp.insertScriptResource`
- `Astro.insertScriptHash` to `Astro.csp.insertScriptHash`
The following runtime APIs of the `APIContext` have been renamed:
- `ctx.insertDirective` to `ctx.csp.insertDirective`
- `ctx.insertStyleResource` to `ctx.csp.insertStyleResource`
- `ctx.insertStyleHash` to `ctx.csp.insertStyleHash`
- `ctx.insertScriptResource` to `ctx.csp.insertScriptResource`
- `ctx.insertScriptHash` to `ctx.csp.insertScriptHash`
- [#14283](https://github.com/withastro/astro/pull/14283) [`3224637`](https://github.com/withastro/astro/commit/3224637eca5c065872d92449216cb33baac2dbfd) Thanks [@ematipico](https://github.com/ematipico)! - Fixes an issue where CSP headers were incorrectly injected in the development server.
- [#14275](https://github.com/withastro/astro/pull/14275) [`3e2f20d`](https://github.com/withastro/astro/commit/3e2f20d07e92b1acfadb1357a59b6952e85227f3) Thanks [@florian-lefebvre](https://github.com/florian-lefebvre)! - Adds support for experimental CSP when using experimental fonts
Experimental fonts now integrate well with experimental CSP by injecting hashes for the styles it generates, as well as `font-src` directives.
No action is required to benefit from it.
- [#14280](https://github.com/withastro/astro/pull/14280) [`4b9fb73`](https://github.com/withastro/astro/commit/4b9fb736dab42b8864012db0a981d3441366c388) Thanks [@ascorbic](https://github.com/ascorbic)! - Fixes a bug that caused cookies to not be correctly set when using middleware sequences
- [#14276](https://github.com/withastro/astro/pull/14276) [`77281c4`](https://github.com/withastro/astro/commit/77281c4616b65959715dcbac42bf948bebfee755) Thanks [@ArmandPhilippot](https://github.com/ArmandPhilippot)! - Adds a missing export for `resolveSrc`, a documented image services utility.