Environment API

.changeset/adapter-interface-breaking.md

@@ -0,0 +1,12 @@
+---
+'astro': minor
+---
+
+Adds new optional properties to `setAdapter()` for adapter entrypoint handling in the Adapter API
+
+**Changes:**
+- New optional properties:
+  - `devEntrypoint?: string | URL` - specifies custom dev server entrypoint
+  - `entryType?: 'self' | 'legacy-dynamic'` - determines if the adapter provides its own entrypoint (`'self'`) or if Astro constructs one (`'legacy-dynamic'`, default)
+
+**Migration:** Adapter authors can optionally add these properties to support custom dev entrypoints. If not specified, adapters will use the legacy behavior.

.changeset/cloudflare-entrypoint-breaking.md

@@ -0,0 +1,63 @@
+---
+'@astrojs/cloudflare': major
+---
+
+Changes the API for creating a custom `entrypoint`, replacing the `createExports()` function with a direct export pattern. 
+
+#### What should I do?
+
+If you're using a custom `entryPoint` in your Cloudflare adapter config, update your existing worker file that uses `createExports()` to reflect the new, simplified pattern:
+
+
+__my-entry.ts__
+
+```ts
+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: MyDurableObject,
+  }
+}
+```
+
+To create the same custom `entrypoint` using the updated API, export the following function instead:
+
+__my-entry.ts__
+
+```ts
+import { handle } from '@astrojs/cloudflare/utils/handler';
+
+export 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>,
+```
+
+The manifest is now created internally by the adapter.

.changeset/encoding-static-builds.md

@@ -0,0 +1,5 @@
+---
+'astro': major
+---
+
+Removes support for routes with percent-encoded percent signs (e.g. `%25`) - ([v6 upgrade guidance](https://deploy-preview-12322--astro-docs-2.netlify.app/en/guides/upgrade-to/v6/#removed-percent-encoding-in-routes))

.changeset/flat-lions-care.md

@@ -0,0 +1,7 @@
+---
+'@astrojs/cloudflare': minor
+---
+
+Adds support for `astro preview` command
+
+Developers can now use `astro preview` to test their Cloudflare Workers application locally before deploying. The preview runs using Cloudflare's workerd runtime, giving you a staging environment that matches production exactly—including support for KV namespaces, environment variables, and other Cloudflare-specific features.

.changeset/open-monkeys-boil.md

@@ -0,0 +1,33 @@
+---
+'@astrojs/cloudflare': major
+---
+
+Development server now runs in workerd
+
+`astro dev` now runs your Cloudflare application using Cloudflare's workerd runtime instead of Node.js. This means your development environment is now a near-exact replica of your production environment—the same JavaScript engine, the same APIs, the same behavior. You'll catch issues during development that would have only appeared in production, and features like Durable Objects, Workers Analytics Engine, and R2 bindings work exactly as they do on Cloudflare's platform.
+
+To accommodate this major change to your development environment, this update includes breaking changes to `Astro.locals.runtime`, removing some of its properties.
+
+#### What should I do?
+
+Update occurrences of `Astro.locals.runtime` as shown below:
+
+- `Astro.locals.runtime` no longer contains the `env` object. Instead, import it directly:
+  ```js
+  import { env } from 'cloudflare:workers';
+  ```
+
+- `Astro.locals.runtime` no longer contains the `cf` object. Instead, access it directly from the request:
+  ```js
+  Astro.request.cf
+  ```
+
+- `Astro.locals.runtime` no longer contains the `caches` object. Instead, use the global `caches` object directly:
+  ```js
+  caches.default.put(request, response)
+  ```
+
+- `Astro.locals.runtime` object is replaced with `Astro.locals.cfContext` which contains the Cloudflare `ExecutionContext`:
+  ```js
+  const cfContext = Astro.locals.cfContext;
+  ```

.changeset/route-data-breaking.md

@@ -0,0 +1,5 @@
+---
+'astro': major
+---
+
+Removes `RouteData.generate` from the Integration API - ([v6 upgrade guidance](https://deploy-preview-12322--astro-docs-2.netlify.app/en/guides/upgrade-to/v6/#removed-routedatagenerate-adapter-api))

.changeset/ssr-manifest-breaking.md

@@ -0,0 +1,5 @@
+---
+'astro': major
+---
+
+Changes the shape of `SSRManifest` properties and adds several new required properties in the Adapter API - ([v6 upgrade guidance](https://deploy-preview-12322--astro-docs-2.netlify.app/en/guides/upgrade-to/v6/#changed-ssrmanifest-interface-structure-adapter-api))

.changeset/vite-environments-breaking.md

@@ -0,0 +1,5 @@
+---
+'astro': major
+---
+
+Changes integration hooks and HMR access patterns in the Integration API - ([v6 upgrade guidance](https://deploy-preview-12322--astro-docs-2.netlify.app/en/guides/upgrade-to/v6/#changed-integration-hooks-and-hmr-access-patterns-integration-api))

.changeset/wet-lines-wear.md

@@ -0,0 +1,5 @@
+---
+'astro': major
+---
+
+Removes the unused `astro:ssr-manifest` virtual module - ([v6 upgrade guidance](https://deploy-preview-12322--astro-docs-2.netlify.app/en/guides/upgrade-to/v6/#removed-astrossr-manifest-virtual-module-integration-api))

benchmark/packages/adapter/src/server.ts

@@ -1,8 +1,8 @@
 import * as fs from 'node:fs';
 import type { SSRManifest } from 'astro';
-import { App } from 'astro/app';
+import { AppPipeline, BaseApp } from 'astro/app';
 
-class MyApp extends App {
+class MyApp extends BaseApp {
 	#manifest: SSRManifest | undefined;
 	constructor(manifest: SSRManifest, streaming = false) {
 		super(manifest, streaming);
@@ -19,6 +19,13 @@ class MyApp extends App {
 
 		return super.render(request);
 	}
+
+	createPipeline(streaming: boolean) {
+		return AppPipeline.create({
+			manifest: this.manifest,
+			streaming,
+		});
+	}
 }
 
 export function createExports(manifest: SSRManifest) {

biome.jsonc

@@ -28,7 +28,7 @@
   "assist": {
     "actions": {
       "source": {
-        "organizeImports": "on"
+        "organizeImports": "off"
       }
     }
   },

knip.js

@@ -32,8 +32,15 @@ export default {
 				'test/types/**/*',
 				'e2e/**/*.test.js',
 				'test/units/teardown.js',
+				// Can't detect this file when using inside a vite plugin
+				'src/vite-plugin-app/createAstroServerApp.ts',
+			],
+			ignore: [
+				'**/e2e/**/{fixtures,_temp-fixtures}/**',
+				'performance/**/*',
+				// This export is resolved dynamically in packages/astro/src/vite-plugin-app/index.ts
+				'src/vite-plugin-app/createExports.ts',
 			],
-			ignore: ['**/e2e/**/{fixtures,_temp-fixtures}/**', 'performance/**/*'],
 			// Those deps are used in tests but only referenced as strings
 			ignoreDependencies: [
 				'rehype-autolink-headings',

package.json

@@ -40,7 +40,7 @@
     "test:e2e:hosts": "turbo run test:hosted",
     "benchmark": "astro-benchmark",
     "lint": "biome lint && knip && eslint . --report-unused-disable-directives-severity=warn --concurrency=auto",
-    "lint:ci": "biome ci --formatter-enabled=false --reporter=github && eslint . --concurrency=auto --report-unused-disable-directives-severity=warn && knip",
+    "lint:ci": "biome ci --formatter-enabled=false --enforce-assist=false --reporter=github && eslint . --concurrency=auto --report-unused-disable-directives-severity=warn && knip",
     "lint:fix": "biome lint --write --unsafe",
     "publint": "pnpm -r --filter=astro --filter=create-astro --filter=\"@astrojs/*\" --no-bail exec publint",
     "version": "changeset version && node ./scripts/deps/update-example-versions.js && pnpm install --no-frozen-lockfile && pnpm run format",

packages/astro/dev-only.d.ts

@@ -22,3 +22,65 @@ declare module 'virtual:astro:actions/options' {
 declare module 'virtual:astro:actions/runtime' {
 	export * from './src/actions/runtime/client.js';
 }
+
+declare module 'virtual:astro:actions/entrypoint' {
+	import type { SSRActions } from './src/index.js';
+	export const server: SSRActions;
+}
+
+declare module 'virtual:astro:manifest' {
+	import type { SSRManifest } from './src/index.js';
+	export const manifest: SSRManifest;
+}
+
+declare module 'virtual:astro:routes' {
+	import type { RoutesList } from './src/types/astro.js';
+	export const routes: RoutesList[];
+}
+
+declare module 'virtual:astro:renderers' {
+	import type { AstroRenderer } from './src/index.js';
+	export const renderers: AstroRenderer[];
+}
+
+declare module 'virtual:astro:middleware' {
+	import type { AstroMiddlewareInstance } from './src/index.js';
+	const middleware: AstroMiddlewareInstance;
+	export default middleware;
+}
+
+declare module 'virtual:astro:session-driver' {
+	import type { Driver } from 'unstorage';
+	export const driver: Driver;
+}
+
+declare module 'virtual:astro:pages' {
+	export const pageMap: Map<string, () => Promise<any>>;
+}
+
+declare module 'virtual:astro:server-islands' {
+	export const serverIslandMap: Map<string, () => Promise<any>>;
+}
+
+declare module 'virtual:astro:adapter-entrypoint' {
+	export const createExports: ((manifest: any, args: any) => any) | undefined;
+	export const start: ((manifest: any, args: any) => void) | undefined;
+	export default any;
+}
+
+declare module 'virtual:astro:adapter-config' {
+	export const args: any;
+	export const exports: string[] | undefined;
+	export const adapterFeatures: any;
+	export const serverEntrypoint: string;
+}
+
+declare module 'virtual:astro:dev-css' {
+	import type { ImportedDevStyles } from './src/types/astro.js';
+	export const css: Set<ImportedDevStyles>;
+}
+
+declare module 'virtual:astro:dev-css-all' {
+	import type { ImportedDevStyles } from './src/types/astro.js';
+	export const devCSSMap: Map<string, () => Promise<{ css: Set<ImportedDevStyles> }>>;
+}

packages/astro/e2e/fixtures/client-only/package.json

@@ -15,7 +15,7 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "solid-js": "^1.9.10",
-    "svelte": "^5.43.6",
+    "svelte": "^5.43.14",
     "vue": "^3.5.24"
   }
 }

packages/astro/package.json

@@ -51,6 +51,9 @@
     "./container": "./dist/container/index.js",
     "./app": "./dist/core/app/index.js",
     "./app/node": "./dist/core/app/node.js",
+    "./app/entrypoint": "./dist/core/app/entrypoint.js",
+    "./entrypoints/prerender": "./dist/entrypoints/prerender.js",
+    "./entrypoints/legacy": "./dist/entrypoints/legacy.js",
     "./client/*": "./dist/runtime/client/*",
     "./components": "./components/index.ts",
     "./components/*": "./components/*",
@@ -59,6 +62,7 @@
     "./assets": "./dist/assets/index.js",
     "./assets/runtime": "./dist/assets/runtime.js",
     "./assets/utils": "./dist/assets/utils/index.js",
+    "./assets/utils/node": "./dist/assets/utils/node.js",
     "./assets/utils/inferRemoteSize.js": "./dist/assets/utils/remoteProbe.js",
     "./assets/endpoint/*": "./dist/assets/endpoint/*.js",
     "./assets/services/sharp": "./dist/assets/services/sharp.js",

packages/astro/src/actions/consts.ts

@@ -7,8 +7,9 @@ export const RESOLVED_VIRTUAL_MODULE_ID = '\0' + VIRTUAL_MODULE_ID;
 export const RUNTIME_VIRTUAL_MODULE_ID = 'virtual:astro:actions/runtime';
 export const RESOLVED_RUNTIME_VIRTUAL_MODULE_ID = '\0' + RUNTIME_VIRTUAL_MODULE_ID;
 
-export const ENTRYPOINT_VIRTUAL_MODULE_ID = 'virtual:astro:actions/entrypoint';
-export const RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID = '\0' + ENTRYPOINT_VIRTUAL_MODULE_ID;
+export const ACTIONS_ENTRYPOINT_VIRTUAL_MODULE_ID = 'virtual:astro:actions/entrypoint';
+export const ACTIONS_RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID =
+	'\0' + ACTIONS_ENTRYPOINT_VIRTUAL_MODULE_ID;
 
 /** Used to pass data from the config to the main virtual module */
 export const OPTIONS_VIRTUAL_MODULE_ID = 'virtual:astro:actions/options';

packages/astro/src/actions/vite-plugin-actions.ts

@@ -1,15 +1,14 @@
 import type fsMod from 'node:fs';
 import type { Plugin as VitePlugin } from 'vite';
-import { addRollupInput } from '../core/build/add-rollup-input.js';
 import type { BuildInternals } from '../core/build/internal.js';
 import type { StaticBuildOptions } from '../core/build/types.js';
 import { shouldAppendForwardSlash } from '../core/build/util.js';
 import { getServerOutputDirectory } from '../prerender/utils.js';
 import type { AstroSettings } from '../types/astro.js';
 import {
-	ENTRYPOINT_VIRTUAL_MODULE_ID,
+	ACTIONS_ENTRYPOINT_VIRTUAL_MODULE_ID,
+	ACTIONS_RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID,
 	OPTIONS_VIRTUAL_MODULE_ID,
-	RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID,
 	RESOLVED_NOOP_ENTRYPOINT_VIRTUAL_MODULE_ID,
 	RESOLVED_OPTIONS_VIRTUAL_MODULE_ID,
 	RESOLVED_RUNTIME_VIRTUAL_MODULE_ID,
@@ -31,15 +30,15 @@ export function vitePluginActionsBuild(
 	return {
 		name: '@astro/plugin-actions-build',
 
-		options(options) {
-			return addRollupInput(options, [ENTRYPOINT_VIRTUAL_MODULE_ID]);
+		applyToEnvironment(environment) {
+			return environment.name === 'ssr';
 		},
 
 		writeBundle(_, bundle) {
 			for (const [chunkName, chunk] of Object.entries(bundle)) {
 				if (
 					chunk.type !== 'asset' &&
-					chunk.facadeModuleId === RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID
+					chunk.facadeModuleId === ACTIONS_RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID
 				) {
 					const outputDirectory = getServerOutputDirectory(opts.settings);
 					internals.astroActionsEntryPoint = new URL(chunkName, outputDirectory);
@@ -74,7 +73,7 @@ export function vitePluginActions({
 				return RESOLVED_OPTIONS_VIRTUAL_MODULE_ID;
 			}
 
-			if (id === ENTRYPOINT_VIRTUAL_MODULE_ID) {
+			if (id === ACTIONS_ENTRYPOINT_VIRTUAL_MODULE_ID) {
 				const resolvedModule = await this.resolve(
 					`${decodeURI(new URL('actions', settings.config.srcDir).pathname)}`,
 				);
@@ -84,7 +83,7 @@ export function vitePluginActions({
 				}
 
 				resolvedActionsId = resolvedModule.id;
-				return RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID;
+				return ACTIONS_RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID;
 			}
 		},
 		async configureServer(server) {
@@ -108,7 +107,7 @@ export function vitePluginActions({
 				return { code: 'export const server = {}' };
 			}
 
-			if (id === RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID) {
+			if (id === ACTIONS_RESOLVED_ENTRYPOINT_VIRTUAL_MODULE_ID) {
 				return { code: `export { server } from ${JSON.stringify(resolvedActionsId)};` };
 			}