@astrojs/cloudflare 12.3.0 → 12.4.0

package/dist/entrypoints/server.d.ts

@@ -15,6 +15,10 @@ export interface Runtime<T extends object = object> {
         ctx: ExecutionContext;
     };
 }
+declare global {
+    var __ASTRO_SESSION_BINDING_NAME: string;
+    var __env__: Partial<Env>;
+}
 export declare function createExports(manifest: SSRManifest): {
     default: {
         fetch: (request: Request & CLOUDFLARE_REQUEST, env: Env, context: ExecutionContext) => Promise<Response>;

package/dist/entrypoints/server.js

@@ -7,6 +7,9 @@ function createExports(manifest) {
   const app = new App(manifest);
   const fetch = async (request, env, context) => {
     const { pathname } = new URL(request.url);
+    const bindingName = globalThis.__ASTRO_SESSION_BINDING_NAME;
+    globalThis.__env__ ??= {};
+    globalThis.__env__[bindingName] = env[bindingName];
     if (manifest.assets.has(pathname)) {
       return env.ASSETS.fetch(request.url.replace(/\.html$/, ""));
     }

package/dist/index.d.ts

@@ -43,5 +43,31 @@ export type Options = {
      * for reference on how these file types are exported
      */
     cloudflareModules?: boolean;
+    /**
+     * By default, Astro will be configured to use Cloudflare KV to store session data. If you want to use sessions,
+     * you must create a KV namespace and declare it in your wrangler config file. You can do this with the wrangler command:
+     *
+     * ```sh
+     * npx wrangler kv namespace create SESSION
+     * ```
+     *
+     * This will log the id of the created namespace. You can then add it to your `wrangler.json` file like this:
+     *
+     * ```json
+     * {
+     *   "kv_namespaces": [
+     *     {
+     *       "binding": "SESSION",
+     *       "id": "<your kv namespace id here>"
+     *     }
+     *   ]
+     * }
+     * ```
+     * By default, the driver looks for the binding named `SESSION`, but you can override this by providing a different name here.
+     *
+     * See https://developers.cloudflare.com/kv/concepts/kv-namespaces/ for more details on using KV namespaces.
+     *
+     */
+    sessionKVBindingName?: string;
 };
 export default function createIntegration(args?: Options): AstroIntegration;

package/dist/index.js

@@ -1,6 +1,7 @@
 import { createReadStream } from "node:fs";
 import { appendFile, stat } from "node:fs/promises";
 import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
 import {
   appendForwardSlash,
   prependForwardSlash,
@@ -46,8 +47,36 @@ function createIntegration(args) {
         updateConfig,
         logger,
         addWatchFile,
-        addMiddleware
+        addMiddleware,
+        createCodegenDir
       }) => {
+        let session = config.session;
+        const isBuild = command === "build";
+        if (config.experimental.session && !session?.driver) {
+          const sessionDir = isBuild ? void 0 : createCodegenDir();
+          const bindingName = args?.sessionKVBindingName ?? "SESSION";
+          logger.info(
+            `Configuring experimental session support using ${isBuild ? "Cloudflare KV" : "filesystem storage"}. Be sure to define a KV binding named "${bindingName}".`
+          );
+          logger.info(
+            `If you see the error "Invalid binding \`${bindingName}\`" in your build output, you need to add the binding to your wrangler config file.`
+          );
+          session = isBuild ? {
+            ...session,
+            driver: "cloudflare-kv-binding",
+            options: {
+              binding: bindingName,
+              ...session?.options
+            }
+          } : {
+            ...session,
+            driver: "fs-lite",
+            options: {
+              base: fileURLToPath(new URL("sessions", sessionDir)),
+              ...session?.options
+            }
+          };
+        }
         updateConfig({
           build: {
             client: new URL(`.${wrapWithSlashes(config.base)}`, config.outDir),
@@ -55,6 +84,7 @@ function createIntegration(args) {
             serverEntry: "index.js",
             redirects: false
           },
+          session,
           vite: {
             plugins: [
               // https://developers.cloudflare.com/pages/functions/module-support/
@@ -173,6 +203,10 @@ function createIntegration(args) {
           vite.build.rollupOptions.output.banner ||= "globalThis.process ??= {}; globalThis.process.env ??= {};";
           vite.define = {
             "process.env": "process.env",
+            // Allows the request handler to know what the binding name is
+            "globalThis.__ASTRO_SESSION_BINDING_NAME": JSON.stringify(
+              args?.sessionKVBindingName ?? "SESSION"
+            ),
             ...vite.define
           };
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@astrojs/cloudflare",
   "description": "Deploy your site to Cloudflare Workers/Pages",
-  "version": "12.3.0",
+  "version": "12.4.0",
   "type": "module",
   "types": "./dist/index.d.ts",
   "author": "withastro",
@@ -29,14 +29,14 @@
     "dist"
   ],
   "dependencies": {
-    "@cloudflare/workers-types": "^4.20250317.0",
+    "@cloudflare/workers-types": "^4.20250327.0",
     "esbuild": "^0.25.0",
     "estree-walker": "^3.0.3",
     "magic-string": "^0.30.17",
-    "miniflare": "^4.20250317.0",
+    "miniflare": "^4.20250321.1",
     "tinyglobby": "^0.2.12",
-    "vite": "^6.2.1",
-    "wrangler": "^4.2.0",
+    "vite": "^6.2.4",
+    "wrangler": "^4.5.1",
     "@astrojs/internal-helpers": "0.6.1",
     "@astrojs/underscore-redirects": "0.6.0"
   },
@@ -45,10 +45,11 @@
   },
   "devDependencies": {
     "cheerio": "1.0.0",
+    "devalue": "^5.1.1",
     "execa": "^8.0.1",
     "rollup": "^4.35.0",
     "strip-ansi": "^7.1.0",
-    "astro": "5.5.4",
+    "astro": "5.5.6",
     "astro-scripts": "0.0.14"
   },
   "publishConfig": {