feat(netlify): dev context (#14269)

Author: florian-lefebvre

.changeset/icy-boxes-fetch.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/netlify': patch
+---
+
+Updates `context.netlify` to implement all its properties

knip.js

@@ -37,6 +37,7 @@ export default {
 				'rehype-slug',
 				'rehype-toc',
 				'remark-code-titles',
+				'@types/http-cache-semantics',
 			],
 		},
 		'packages/db': {

packages/astro/package.json

@@ -214,7 +214,7 @@
     "rollup": "^4.37.0",
     "sass": "^1.86.0",
     "typescript": "^5.8.3",
-    "undici": "^7.5.0",
+    "undici": "^6.21.3",
     "unified": "^11.0.5",
     "vitest": "^3.0.9"
   },

packages/astro/src/assets/types.ts

@@ -18,7 +18,6 @@ export type AssetsGlobalStaticImagesList = Map<
 >;
 
 declare global {
-	// eslint-disable-next-line no-var
 	var astroAsset: {
 		imageService?: ImageService;
 		addStaticImage?:

packages/integrations/cloudflare/package.json

@@ -41,7 +41,7 @@
     "@cloudflare/workers-types": "^4.20250507.0",
     "tinyglobby": "^0.2.13",
     "vite": "^6.3.5",
-    "wrangler": "^4.14.1"
+    "wrangler": "4.14.1"
   },
   "peerDependencies": {
     "astro": "^5.7.0"

packages/integrations/cloudflare/src/utils/handler.ts

@@ -28,11 +28,9 @@ export interface Runtime<T extends object = object> {
 
 declare global {
 	// This is not a real global, but is injected using Vite define to allow us to specify the session binding name in the config.
-	// eslint-disable-next-line no-var
 	var __ASTRO_SESSION_BINDING_NAME: string;
 
 	// Just used to pass the KV binding to unstorage.
-	// eslint-disable-next-line no-var
 	var __env__: Partial<Env>;
 }
 

packages/integrations/cloudflare/test/fixtures/astro-dev-platform/package.json

@@ -7,6 +7,6 @@
     "astro": "workspace:*"
   },
   "devDependencies": {
-    "wrangler": "^4.14.1"
+    "wrangler": "4.14.1"
   }
 }

packages/integrations/cloudflare/test/fixtures/astro-env/package.json

@@ -7,6 +7,6 @@
     "astro": "workspace:*"
   },
   "devDependencies": {
-    "wrangler": "^4.14.1"
+    "wrangler": "4.14.1"
   }
 }

packages/integrations/cloudflare/test/fixtures/sessions/package.json

@@ -7,7 +7,7 @@
   },
   "devDependencies": {
     "astro": "workspace:*",
-    "wrangler": "^4.14.1"
+    "wrangler": "4.14.1"
   },
   "scripts": {
     "build": "astro build",

packages/integrations/netlify/src/index.ts

@@ -501,16 +501,21 @@ export default function netlifyIntegration(
 		};
 
 		const context: Context = {
+			get url(): never {
+				throw new Error('Please use Astro.url instead.');
+			},
+			// The dev server is a long running process, so promises will run even with a noop
+			waitUntil: () => {},
 			account: parseBase64JSON('x-nf-account-info') ?? {
 				id: 'mock-netlify-account-id',
 			},
-			// TODO: this has type conflicts with @netlify/functions ^2.8.1
-			// @ts-expect-error: this has type conflicts with @netlify/functions ^2.8.1
 			deploy: {
+				context: 'dev',
 				id:
 					typeof req.headers['x-nf-deploy-id'] === 'string'
 						? req.headers['x-nf-deploy-id']
 						: 'mock-netlify-deploy-id',
+				published: false,
 			},
 			site: parseBase64JSON('x-nf-site-info') ?? {
 				id: 'mock-netlify-site-id',
@@ -539,10 +544,6 @@ export default function netlifyIntegration(
 			get cookies(): never {
 				throw new Error('Please use Astro.cookies instead.');
 			},
-			flags: {
-				get: () => undefined,
-				evaluations: new Set<string>(),
-			} as unknown as Context['flags'],
 			json: (input) => Response.json(input),
 			log: console.info,
 			next: () => {