vinext 1.0.0-beta.8 → 1.0.0

package/dist/init-cloudflare.js

@@ -1,53 +1,113 @@
 import path from "./deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { detectProject } from "./utils/project.js";
+import { isUnknownRecord } from "./utils/record.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
+import { createHash } from "node:crypto";
 import MagicString from "magic-string";
 //#region src/init-cloudflare.ts
 const require = createRequire(import.meta.url);
 const DEFAULT_CLOUDFLARE_INIT_OPTIONS = {
-	dataCache: "kv",
-	cdnCache: "workers-cache",
+	dataCache: "none",
+	cdnCache: "none",
 	imageOptimization: "cloudflare-images"
 };
+const DEFAULT_VERSION_METADATA_BINDING = "CF_VERSION_METADATA";
+const RESPONSE_STORE_WRANGLER_CONFIG = "wrangler.response-store.jsonc";
+const RESPONSE_STORE_BINDING = "RESPONSE_STORE";
+const RESPONSE_STORE_ENTRYPOINT = "ResponseStoreService";
+const RESPONSE_STORE_MAIN = "./node_modules/@cloudflare/workers-response-store/dist/service.js";
+const CACHE_BODIES_BINDING = "CACHE_BODIES";
+const CACHE_METADATA_BINDING = "CACHE_METADATA";
+const CACHE_METADATA_CLASS = "CacheMetadata";
+const CACHE_METADATA_EXPORT = {
+	type: "durable-object",
+	storage: "sqlite"
+};
+const CTX_EXPORTS_DEFAULT_DATE = "2025-11-17";
 function validateCloudflarePlatformSetup(context, cloudflare) {
+	if (cloudflare.cdnCache === "static-assets" && !context.isAppRouter) throw new Error("The Static Assets cache currently requires an App Router project.");
+	if (!cloudflare.legacyWrangler) {
+		const existingWrangler = [
+			"wrangler.toml",
+			"wrangler.json",
+			"wrangler.jsonc",
+			RESPONSE_STORE_WRANGLER_CONFIG
+		].find((name) => fs.existsSync(path.join(context.root, name)));
+		if (existingWrangler) throw new Error(`Cloudflare init cannot replace an existing Wrangler config (${existingWrangler}). Migrate its bindings to cloudflare.config.ts first, or use --legacy-wrangler-cloudflare-init to keep the Wrangler setup.`);
+		const typedConfigPath = path.join(context.root, "cloudflare.config.ts");
+		if (cloudflare.cdnCache === "static-assets" && fs.existsSync(typedConfigPath)) throw new Error("Static Assets cache setup for an existing cloudflare.config.ts must be configured manually. Keep its assets binding aligned with staticAssetsAdapter({ binding }) and include \"/_vinext/static-cache/*\" in assets.runWorkerFirst to protect private cache files.");
+		if (cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding" && fs.existsSync(typedConfigPath) && !fs.readFileSync(typedConfigPath, "utf-8").includes("export const responseStoreServiceBinding")) throw new Error("The existing cloudflare.config.ts must export responseStoreServiceBinding for the Response Store auxiliary Worker. Configure it before rerunning init.");
+		if (context.existingViteConfigPath && cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding" && !fs.readFileSync(context.existingViteConfigPath, "utf-8").includes("auxiliaryWorkers: [{ config: responseStoreServiceBinding }]")) throw new Error("Cloudflare init with Response Store service-binding requires a fresh Vite config so the auxiliary Worker is connected. Remove the existing Vite config or configure it manually.");
+		if (context.existingViteConfigPath) {
+			const updatedConfig = updateViteConfigForCloudflare(context.existingViteConfigPath, fs.readFileSync(context.existingViteConfigPath, "utf-8"), {
+				isAppRouter: context.isAppRouter,
+				nativeModulesToStub: detectProject(context.root).nativeModulesToStub,
+				cache: cloudflare
+			});
+			if (context.hasCssModules) updateViteConfigForCssModules(context.existingViteConfigPath, updatedConfig);
+		}
+		return;
+	}
 	const tomlPath = path.join(context.root, "wrangler.toml");
 	if (fs.existsSync(tomlPath)) throw new Error("wrangler.toml is not supported by vinext init. Convert it to wrangler.jsonc and rerun.");
 	const projectInfo = detectProject(context.root);
 	const wranglerPath = ["wrangler.jsonc", "wrangler.json"].map((fileName) => path.join(context.root, fileName)).find((candidate) => fs.existsSync(candidate));
 	const wranglerCode = wranglerPath ? fs.readFileSync(wranglerPath, "utf-8") : void 0;
+	if (!wranglerCode && cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding" && fs.existsSync(path.join(context.root, RESPONSE_STORE_WRANGLER_CONFIG))) readResponseStoreServiceName(context.root, {});
 	const updatedWranglerCode = wranglerCode ? updateWranglerConfigForCloudflare(wranglerCode, cloudflare, { root: context.root }) : void 0;
 	const imagesBinding = updatedWranglerCode ? getWranglerImagesBinding(updatedWranglerCode) : "IMAGES";
-	if (context.existingViteConfigPath) updateViteConfigForCloudflare(context.existingViteConfigPath, fs.readFileSync(context.existingViteConfigPath, "utf-8"), {
-		isAppRouter: context.isAppRouter,
-		nativeModulesToStub: projectInfo.nativeModulesToStub,
-		cache: cloudflare,
-		imagesBinding,
-		prerender: context.prerender
-	});
+	const assetsBinding = updatedWranglerCode ? getWranglerAssetsBinding(updatedWranglerCode) : "ASSETS";
+	const assetsDirectory = updatedWranglerCode ? getWranglerAssetsDirectory(updatedWranglerCode) : "dist/client";
+	const versionMetadataBinding = updatedWranglerCode ? getWranglerVersionMetadataBinding(updatedWranglerCode) : DEFAULT_VERSION_METADATA_BINDING;
+	if (context.existingViteConfigPath) {
+		const updatedConfig = updateViteConfigForCloudflare(context.existingViteConfigPath, fs.readFileSync(context.existingViteConfigPath, "utf-8"), {
+			isAppRouter: context.isAppRouter,
+			nativeModulesToStub: projectInfo.nativeModulesToStub,
+			cache: cloudflare,
+			assetsBinding,
+			assetsDirectory,
+			imagesBinding,
+			versionMetadataBinding
+		});
+		if (context.hasCssModules) updateViteConfigForCssModules(context.existingViteConfigPath, updatedConfig);
+	}
 }
 function setupCloudflarePlatform(context, cloudflare) {
+	if (!cloudflare.legacyWrangler) return setupCfPlatform(context, cloudflare);
 	const projectInfo = detectProject(context.root);
 	const wranglerPath = ["wrangler.jsonc", "wrangler.json"].map((fileName) => path.join(context.root, fileName)).find((candidate) => fs.existsSync(candidate));
 	const wranglerCode = wranglerPath ? fs.readFileSync(wranglerPath, "utf-8") : void 0;
-	const imagesBinding = wranglerCode ? getWranglerImagesBinding(wranglerCode) : "IMAGES";
+	const updatedWranglerCode = wranglerCode ? updateWranglerConfigForCloudflare(wranglerCode, cloudflare, { root: context.root }) : void 0;
+	const imagesBinding = updatedWranglerCode ? getWranglerImagesBinding(updatedWranglerCode) : "IMAGES";
+	const assetsBinding = updatedWranglerCode ? getWranglerAssetsBinding(updatedWranglerCode) : "ASSETS";
+	const assetsDirectory = updatedWranglerCode ? getWranglerAssetsDirectory(updatedWranglerCode) : "dist/client";
+	const versionMetadataBinding = updatedWranglerCode ? getWranglerVersionMetadataBinding(updatedWranglerCode) : DEFAULT_VERSION_METADATA_BINDING;
 	let generatedViteConfig = false;
 	let skippedViteConfig = false;
+	let preservedExistingGenerateScopedName = false;
 	if (context.existingViteConfigPath) {
 		const currentConfig = fs.readFileSync(context.existingViteConfigPath, "utf-8");
-		const updatedConfig = updateViteConfigForCloudflare(context.existingViteConfigPath, currentConfig, {
+		let updatedConfig = updateViteConfigForCloudflare(context.existingViteConfigPath, currentConfig, {
 			isAppRouter: context.isAppRouter,
 			nativeModulesToStub: projectInfo.nativeModulesToStub,
 			cache: cloudflare,
+			assetsBinding,
+			assetsDirectory,
 			imagesBinding,
-			prerender: context.prerender
+			versionMetadataBinding
 		});
+		if (context.hasCssModules) {
+			const cssUpdate = updateViteConfigForCssModules(context.existingViteConfigPath, updatedConfig);
+			updatedConfig = cssUpdate.code;
+			preservedExistingGenerateScopedName = cssUpdate.preservedExistingGenerateScopedName;
+		}
 		if (updatedConfig !== currentConfig) {
 			fs.writeFileSync(context.existingViteConfigPath, updatedConfig, "utf-8");
 			generatedViteConfig = true;
 		} else skippedViteConfig = true;
 	} else {
-		const configContent = context.isAppRouter ? generateAppRouterViteConfig(projectInfo, cloudflare, imagesBinding, context.prerender) : generatePagesRouterViteConfig(projectInfo, cloudflare, imagesBinding, context.prerender);
+		const configContent = context.isAppRouter ? generateAppRouterViteConfig(projectInfo, cloudflare, imagesBinding, versionMetadataBinding, false, assetsBinding, assetsDirectory, context.hasCssModules) : generatePagesRouterViteConfig(projectInfo, cloudflare, imagesBinding, versionMetadataBinding, false, context.hasCssModules);
 		fs.writeFileSync(path.join(context.root, "vite.config.ts"), configContent, "utf-8");
 		generatedViteConfig = true;
 	}
@@ -55,30 +115,123 @@ function setupCloudflarePlatform(context, cloudflare) {
 	if (!wranglerPath) {
 		fs.writeFileSync(path.join(context.root, "wrangler.jsonc"), generateWranglerConfig(projectInfo, cloudflare, context.today), "utf-8");
 		generatedPlatformFiles.push("wrangler.jsonc");
-	} else if (wranglerCode) {
-		const updatedConfig = updateWranglerConfigForCloudflare(wranglerCode, cloudflare, { root: context.root });
-		if (updatedConfig !== wranglerCode) {
-			fs.writeFileSync(wranglerPath, updatedConfig, "utf-8");
+	} else if (wranglerCode && updatedWranglerCode) {
+		if (updatedWranglerCode !== wranglerCode) {
+			fs.writeFileSync(wranglerPath, updatedWranglerCode, "utf-8");
 			generatedPlatformFiles.push(path.basename(wranglerPath));
 		}
 	}
 	const finalWranglerPath = wranglerPath ?? path.join(context.root, "wrangler.jsonc");
-	const finalWranglerFileName = path.basename(finalWranglerPath);
-	const kvBinding = JSON.parse(stripJsonComments(fs.readFileSync(finalWranglerPath, "utf-8"))).kv_namespaces?.find((namespace) => namespace.binding === "VINEXT_KV_CACHE");
-	const needsKvNamespaceId = cloudflare.dataCache === "kv" && (!kvBinding || typeof kvBinding.id !== "string" || kvBinding.id.length === 0 || kvBinding.id === "<your-kv-namespace-id>");
+	if (cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding") {
+		const responseStorePath = path.join(path.dirname(finalWranglerPath), RESPONSE_STORE_WRANGLER_CONFIG);
+		if (!fs.existsSync(responseStorePath)) {
+			fs.writeFileSync(responseStorePath, generateResponseStoreWranglerConfig(fs.readFileSync(finalWranglerPath, "utf-8"), context.root), "utf-8");
+			generatedPlatformFiles.push(path.relative(context.root, responseStorePath) || RESPONSE_STORE_WRANGLER_CONFIG);
+		}
+	}
+	const nextSteps = [];
+	if (cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding") nextSteps.push("Deploy Workers Response Store before deploying the application:", `   ${context.packageManager ?? "npm"} run deploy:response-store`);
+	if (cloudflare.prerender && cloudflare.cdnCache !== "static-assets") nextSteps.push("Pre-rendered routes are built, but Cloudflare deploys do not serve them.", "   Use the Static Assets cache to serve them, or cache warming to fill another cache.");
 	return {
 		generatedViteConfig,
 		skippedViteConfig,
 		generatedPlatformFiles,
-		nextSteps: needsKvNamespaceId ? [
-			"Cloudflare setup is incomplete until you finish KV configuration:",
-			"1. Create the KV namespace:",
-			"   npx wrangler kv namespace create VINEXT_KV_CACHE",
-			`2. Copy the returned namespace ID into the VINEXT_KV_CACHE entry in ${finalWranglerFileName}:`,
-			"   Set its \"id\" value, replacing \"<your-kv-namespace-id>\" if present."
-		] : []
+		nextSteps,
+		preservedExistingGenerateScopedName
+	};
+}
+function setupCfPlatform(context, cloudflare) {
+	const projectInfo = detectProject(context.root);
+	const serviceBinding = cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding";
+	let generatedViteConfig = false;
+	let preservedExistingGenerateScopedName = false;
+	if (context.existingViteConfigPath) {
+		const current = fs.readFileSync(context.existingViteConfigPath, "utf-8");
+		let updated = updateViteConfigForCloudflare(context.existingViteConfigPath, current, {
+			isAppRouter: context.isAppRouter,
+			nativeModulesToStub: projectInfo.nativeModulesToStub,
+			cache: cloudflare
+		});
+		if (context.hasCssModules) {
+			const cssUpdate = updateViteConfigForCssModules(context.existingViteConfigPath, updated);
+			updated = cssUpdate.code;
+			preservedExistingGenerateScopedName = cssUpdate.preservedExistingGenerateScopedName;
+		}
+		if (updated !== current) {
+			fs.writeFileSync(context.existingViteConfigPath, updated, "utf-8");
+			generatedViteConfig = true;
+		}
+	} else {
+		const viteConfig = context.isAppRouter ? generateAppRouterViteConfig(projectInfo, cloudflare, "IMAGES", DEFAULT_VERSION_METADATA_BINDING, serviceBinding, "ASSETS", "dist/client", context.hasCssModules) : generatePagesRouterViteConfig(projectInfo, cloudflare, "IMAGES", DEFAULT_VERSION_METADATA_BINDING, serviceBinding, context.hasCssModules);
+		fs.writeFileSync(path.join(context.root, "vite.config.ts"), viteConfig, "utf-8");
+		generatedViteConfig = true;
+	}
+	const configPath = path.join(context.root, "cloudflare.config.ts");
+	const generatedPlatformFiles = [];
+	if (!fs.existsSync(configPath)) {
+		fs.writeFileSync(configPath, generateTypedCloudflareConfig(projectInfo, cloudflare, context.today));
+		generatedPlatformFiles.push("cloudflare.config.ts");
+	}
+	const nextSteps = [];
+	if (serviceBinding) nextSteps.push("After `vinext build`, deploy the Response Store Worker explicitly (and repeat when its code/config changes):", `   ${context.packageManager ?? "npm"} run deploy:response-store`, "vinext-cloudflare deploy only deploys the application Worker.");
+	if (cloudflare.prerender && cloudflare.cdnCache !== "static-assets") nextSteps.push("Pre-rendered routes are built, but Cloudflare deploys do not serve them.", "   Use the Static Assets cache to serve them, or cache warming to fill another cache.");
+	nextSteps.push("For TypeScript, add \".cloudflare/types\" to the include list in tsconfig.json.", "Worker types are generated during dev/build; run `cf workers types` before standalone type-checks.");
+	return {
+		generatedViteConfig,
+		skippedViteConfig: !generatedViteConfig,
+		generatedPlatformFiles,
+		nextSteps,
+		preservedExistingGenerateScopedName
 	};
 }
+function generateTypedCloudflareConfig(info, options, today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0]) {
+	const serviceBinding = options.cdnCache === "response-store" && (options.responseStoreMode ?? "service-binding") === "service-binding";
+	const selfContained = options.cdnCache === "response-store" && !serviceBinding;
+	const workersCache = options.cdnCache === "workers-cache";
+	const helper = serviceBinding ? "createWorkersResponseStoreServiceBindingConfig" : selfContained ? "createWorkersResponseStoreSelfContainedConfig" : workersCache ? "createWorkersCacheConfig" : void 0;
+	const imports = [`import { bindings, defineConfig, defineWorker } from "cf/config";`, ...helper ? [`import { ${helper} } from "@vinext/cloudflare/cache/config";`] : []];
+	const responseStoreName = compactResourceName(info.projectName, "-response-store", 63);
+	const bucket = serviceBinding ? compactResourceName(responseStoreName, "-cache-bodies", 63) : compactResourceName(info.projectName, "-response-store-cache-bodies", 63);
+	const shared = serviceBinding ? `const responseStore = await ${helper}({
+  worker: {
+    name: ${JSON.stringify(responseStoreName)},
+    compatibilityDate: ${JSON.stringify(today)},
+    compatibilityFlags: ["nodejs_compat"],
+  },
+  bucket: ${JSON.stringify(bucket)},
+});
+
+export const responseStoreServiceBinding = responseStore.serviceBindingWorker;
+
+` : selfContained ? `const cache = await ${helper}({
+  worker: ${JSON.stringify(info.projectName)},
+  bucket: ${JSON.stringify(bucket)},
+});
+
+` : workersCache ? `const cache = await ${helper}();\n\n` : "";
+	const cacheSpread = serviceBinding ? "responseStore.applicationWorker" : helper ? "cache" : void 0;
+	const envBindings = [
+		...cacheSpread ? [`...${cacheSpread}.env`] : [],
+		"ASSETS: bindings.assets()",
+		...options.imageOptimization === "cloudflare-images" ? ["IMAGES: bindings.images()"] : [],
+		...options.dataCache === "kv" ? ["VINEXT_KV_CACHE: bindings.kv()"] : []
+	];
+	return `${imports.join("\n")}
+
+${shared}export default defineConfig({
+  worker: defineWorker({
+    ${cacheSpread ? `...${cacheSpread},\n    ` : ""}name: ${JSON.stringify(info.projectName)},
+    entrypoint: ${JSON.stringify(resolveWorkerEntry(info.root))},
+    compatibilityDate: ${JSON.stringify(today)},
+    compatibilityFlags: ["nodejs_compat"],
+    assets: { notFoundHandling: "none"${options.cdnCache === "static-assets" ? ", runWorkerFirst: [\"/_vinext/static-cache/*\"]" : ""} },
+    env: {
+      ${envBindings.join(",\n      ")},
+    },
+  }),
+});
+`;
+}
 /**
 * `main` is what makes a Wrangler config a Worker rather than a static-assets
 * project. A custom `worker/index.*` wins when present; otherwise the
@@ -101,16 +254,20 @@ function generateWranglerConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPTIONS,
 		assets: {
 			directory: "dist/client",
 			not_found_handling: "none",
-			binding: "ASSETS"
+			binding: "ASSETS",
+			...options.cdnCache === "static-assets" ? { run_worker_first: ["/_vinext/static-cache/*"] } : {}
 		}
 	};
-	if (options.cdnCache === "workers-cache") config.cache = { enabled: true };
+	if (options.cdnCache === "workers-cache") {
+		config.cache = { enabled: true };
+		config.version_metadata = { binding: DEFAULT_VERSION_METADATA_BINDING };
+	}
 	if (options.imageOptimization === "cloudflare-images") config.images = { binding: "IMAGES" };
-	if (options.dataCache === "kv") config.kv_namespaces = [{
-		binding: "VINEXT_KV_CACHE",
-		id: "<your-kv-namespace-id>"
-	}];
-	return JSON.stringify(config, null, 2) + "\n";
+	if (options.dataCache === "kv") config.kv_namespaces = [{ binding: "VINEXT_KV_CACHE" }];
+	const code = `${JSON.stringify(config, null, 2)}\n`;
+	if (options.cdnCache !== "response-store") return code;
+	const configured = configureResponseStoreWrangler(code, config, options.responseStoreMode ?? "service-binding", info.root);
+	return `${JSON.stringify(JSON.parse(configured), null, 2)}\n`;
 }
 function stripJsonComments(code) {
 	let output = "";
@@ -269,6 +426,197 @@ function appendTopLevelJsonProperty(code, property) {
 	const structuralBefore = stripJsonComments(before);
 	return `${before}${!/,\s*$/.test(structuralBefore) && !/{\s*$/.test(structuralBefore) ? "," : ""}\n${property}\n${code.slice(closing)}`;
 }
+function setTopLevelJsonProperty(code, name, value) {
+	const property = findTopLevelJsonProperty(code, name);
+	const serialized = JSON.stringify(value);
+	if (!property) return appendTopLevelJsonProperty(code, `  ${JSON.stringify(name)}: ${serialized}`);
+	return `${code.slice(0, property.valueStart)}${serialized}${code.slice(property.valueEnd)}`;
+}
+function compactResourceName(name, suffix, maxLength) {
+	const fullName = `${name}${suffix}`;
+	if (fullName.length <= maxLength) return fullName;
+	const hash = createHash("sha256").update(name).digest("hex").slice(0, 8);
+	return `${name.slice(0, maxLength - suffix.length - hash.length - 1)}-${hash}${suffix}`;
+}
+function isCacheMetadataExport(value) {
+	return isUnknownRecord(value) && value.type === CACHE_METADATA_EXPORT.type && value.storage === CACHE_METADATA_EXPORT.storage;
+}
+function readResponseStoreServiceName(root, appConfig) {
+	const responseStorePath = path.join(root, RESPONSE_STORE_WRANGLER_CONFIG);
+	if (fs.existsSync(responseStorePath)) {
+		let responseStoreConfig;
+		try {
+			responseStoreConfig = JSON.parse(stripJsonComments(fs.readFileSync(responseStorePath, "utf8")));
+		} catch (cause) {
+			throw new Error(`Could not parse ${RESPONSE_STORE_WRANGLER_CONFIG}.`, { cause });
+		}
+		if (!isUnknownRecord(responseStoreConfig) || typeof responseStoreConfig.name !== "string" || responseStoreConfig.name.length === 0) throw new Error(`${RESPONSE_STORE_WRANGLER_CONFIG} must contain a Worker name.`);
+		if (responseStoreConfig.main !== RESPONSE_STORE_MAIN) throw new Error(`${RESPONSE_STORE_WRANGLER_CONFIG} already exists but does not use @cloudflare/workers-response-store.`);
+		const responseStoreExport = isUnknownRecord(responseStoreConfig.exports) ? responseStoreConfig.exports.ResponseStoreBinding : void 0;
+		const cacheMetadataExport = isUnknownRecord(responseStoreConfig.exports) ? responseStoreConfig.exports[CACHE_METADATA_CLASS] : void 0;
+		const hasCacheBodies = Array.isArray(responseStoreConfig.r2_buckets) && responseStoreConfig.r2_buckets.some((binding) => isUnknownRecord(binding) && binding.binding === CACHE_BODIES_BINDING);
+		const durableBindings = isUnknownRecord(responseStoreConfig.durable_objects) ? responseStoreConfig.durable_objects.bindings : void 0;
+		const hasCacheMetadata = Array.isArray(durableBindings) && durableBindings.some((binding) => isUnknownRecord(binding) && binding.name === CACHE_METADATA_BINDING && binding.class_name === CACHE_METADATA_CLASS && binding.script_name === void 0);
+		const hasNoMigrations = responseStoreConfig.migrations === void 0 || Array.isArray(responseStoreConfig.migrations) && responseStoreConfig.migrations.length === 0;
+		if (!isUnknownRecord(responseStoreConfig.cache) || responseStoreConfig.cache.enabled !== true || !isUnknownRecord(responseStoreExport) || !isUnknownRecord(responseStoreExport.cache) || responseStoreExport.cache.enabled !== true || !hasCacheBodies || !hasCacheMetadata || !isCacheMetadataExport(cacheMetadataExport) || !hasNoMigrations) throw new Error(`${RESPONSE_STORE_WRANGLER_CONFIG} is missing required Response Store bindings.`);
+		const compatibilityFlags = responseStoreConfig.compatibility_flags;
+		if (compatibilityFlags !== void 0 && (!Array.isArray(compatibilityFlags) || compatibilityFlags.some((flag) => typeof flag !== "string"))) throw new Error(`${RESPONSE_STORE_WRANGLER_CONFIG} has invalid compatibility flags.`);
+		const flags = compatibilityFlags ?? [];
+		if (flags.includes("disable_ctx_exports") || (typeof responseStoreConfig.compatibility_date !== "string" || responseStoreConfig.compatibility_date < CTX_EXPORTS_DEFAULT_DATE) && !flags.includes("enable_ctx_exports")) throw new Error(`${RESPONSE_STORE_WRANGLER_CONFIG} must enable ctx.exports with a compatibility date on or after ${CTX_EXPORTS_DEFAULT_DATE}, or the enable_ctx_exports compatibility flag.`);
+		return responseStoreConfig.name;
+	}
+	if (Array.isArray(appConfig.services)) {
+		const binding = appConfig.services.find((service) => isUnknownRecord(service) && service.binding === RESPONSE_STORE_BINDING);
+		if (isUnknownRecord(binding) && typeof binding.service === "string" && binding.service.length > 0) return binding.service;
+	}
+	return compactResourceName(typeof appConfig.name === "string" && appConfig.name.length > 0 ? appConfig.name : detectProject(root).projectName, "-response-store", 63);
+}
+function configureResponseStoreWrangler(code, config, mode, root) {
+	const flags = Array.isArray(config.compatibility_flags) ? config.compatibility_flags.filter((flag) => typeof flag === "string") : [];
+	if (flags.includes("disable_ctx_exports")) throw new Error("Workers Response Store requires ctx.exports to be enabled.");
+	if ((typeof config.compatibility_date !== "string" || config.compatibility_date < CTX_EXPORTS_DEFAULT_DATE) && !flags.includes("enable_ctx_exports")) code = setTopLevelJsonProperty(code, "compatibility_flags", [...flags, "enable_ctx_exports"]);
+	const versionMetadata = config.version_metadata;
+	if (versionMetadata !== void 0 && (!isUnknownRecord(versionMetadata) || versionMetadata.binding !== DEFAULT_VERSION_METADATA_BINDING)) throw new Error(`Workers Response Store requires version_metadata.binding to be ${JSON.stringify(DEFAULT_VERSION_METADATA_BINDING)}.`);
+	code = setTopLevelJsonProperty(code, "version_metadata", { binding: DEFAULT_VERSION_METADATA_BINDING });
+	const cache = config.cache;
+	if (cache !== void 0 && !isUnknownRecord(cache)) throw new Error("The existing Wrangler config has an invalid cache value.");
+	code = setTopLevelJsonProperty(code, "cache", {
+		...cache,
+		enabled: mode === "self-contained"
+	});
+	const exportsConfig = config.exports;
+	if (exportsConfig !== void 0 && !isUnknownRecord(exportsConfig)) throw new Error("The existing Wrangler config has an invalid exports value.");
+	const workerExports = { ...exportsConfig };
+	const cacheMetadataExport = workerExports[CACHE_METADATA_CLASS];
+	const hasCacheMetadataExport = isCacheMetadataExport(cacheMetadataExport);
+	let updateWorkerExports = mode === "self-contained";
+	const services = config.services;
+	if (services !== void 0 && !Array.isArray(services)) throw new Error("The existing Wrangler config has an invalid services value.");
+	const existingServices = services ?? [];
+	if (existingServices.some((service) => !isUnknownRecord(service))) throw new Error("The existing Wrangler config has an invalid service binding.");
+	const responseStoreService = existingServices.find((service) => service.binding === RESPONSE_STORE_BINDING);
+	if (responseStoreService && responseStoreService.entrypoint !== RESPONSE_STORE_ENTRYPOINT) throw new Error(`The ${RESPONSE_STORE_BINDING} service binding uses a different entrypoint.`);
+	if (mode === "service-binding") {
+		const responseStoreExport = workerExports.ResponseStoreBinding;
+		const hasSelfContainedResponseStore = isUnknownRecord(responseStoreExport) && responseStoreExport.type === "worker" && isUnknownRecord(responseStoreExport.cache) && responseStoreExport.cache.enabled === true;
+		if (responseStoreExport !== void 0 && !hasSelfContainedResponseStore) throw new Error("The existing ResponseStoreBinding export conflicts with Workers Response Store.");
+		if (hasSelfContainedResponseStore && cacheMetadataExport !== void 0 && !hasCacheMetadataExport) throw new Error(`The existing ${CACHE_METADATA_CLASS} export conflicts with Workers Response Store.`);
+		const hasCacheBodies = Array.isArray(config.r2_buckets) && config.r2_buckets.some((bucket) => isUnknownRecord(bucket) && bucket.binding === CACHE_BODIES_BINDING);
+		const durableBindings = isUnknownRecord(config.durable_objects) ? config.durable_objects.bindings : void 0;
+		const hasCacheMetadata = Array.isArray(durableBindings) && durableBindings.some((binding) => isUnknownRecord(binding) && binding.name === CACHE_METADATA_BINDING);
+		if (!hasSelfContainedResponseStore && hasCacheBodies) throw new Error(`${CACHE_BODIES_BINDING} is already used by an application-owned R2 binding.`);
+		if (!hasSelfContainedResponseStore && hasCacheMetadata) throw new Error(`${CACHE_METADATA_BINDING} is already used by an application-owned Durable Object binding.`);
+		const serviceName = readResponseStoreServiceName(root, config);
+		code = setTopLevelJsonProperty(code, "services", [...existingServices.filter((service) => service.binding !== RESPONSE_STORE_BINDING), {
+			...responseStoreService,
+			binding: RESPONSE_STORE_BINDING,
+			service: serviceName,
+			entrypoint: RESPONSE_STORE_ENTRYPOINT
+		}]);
+		updateWorkerExports = hasSelfContainedResponseStore;
+		delete workerExports.ResponseStoreBinding;
+		if (hasSelfContainedResponseStore) delete workerExports[CACHE_METADATA_CLASS];
+		if (Array.isArray(config.r2_buckets)) code = setTopLevelJsonProperty(code, "r2_buckets", config.r2_buckets.filter((bucket) => !isUnknownRecord(bucket) || bucket.binding !== CACHE_BODIES_BINDING));
+		if (isUnknownRecord(config.durable_objects) && Array.isArray(config.durable_objects.bindings)) code = setTopLevelJsonProperty(code, "durable_objects", {
+			...config.durable_objects,
+			bindings: config.durable_objects.bindings.filter((binding) => !isUnknownRecord(binding) || binding.name !== CACHE_METADATA_BINDING)
+		});
+	} else {
+		const defaultExport = workerExports.default;
+		if (defaultExport !== void 0 && !isUnknownRecord(defaultExport)) throw new Error("The existing Wrangler config has an invalid default export.");
+		workerExports.default = {
+			...defaultExport,
+			type: "worker",
+			cache: { enabled: false }
+		};
+		if (responseStoreService) code = setTopLevelJsonProperty(code, "services", existingServices.filter((service) => service.binding !== RESPONSE_STORE_BINDING));
+		for (const [name, value] of Object.entries(workerExports)) {
+			if (!isUnknownRecord(value)) throw new Error(`The existing Wrangler config has an invalid ${name} export.`);
+			if (value.type === "worker" && value.cache === void 0) workerExports[name] = {
+				...value,
+				cache: { enabled: false }
+			};
+		}
+		const responseStoreExport = workerExports.ResponseStoreBinding;
+		if (responseStoreExport !== void 0 && !isUnknownRecord(responseStoreExport)) throw new Error("The existing Wrangler config has an invalid ResponseStoreBinding export.");
+		workerExports.ResponseStoreBinding = {
+			...responseStoreExport,
+			type: "worker",
+			cache: { enabled: true }
+		};
+		if (cacheMetadataExport !== void 0 && !hasCacheMetadataExport) throw new Error(`The existing ${CACHE_METADATA_CLASS} export conflicts with Workers Response Store.`);
+		workerExports[CACHE_METADATA_CLASS] = CACHE_METADATA_EXPORT;
+		const r2Buckets = config.r2_buckets;
+		if (r2Buckets !== void 0 && !Array.isArray(r2Buckets)) throw new Error("The existing Wrangler config has an invalid r2_buckets value.");
+		const existingBuckets = r2Buckets ?? [];
+		if (existingBuckets.some((bucket) => !isUnknownRecord(bucket))) throw new Error("The existing Wrangler config has an invalid R2 binding.");
+		if (!existingBuckets.some((bucket) => bucket.binding === CACHE_BODIES_BINDING)) {
+			const appName = typeof config.name === "string" && config.name.length > 0 ? config.name : detectProject(root).projectName;
+			code = setTopLevelJsonProperty(code, "r2_buckets", [...existingBuckets, {
+				binding: CACHE_BODIES_BINDING,
+				bucket_name: compactResourceName(appName, "-response-store-cache-bodies", 63)
+			}]);
+		}
+		const durableObjects = config.durable_objects;
+		if (durableObjects !== void 0 && !isUnknownRecord(durableObjects)) throw new Error("The existing Wrangler config has an invalid durable_objects value.");
+		const durableBindings = durableObjects?.bindings;
+		if (durableBindings !== void 0 && !Array.isArray(durableBindings)) throw new Error("The existing Wrangler config has invalid Durable Object bindings.");
+		const existingDurableBindings = durableBindings ?? [];
+		if (existingDurableBindings.some((binding) => !isUnknownRecord(binding))) throw new Error("The existing Wrangler config has an invalid Durable Object binding.");
+		const existingMetadataBinding = existingDurableBindings.find((binding) => binding.name === CACHE_METADATA_BINDING);
+		if (existingMetadataBinding && (existingMetadataBinding.class_name !== CACHE_METADATA_CLASS || existingMetadataBinding.script_name !== void 0)) throw new Error(`The ${CACHE_METADATA_BINDING} Durable Object binding is incompatible.`);
+		code = setTopLevelJsonProperty(code, "durable_objects", {
+			...durableObjects,
+			bindings: existingMetadataBinding ? existingDurableBindings : [...existingDurableBindings, {
+				name: CACHE_METADATA_BINDING,
+				class_name: CACHE_METADATA_CLASS
+			}]
+		});
+		const migrations = config.migrations;
+		if (migrations !== void 0 && !Array.isArray(migrations)) throw new Error("The existing Wrangler config has an invalid migrations value.");
+		const existingMigrations = migrations ?? [];
+		if (existingMigrations.some((migration) => !isUnknownRecord(migration))) throw new Error("The existing Wrangler config has an invalid Durable Object migration.");
+		if (existingMigrations.length > 0) throw new Error("Self-contained Workers Response Store cannot be combined with migration-based Durable Objects. Convert the existing Durable Objects to declarative exports or use service-binding mode.");
+	}
+	return updateWorkerExports ? setTopLevelJsonProperty(code, "exports", workerExports) : code;
+}
+function generateResponseStoreWranglerConfig(appWranglerCode, root) {
+	const appConfig = JSON.parse(stripJsonComments(appWranglerCode));
+	const serviceName = readResponseStoreServiceName(root, appConfig);
+	const compatibilityDate = typeof appConfig.compatibility_date === "string" ? appConfig.compatibility_date : (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+	const compatibilityFlags = ["nodejs_compat"];
+	if (compatibilityDate < CTX_EXPORTS_DEFAULT_DATE) compatibilityFlags.push("enable_ctx_exports");
+	return `${JSON.stringify({
+		$schema: "node_modules/wrangler/config-schema.json",
+		name: serviceName,
+		main: RESPONSE_STORE_MAIN,
+		compatibility_date: compatibilityDate,
+		compatibility_flags: compatibilityFlags,
+		workers_dev: false,
+		preview_urls: false,
+		cache: { enabled: true },
+		exports: {
+			default: {
+				type: "worker",
+				cache: { enabled: false }
+			},
+			ResponseStoreBinding: {
+				type: "worker",
+				cache: { enabled: true }
+			},
+			[CACHE_METADATA_CLASS]: CACHE_METADATA_EXPORT
+		},
+		r2_buckets: [{
+			binding: CACHE_BODIES_BINDING,
+			bucket_name: compactResourceName(serviceName, "-cache-bodies", 63)
+		}],
+		durable_objects: { bindings: [{
+			name: CACHE_METADATA_BINDING,
+			class_name: CACHE_METADATA_CLASS
+		}] },
+		...typeof appConfig.account_id === "string" ? { account_id: appConfig.account_id } : {}
+	}, null, 2)}\n`;
+}
 function updateWranglerConfigForCloudflare(code, options, context = {}) {
 	let config;
 	try {
@@ -283,6 +631,24 @@ function updateWranglerConfigForCloudflare(code, options, context = {}) {
 		output = appendTopLevelJsonProperty(output, `  "main": ${JSON.stringify(workerEntry)}`);
 	}
 	if (!findTopLevelJsonProperty(output, "assets")) output = appendTopLevelJsonProperty(output, "  \"assets\": { \"directory\": \"dist/client\", \"not_found_handling\": \"none\", \"binding\": \"ASSETS\" }");
+	if (options.cdnCache === "static-assets") {
+		const assetsProperty = findTopLevelJsonProperty(output, "assets");
+		const assets = JSON.parse(stripJsonComments(output.slice(assetsProperty.valueStart, assetsProperty.valueEnd)));
+		if (!assets || typeof assets !== "object" || Array.isArray(assets)) throw new Error("The existing Wrangler config has an invalid assets value.");
+		const workerFirst = assets.run_worker_first;
+		if (workerFirst !== void 0 && typeof workerFirst !== "boolean" && !Array.isArray(workerFirst)) throw new Error("The existing Wrangler config has an invalid assets.run_worker_first value.");
+		if (Array.isArray(workerFirst) && workerFirst.some((pattern) => typeof pattern !== "string" || pattern.startsWith("!"))) throw new Error("Static Assets cache requires run_worker_first without exclusion patterns. Use true or an array of positive path patterns.");
+		const protectedRouting = workerFirst === true ? true : [.../* @__PURE__ */ new Set([...Array.isArray(workerFirst) ? workerFirst : [], "/_vinext/static-cache/*"])];
+		if (typeof assets.directory !== "string" || assets.directory.length === 0 || typeof assets.binding !== "string" || assets.binding.length === 0 || JSON.stringify(workerFirst) !== JSON.stringify(protectedRouting)) {
+			const updatedAssets = JSON.stringify({
+				...assets,
+				...typeof assets.directory === "string" && assets.directory.length > 0 ? {} : { directory: "dist/client" },
+				...typeof assets.binding === "string" && assets.binding.length > 0 ? {} : { binding: "ASSETS" },
+				run_worker_first: protectedRouting
+			});
+			output = `${output.slice(0, assetsProperty.valueStart)}${updatedAssets}${output.slice(assetsProperty.valueEnd)}`;
+		}
+	}
 	if (options.cdnCache === "workers-cache") {
 		const cacheProperty = findTopLevelJsonProperty(output, "cache");
 		if (!cacheProperty) output = appendTopLevelJsonProperty(output, "  \"cache\": { \"enabled\": true }");
@@ -296,6 +662,12 @@ function updateWranglerConfigForCloudflare(code, options, context = {}) {
 				output = `${output.slice(0, cacheProperty.valueStart)}${updatedCache}${output.slice(cacheProperty.valueEnd)}`;
 			}
 		}
+		const versionMetadataProperty = findTopLevelJsonProperty(output, "version_metadata");
+		if (!versionMetadataProperty) output = appendTopLevelJsonProperty(output, `  "version_metadata": { "binding": "${DEFAULT_VERSION_METADATA_BINDING}" }`);
+		else {
+			const versionMetadata = JSON.parse(stripJsonComments(output.slice(versionMetadataProperty.valueStart, versionMetadataProperty.valueEnd)));
+			if (!versionMetadata || typeof versionMetadata.binding !== "string" || versionMetadata.binding.length === 0) output = `${output.slice(0, versionMetadataProperty.valueStart)}{ "binding": "${DEFAULT_VERSION_METADATA_BINDING}" }${output.slice(versionMetadataProperty.valueEnd)}`;
+		}
 	}
 	if (options.imageOptimization === "cloudflare-images") {
 		const imagesProperty = findTopLevelJsonProperty(output, "images");
@@ -307,17 +679,18 @@ function updateWranglerConfigForCloudflare(code, options, context = {}) {
 	}
 	if (options.dataCache === "kv") {
 		const kvProperty = findTopLevelJsonProperty(output, "kv_namespaces");
-		if (!kvProperty) output = appendTopLevelJsonProperty(output, "  \"kv_namespaces\": [{ \"binding\": \"VINEXT_KV_CACHE\", \"id\": \"<your-kv-namespace-id>\" }]");
+		if (!kvProperty) output = appendTopLevelJsonProperty(output, "  \"kv_namespaces\": [{ \"binding\": \"VINEXT_KV_CACHE\" }]");
 		else {
 			const rawValue = output.slice(kvProperty.valueStart, kvProperty.valueEnd);
 			if (!JSON.parse(stripJsonComments(rawValue)).some((namespace) => namespace.binding === "VINEXT_KV_CACHE")) {
 				const closing = kvProperty.valueEnd - 1;
 				const content = output.slice(kvProperty.valueStart + 1, closing);
 				const separator = content.trim() ? `${/,\s*$/.test(content) ? "" : ","}\n    ` : "";
-				output = `${output.slice(0, closing)}${separator}{ "binding": "VINEXT_KV_CACHE", "id": "<your-kv-namespace-id>" }${output.slice(closing)}`;
+				output = `${output.slice(0, closing)}${separator}{ "binding": "VINEXT_KV_CACHE" }${output.slice(closing)}`;
 			}
 		}
 	}
+	if (options.cdnCache === "response-store") output = configureResponseStoreWrangler(output, config, options.responseStoreMode ?? "service-binding", context.root ?? process.cwd());
 	return output;
 }
 function getWranglerImagesBinding(code) {
@@ -326,40 +699,88 @@ function getWranglerImagesBinding(code) {
 	const images = JSON.parse(stripJsonComments(code.slice(property.valueStart, property.valueEnd)));
 	return images && typeof images.binding === "string" && images.binding.length > 0 ? images.binding : "IMAGES";
 }
+function getWranglerAssetsBinding(code) {
+	const property = findTopLevelJsonProperty(code, "assets");
+	if (!property) return "ASSETS";
+	const assets = JSON.parse(stripJsonComments(code.slice(property.valueStart, property.valueEnd)));
+	return assets && typeof assets.binding === "string" && assets.binding.length > 0 ? assets.binding : "ASSETS";
+}
+function getWranglerAssetsDirectory(code) {
+	const property = findTopLevelJsonProperty(code, "assets");
+	if (!property) return "dist/client";
+	const assets = JSON.parse(stripJsonComments(code.slice(property.valueStart, property.valueEnd)));
+	return assets && typeof assets.directory === "string" && assets.directory.length > 0 ? assets.directory : "dist/client";
+}
+function getWranglerVersionMetadataBinding(code) {
+	const property = findTopLevelJsonProperty(code, "version_metadata");
+	if (!property) return DEFAULT_VERSION_METADATA_BINDING;
+	const versionMetadata = JSON.parse(stripJsonComments(code.slice(property.valueStart, property.valueEnd)));
+	return versionMetadata && typeof versionMetadata.binding === "string" && versionMetadata.binding.length > 0 ? versionMetadata.binding : DEFAULT_VERSION_METADATA_BINDING;
+}
 function cacheImports(options) {
 	const imports = [];
 	if (options.dataCache === "kv") imports.push("import { kvDataAdapter } from \"@vinext/cloudflare/cache/kv-data-adapter\";");
-	if (options.cdnCache === "workers-cache") imports.push("import { cdnAdapter } from \"@vinext/cloudflare/cache/cdn-adapter\";");
+	if (options.cdnCache === "workers-cache") imports.push("import { workersCacheCdnAdapter } from \"@vinext/cloudflare/cache/workers-cache-cdn-adapter\";");
+	if (options.cdnCache === "static-assets") imports.push("import { staticAssetsAdapter } from \"@vinext/cloudflare/cache/static-assets-adapter\";");
+	if (options.cdnCache === "response-store") imports.push("import { responseStoreAdapter } from \"@vinext/cloudflare/cache/response-store-adapter\";");
 	if (options.imageOptimization === "cloudflare-images") imports.push("import { imagesOptimizer } from \"@vinext/cloudflare/images/images-optimizer\";");
 	return imports;
 }
-function vinextExpression(options, binding = "vinext", imageBinding = "imagesOptimizer", imagesBinding = "IMAGES", prerender = false) {
+function vinextExpression(options, binding = "vinext", imageBinding = "imagesOptimizer", imagesBinding = "IMAGES", versionMetadataBinding = DEFAULT_VERSION_METADATA_BINDING, responseStoreBinding = "responseStoreAdapter", assetsBinding = "ASSETS", assetsDirectory = "dist/client") {
+	const responseStore = options.cdnCache === "response-store";
 	const cacheEntries = [];
 	if (options.dataCache === "kv") cacheEntries.push("data: kvDataAdapter()");
-	if (options.cdnCache === "workers-cache") cacheEntries.push("cdn: cdnAdapter()");
+	if (options.cdnCache === "workers-cache") {
+		const adapterOptions = versionMetadataBinding === DEFAULT_VERSION_METADATA_BINDING ? "" : `{ versionMetadataBinding: ${JSON.stringify(versionMetadataBinding)} }`;
+		cacheEntries.push(`cdn: workersCacheCdnAdapter(${adapterOptions})`);
+	}
+	if (options.cdnCache === "static-assets") {
+		const adapterOptions = assetsBinding === "ASSETS" ? "" : `{ binding: ${JSON.stringify(assetsBinding)} }`;
+		cacheEntries.push(`cdn: staticAssetsAdapter(${adapterOptions})`);
+	}
 	const optionEntries = [];
-	if (cacheEntries.length > 0) optionEntries.push(`cache: { ${cacheEntries.join(", ")} }`);
+	if (responseStore) optionEntries.push(`cache: ${responseStoreBinding}(${options.responseStoreMode === "self-contained" ? "{ mode: \"self-contained\" }" : ""})`);
+	else if (cacheEntries.length > 0) optionEntries.push(`cache: { ${cacheEntries.join(", ")} }`);
+	if (options.cdnCache === "static-assets" || options.prerender) optionEntries.push("prerender: { routes: \"*\" }");
+	if (options.cdnCache === "static-assets") {
+		if (path.normalize(assetsDirectory) !== path.normalize("dist/client")) optionEntries.push(`clientOutDir: ${JSON.stringify(assetsDirectory)}`);
+	}
 	if (options.imageOptimization === "cloudflare-images") {
 		const adapterOptions = imagesBinding === "IMAGES" ? "" : `{ binding: ${JSON.stringify(imagesBinding)} }`;
 		optionEntries.push(`images: { optimizer: ${imageBinding}(${adapterOptions}) }`);
 	}
-	if (prerender) optionEntries.push(`prerender: { routes: "*" }`);
 	return optionEntries.length === 0 ? `${binding}()` : `${binding}({\n  ${optionEntries.join(",\n  ")},\n})`;
 }
+function scopedNameSource(indent, pathBinding = "path", hashBinding = "createHash", typescript = true) {
+	return `${indent}generateScopedName(${typescript ? "name: string, filename: string" : "name, filename"}) {
+${indent}  const relativePath = ${pathBinding}.relative(import.meta.dirname, filename.replace(/\\?.*$/, "")).replaceAll("\\\\", "/");
+${indent}  return \`_\${name}_\${${hashBinding}("sha256").update(relativePath).digest("hex").slice(0, 7)}\`;
+${indent}}`;
+}
+function cssModulesConfigSource(indent = "  ") {
+	return `\n${indent}css: {
+${indent}  modules: {
+${scopedNameSource(`${indent}    `)},
+${indent}  },
+${indent}},`;
+}
 /** Generate vite.config.ts for App Router */
-function generateAppRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPTIONS, imagesBinding = "IMAGES", prerender = false) {
+function generateAppRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPTIONS, imagesBinding = "IMAGES", versionMetadataBinding = DEFAULT_VERSION_METADATA_BINDING, serviceBinding = false, assetsBinding = "ASSETS", assetsDirectory = "dist/client", hasCssModules = false) {
 	const imports = [
 		`import { defineConfig } from "vite";`,
 		`import vinext from "vinext";`,
 		`import { cloudflare } from "@cloudflare/vite-plugin";`,
-		...cacheImports(options)
+		...serviceBinding ? ["import { responseStoreServiceBinding } from \"./cloudflare.config\";"] : [],
+		...cacheImports(options),
+		...hasCssModules ? ["import { createHash } from \"node:crypto\";", "import { patchCssModules } from \"vite-css-modules\";"] : []
 	];
-	if (info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) imports.push(`import path from "node:path";`);
+	if (hasCssModules || info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) imports.push(`import path from "node:path";`);
 	const plugins = [];
+	if (hasCssModules) plugins.push("    patchCssModules({ exportMode: \"default\" }),");
 	if (info?.hasMDX) plugins.push(`    // vinext auto-injects @mdx-js/rollup with plugins from next.config`);
-	plugins.push(`    ${vinextExpression(options, "vinext", "imagesOptimizer", imagesBinding, prerender).replace(/\n/g, "\n    ")},`);
+	plugins.push(`    ${vinextExpression(options, "vinext", "imagesOptimizer", imagesBinding, versionMetadataBinding, "responseStoreAdapter", assetsBinding, assetsDirectory).replace(/\n/g, "\n    ")},`);
 	plugins.push(`    cloudflare({
-      viteEnvironment: {
+      ${serviceBinding ? "auxiliaryWorkers: [{ config: responseStoreServiceBinding }],\n      " : ""}viteEnvironment: {
         name: "rsc",
         childEnvironments: ["ssr"],
       },
@@ -373,19 +794,21 @@ function generateAppRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPT
 export default defineConfig({
   plugins: [
 ${plugins.join("\n")}
-  ],${resolveBlock}
+  ],${resolveBlock}${hasCssModules ? cssModulesConfigSource() : ""}
 });
 `;
 }
 /** Generate vite.config.ts for Pages Router */
-function generatePagesRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPTIONS, imagesBinding = "IMAGES", prerender = false) {
+function generatePagesRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPTIONS, imagesBinding = "IMAGES", versionMetadataBinding = DEFAULT_VERSION_METADATA_BINDING, serviceBinding = false, hasCssModules = false) {
 	const imports = [
 		`import { defineConfig } from "vite";`,
 		`import vinext from "vinext";`,
 		`import { cloudflare } from "@cloudflare/vite-plugin";`,
-		...cacheImports(options)
+		...serviceBinding ? ["import { responseStoreServiceBinding } from \"./cloudflare.config\";"] : [],
+		...cacheImports(options),
+		...hasCssModules ? ["import { createHash } from \"node:crypto\";", "import { patchCssModules } from \"vite-css-modules\";"] : []
 	];
-	if (info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) imports.push(`import path from "node:path";`);
+	if (hasCssModules || info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) imports.push(`import path from "node:path";`);
 	let resolveBlock = "";
 	const aliases = [];
 	if (info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) for (const mod of info.nativeModulesToStub) aliases.push(`      "${mod}": path.resolve(__dirname, "empty-stub.js"),`);
@@ -394,9 +817,9 @@ function generatePagesRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_O
 
 export default defineConfig({
   plugins: [
-    ${vinextExpression(options, "vinext", "imagesOptimizer", imagesBinding, prerender).replace(/\n/g, "\n    ")},
-    cloudflare(),
-  ],${resolveBlock}
+${hasCssModules ? "    patchCssModules({ exportMode: \"default\" }),\n" : ""}    ${vinextExpression(options, "vinext", "imagesOptimizer", imagesBinding, versionMetadataBinding).replace(/\n/g, "\n    ")},
+    cloudflare(${serviceBinding ? "{ auxiliaryWorkers: [{ config: responseStoreServiceBinding }] }" : ""}),
+  ],${resolveBlock}${hasCssModules ? cssModulesConfigSource() : ""}
 });
 `;
 }
@@ -532,14 +955,17 @@ function allocateBinding(bindings, preferred) {
 }
 function findImportedBinding(program, source, imported) {
 	for (const statement of program.body) {
-		if (statement.type !== "ImportDeclaration" || statement.source.value !== source) continue;
-		for (const specifier of statement.specifiers) if (specifier.type === "ImportSpecifier" && specifier.imported.type === "Identifier" && specifier.imported.name === imported) return specifier.local.name;
+		if (statement.type !== "ImportDeclaration" || statement.importKind === "type" || statement.source.value !== source) continue;
+		for (const specifier of statement.specifiers) if (specifier.type === "ImportSpecifier" && specifier.importKind !== "type" && specifier.imported.type === "Identifier" && specifier.imported.name === imported) return specifier.local.name;
 	}
 }
+function quoteImportSource(program, source) {
+	return program.body.find((statement) => statement.type === "ImportDeclaration")?.source.raw?.startsWith("'") ? `'${source.replaceAll("\\", "\\\\").replaceAll("'", "\\'")}'` : JSON.stringify(source);
+}
 function ensureNamedImport(program, output, source, imported, binding) {
 	const existing = findImportedBinding(program, source, imported);
 	if (existing) return existing;
-	const declaration = program.body.find((statement) => statement.type === "ImportDeclaration" && statement.source.value === source);
+	const declaration = program.body.find((statement) => statement.type === "ImportDeclaration" && statement.importKind !== "type" && statement.source.value === source);
 	if (declaration) {
 		const named = declaration.specifiers.filter((specifier) => specifier.type === "ImportSpecifier");
 		if (named.length > 0) {
@@ -549,15 +975,15 @@ function ensureNamedImport(program, output, source, imported, binding) {
 		}
 	}
 	const offset = importInsertionOffset(program);
-	const sourceText = `import { ${binding === imported ? imported : `${imported} as ${binding}`} } from ${JSON.stringify(source)};`;
+	const sourceText = `import { ${binding === imported ? imported : `${imported} as ${binding}`} } from ${quoteImportSource(program, source)};`;
 	output.appendLeft(offset, offset === 0 ? `${sourceText}\n` : `\n${sourceText}`);
 	return binding;
 }
 function ensureDefaultImport(program, output, source, binding) {
-	const existing = program.body.find((statement) => statement.type === "ImportDeclaration" && statement.source.value === source)?.specifiers.find((specifier) => specifier.type === "ImportDefaultSpecifier");
+	const existing = program.body.find((statement) => statement.type === "ImportDeclaration" && statement.importKind !== "type" && statement.source.value === source)?.specifiers.find((specifier) => specifier.type === "ImportDefaultSpecifier");
 	if (existing) return existing.local.name;
 	const offset = importInsertionOffset(program);
-	const sourceText = `import ${binding} from ${JSON.stringify(source)};`;
+	const sourceText = `import ${binding} from ${quoteImportSource(program, source)};`;
 	output.appendLeft(offset, offset === 0 ? `${sourceText}\n` : `\n${sourceText}`);
 	return binding;
 }
@@ -596,11 +1022,50 @@ function ensureDefaultRequire(program, output, source, binding) {
 	output.appendLeft(offset, offset === 0 ? `${sourceText}\n` : `\n${sourceText}`);
 	return binding;
 }
+const insertedCommas = /* @__PURE__ */ new WeakMap();
 function insertObjectProperty(output, object, source, code) {
 	const offset = object.end - 1;
-	const hasProperties = object.properties.length > 0;
-	const hasTrailingComma = /,\s*$/.test(code.slice(object.start + 1, offset));
-	output.appendLeft(offset, `${hasProperties && !hasTrailingComma ? "," : ""}\n${source}\n`);
+	const lastProperty = object.properties.at(-1);
+	if (lastProperty) {
+		const gap = code.slice(lastProperty.end, offset);
+		if (!endsWithCommaIgnoringWhitespaceAndComments(gap) && !insertedCommas.get(output)?.has(lastProperty.end)) {
+			if (/^[ \t]+$/.test(gap)) output.update(lastProperty.end, offset, ",");
+			else output.appendLeft(lastProperty.end, ",");
+			const offsets = insertedCommas.get(output) ?? /* @__PURE__ */ new Set();
+			offsets.add(lastProperty.end);
+			insertedCommas.set(output, offsets);
+		}
+	}
+	output.appendLeft(offset, `\n${source}\n`);
+}
+function formatInlineConfig(filePath, code, originalCode) {
+	if (code === originalCode) return code;
+	const config = findConfigObject(parseViteConfig(filePath, code));
+	if (!config || config.properties.length === 0) return code;
+	const output = new MagicString(code);
+	const lineStart = code.lastIndexOf("\n", config.start) + 1;
+	const indent = code.slice(lineStart, config.start).match(/^[ \t]*/)?.[0] ?? "";
+	const properties = config.properties;
+	const first = properties[0];
+	const opening = code.slice(config.start + 1, first.start);
+	if (/^[ \t]*$/.test(opening)) {
+		if (opening) output.update(config.start + 1, first.start, `\n${indent}  `);
+		else output.appendLeft(first.start, `\n${indent}  `);
+	}
+	for (let index = 1; index < properties.length; index++) {
+		const previous = properties[index - 1];
+		const current = properties[index];
+		const gap = code.slice(previous.end, current.start);
+		if (/^,[ \t]*$/.test(gap)) output.update(previous.end, current.start, `,\n${indent}  `);
+	}
+	const last = properties.at(-1);
+	const closing = code.slice(last.end, config.end - 1);
+	if (/^,?[ \t]*$/.test(closing)) {
+		const replacement = `${closing.includes(",") ? "," : ""}\n${indent}`;
+		if (closing) output.update(last.end, config.end - 1, replacement);
+		else output.appendLeft(last.end, replacement);
+	}
+	return output.toString();
 }
 function endsWithCommaIgnoringWhitespaceAndComments(code) {
 	let index = 0;
@@ -671,11 +1136,20 @@ function findPluginCall(config, binding) {
 	if (!plugins || plugins.value.type !== "ArrayExpression") return void 0;
 	return plugins.value.elements.find((element) => element?.type === "CallExpression" && element.callee.type === "Identifier" && element.callee.name === binding);
 }
-function hasVinextCacheSlot(call, name) {
+function getVinextCacheSlot(call, name) {
 	const firstArgument = call?.arguments[0];
-	if (!firstArgument || firstArgument.type === "SpreadElement" || firstArgument.type !== "ObjectExpression") return false;
+	if (!firstArgument || firstArgument.type === "SpreadElement" || firstArgument.type !== "ObjectExpression") return;
 	const cache = findProperty(firstArgument, "cache");
-	return cache?.value.type === "ObjectExpression" && Boolean(findProperty(cache.value, name));
+	if (cache?.value.type !== "ObjectExpression") return void 0;
+	return findProperty(cache.value, name);
+}
+function getVinextCacheOption(call) {
+	const firstArgument = call?.arguments[0];
+	if (!firstArgument || firstArgument.type === "SpreadElement" || firstArgument.type !== "ObjectExpression") return;
+	return findProperty(firstArgument, "cache");
+}
+function hasVinextCacheSlot(call, name) {
+	return Boolean(getVinextCacheSlot(call, name));
 }
 function getVinextImageOptimizer(call) {
 	const firstArgument = call?.arguments[0];
@@ -684,11 +1158,6 @@ function getVinextImageOptimizer(call) {
 	if (images?.value.type !== "ObjectExpression") return void 0;
 	return findProperty(images.value, "optimizer");
 }
-function hasVinextPrerender(call) {
-	const firstArgument = call?.arguments[0];
-	if (!firstArgument || firstArgument.type === "SpreadElement" || firstArgument.type !== "ObjectExpression") return false;
-	return Boolean(findProperty(firstArgument, "prerender"));
-}
 function isUsableImageOptimizer(property) {
 	if (!property) return false;
 	const value = property.value;
@@ -718,6 +1187,17 @@ function ensureVinextCache(output, config, vinextBinding, additions, code) {
 	const missing = additions.filter(({ name }) => !findProperty(cacheObject, name));
 	if (missing.length > 0) insertObjectProperty(output, cacheObject, missing.map(({ name, expression }) => `      ${name}: ${expression},`).join("\n"), code);
 }
+function ensureVinextResponseStore(output, config, vinextBinding, expression, code) {
+	if (!expression) return;
+	const call = findPluginCall(config, vinextBinding);
+	const firstArgument = call?.arguments[0];
+	if (!call || !firstArgument || firstArgument.type === "SpreadElement") return;
+	if (firstArgument.type !== "ObjectExpression") throw new Error("The vinext() plugin options must be a static object for vinext init to configure Workers Response Store.");
+	const optionsObject = firstArgument;
+	const cache = findProperty(optionsObject, "cache");
+	if (!cache) insertObjectProperty(output, optionsObject, `    cache: ${expression},`, code);
+	else if (cache.value.type === "ObjectExpression" && cache.value.properties.length === 0) output.overwrite(cache.value.start, cache.value.end, expression);
+}
 function ensureVinextImageOptimizer(output, config, vinextBinding, expression, code) {
 	if (!expression) return;
 	const call = findPluginCall(config, vinextBinding);
@@ -740,17 +1220,28 @@ function ensureVinextImageOptimizer(output, config, vinextBinding, expression, c
 	if (!optimizer) insertObjectProperty(output, imagesObject, `      optimizer: ${expression},`, code);
 	else output.overwrite(optimizer.value.start, optimizer.value.end, expression);
 }
-function ensureVinextPrerender(output, config, vinextBinding, prerender, code) {
-	if (!prerender) return;
+function ensureVinextPrerenderOptions(output, config, vinextBinding, assetsDirectory, code) {
 	const call = findPluginCall(config, vinextBinding);
-	if (!call || hasVinextPrerender(call)) return;
-	if (call.arguments.length === 0) {
-		output.appendLeft(call.end - 1, `{ prerender: { routes: "*" } }`);
-		return;
+	const firstArgument = call?.arguments[0];
+	if (!call || !firstArgument || firstArgument.type === "SpreadElement") return;
+	if (firstArgument.type !== "ObjectExpression") throw new Error("The vinext() plugin options must be a static object for vinext init to configure build-time prerendering.");
+	const optionsObject = firstArgument;
+	const additions = [];
+	const prerender = findProperty(optionsObject, "prerender");
+	if (!prerender) additions.push("    prerender: { routes: \"*\" },");
+	else {
+		const value = prerender.value;
+		if (value.type === "Literal" && (value.value === false || value.value === null) || value.type === "Identifier" && value.name === "undefined") output.overwrite(value.start, value.end, "{ routes: \"*\" }");
 	}
-	const firstArgument = call.arguments[0];
-	if (firstArgument.type === "SpreadElement" || firstArgument.type !== "ObjectExpression") throw new Error("The vinext() plugin options must be a static object for vinext init to add prerender config.");
-	insertObjectProperty(output, firstArgument, `    prerender: { routes: "*" },`, code);
+	const clientOutDir = assetsDirectory && findProperty(optionsObject, "clientOutDir");
+	if (assetsDirectory && !clientOutDir) {
+		if (path.normalize(assetsDirectory) !== path.normalize("dist/client")) additions.push(`    clientOutDir: ${JSON.stringify(assetsDirectory)},`);
+	} else if (assetsDirectory && clientOutDir) {
+		const value = clientOutDir.value;
+		if (value.type !== "Literal" || typeof value.value !== "string") throw new Error("The vinext() clientOutDir option must be a string literal for vinext init to align it with Wrangler assets.directory.");
+		if (path.normalize(value.value) !== path.normalize(assetsDirectory)) throw new Error(`The vinext() clientOutDir (${JSON.stringify(value.value)}) must match Wrangler assets.directory (${JSON.stringify(assetsDirectory)}) when using the Static Assets cache.`);
+	}
+	if (additions.length > 0) insertObjectProperty(output, optionsObject, additions.join("\n"), code);
 }
 function indentBlock(source, indent) {
 	return source.split("\n").map((line) => `${indent}${line}`).join("\n");
@@ -763,8 +1254,9 @@ function ensurePlugins(output, config, additions, code) {
 	}
 	if (plugins.value.type !== "ArrayExpression") throw new Error("The Vite config's plugins option must be an array for vinext init to update it.");
 	const array = plugins.value;
-	const propertyIndent = code.slice(0, plugins.start).split("\n").at(-1)?.match(/^\s*/)?.[0] ?? "";
-	const elementIndent = `${propertyIndent}  `;
+	const propertyIndent = code.slice(0, plugins.start).split("\n").at(-1)?.match(/^[ \t]*/)?.[0] ?? "";
+	const inlinePropertyIndent = code.slice(config.start, plugins.start).includes("\n") ? propertyIndent : `${propertyIndent}  `;
+	const elementIndent = `${inlinePropertyIndent}  `;
 	const missingExpressions = [];
 	for (const addition of additions) if (!array.elements.some((element) => element?.type === "CallExpression" && element.callee.type === "Identifier" && element.callee.name === addition.binding)) missingExpressions.push(addition.expression);
 	if (missingExpressions.length === 0) return;
@@ -793,7 +1285,91 @@ function ensurePlugins(output, config, additions, code) {
 			previousElement = element;
 		}
 	}
-	output.appendLeft(closingOffset, `${prefix}\n${missingExpressions.map((expression) => indentBlock(expression, elementIndent)).join(",\n")},\n${propertyIndent}`);
+	output.appendLeft(closingOffset, `${prefix}\n${missingExpressions.map((expression) => indentBlock(expression, elementIndent)).join(",\n")},\n${inlinePropertyIndent}`);
+}
+function simpleCssConfig(program) {
+	const value = program.body.find((statement) => statement.type === "ExportDefaultDeclaration")?.declaration;
+	const direct = value && value.type !== "FunctionDeclaration" && value.type !== "ClassDeclaration" ? unwrapObject(value) : void 0;
+	if (direct) return direct;
+	if (value?.type === "CallExpression" && value.callee.type === "Identifier" && value.callee.name === findImportedBinding(program, "vite", "defineConfig") && value.arguments[0]?.type === "ObjectExpression") return value.arguments[0];
+	throw new Error("CSS Modules require an inline Vite config object (export default { ... } or defineConfig({ ... })). Convert a dynamic config to an inline object before running vinext init, or finish migration manually with patchCssModules({ exportMode: \"default\" }) and a deterministic css.modules.generateScopedName.");
+}
+function simpleProperties(object) {
+	const names = /* @__PURE__ */ new Set();
+	for (const property of object.properties) {
+		const name = property.type === "Property" ? propertyName(property) : void 0;
+		if (!name || property.type !== "Property" || property.kind !== "init" || names.has(name)) throw new Error("CSS Modules cannot safely update Vite config spreads, computed keys, accessors, or duplicate properties. Add patchCssModules({ exportMode: \"default\" }) before vinext() and a deterministic css.modules.generateScopedName manually.");
+		names.add(name);
+	}
+}
+function updateViteConfigForCssModules(filePath, code) {
+	const program = parseViteConfig(filePath, code);
+	const config = simpleCssConfig(program);
+	simpleProperties(config);
+	const css = findProperty(config, "css");
+	const cssObject = css?.value.type === "ObjectExpression" ? css.value : void 0;
+	if (css && !cssObject) throw new Error("CSS Modules require a literal css config object.");
+	if (cssObject) simpleProperties(cssObject);
+	const modules = cssObject && findProperty(cssObject, "modules");
+	const modulesObject = modules?.value.type === "ObjectExpression" ? modules.value : void 0;
+	if (modules && !modulesObject) throw new Error("CSS Modules require a literal css.modules object.");
+	if (modulesObject) simpleProperties(modulesObject);
+	const existingName = modulesObject && findProperty(modulesObject, "generateScopedName");
+	if (existingName) {
+		const value = existingName.value;
+		if (value.type !== "FunctionExpression" && value.type !== "ArrowFunctionExpression" && !(value.type === "Literal" && typeof value.value === "string" && !/\[hash(?::[^\]]*)?\]/i.test(value.value))) throw new Error("CSS Modules need a deterministic generateScopedName function; replace the existing hash template or dynamic value manually.");
+	}
+	const firstOutput = new MagicString(code);
+	if (!existingName) {
+		const bindings = collectTopLevelBindings(program);
+		const hashBinding = ensureNamedImport(program, firstOutput, "node:crypto", "createHash", allocateBinding(bindings, "createHash"));
+		const source = scopedNameSource("      ", ensureDefaultImport(program, firstOutput, "node:path", allocateBinding(bindings, "path")), hashBinding, [
+			".ts",
+			".mts",
+			".cts"
+		].includes(path.extname(filePath)));
+		if (modulesObject) insertObjectProperty(firstOutput, modulesObject, `${source},`, code);
+		else if (cssObject) insertObjectProperty(firstOutput, cssObject, `    modules: {\n${source},\n    },`, code);
+		else insertObjectProperty(firstOutput, config, `  css: {\n    modules: {\n${source},\n    },\n  },`, code);
+	}
+	const withCss = firstOutput.toString();
+	const nextProgram = parseViteConfig(filePath, withCss);
+	const nextConfig = simpleCssConfig(nextProgram);
+	const plugins = findProperty(nextConfig, "plugins");
+	const pluginArray = plugins?.value.type === "ArrayExpression" ? plugins.value : void 0;
+	if (plugins && !pluginArray) throw new Error("CSS Modules require a literal plugins array.");
+	if (pluginArray?.elements.some((element) => element?.type === "SpreadElement")) throw new Error("CSS Modules cannot safely update a plugins array containing spreads.");
+	if (pluginArray?.elements.some((element) => element && element.type !== "CallExpression")) throw new Error("CSS Modules require direct plugin calls in the plugins array.");
+	const existingBinding = findImportedBinding(nextProgram, "vite-css-modules", "patchCssModules");
+	const namespaceBinding = nextProgram.body.filter((statement) => statement.type === "ImportDeclaration" && statement.importKind !== "type" && statement.source.value === "vite-css-modules").flatMap((statement) => statement.specifiers).find((specifier) => specifier.type === "ImportNamespaceSpecifier")?.local.name;
+	const existingCall = pluginArray?.elements.find((element) => element?.type === "CallExpression" && (element.callee.type === "Identifier" && element.callee.name === (existingBinding ?? "patchCssModules") || element.callee.type === "MemberExpression" && !element.callee.computed && element.callee.property.type === "Identifier" && element.callee.property.name === "patchCssModules"));
+	if (existingCall?.type === "CallExpression") {
+		const callee = existingCall.callee;
+		if (callee.type === "Identifier" && callee.name !== existingBinding || callee.type === "MemberExpression" && (callee.object.type !== "Identifier" || callee.object.name !== namespaceBinding)) throw new Error("Import patchCssModules from \"vite-css-modules\" before configuring CSS Modules.");
+		const argument = existingCall.arguments[0];
+		if (argument?.type === "ObjectExpression") simpleProperties(argument);
+		const mode = argument?.type === "ObjectExpression" ? findProperty(argument, "exportMode") : void 0;
+		if (argument?.type !== "ObjectExpression" || argument.properties.some((property) => property.type !== "Property" || property.computed) || mode?.value.type !== "Literal" || mode.value.value !== "default") throw new Error("Set the existing patchCssModules plugin to exportMode: \"default\" for CSS classes named \"default\".");
+	} else {
+		const output = new MagicString(withCss);
+		const expression = `${ensureNamedImport(nextProgram, output, "vite-css-modules", "patchCssModules", allocateBinding(collectTopLevelBindings(nextProgram), "patchCssModules"))}({ exportMode: "default" })`;
+		if (!pluginArray) insertObjectProperty(output, nextConfig, `  plugins: [${expression}],`, withCss);
+		else {
+			const first = pluginArray.elements.find(Boolean);
+			output.appendLeft(first ? first.start : pluginArray.end - 1, first ? `${expression}, ` : expression);
+		}
+		const updated = output.toString();
+		parseViteConfig(filePath, updated);
+		return {
+			code: formatInlineConfig(filePath, updated, code),
+			preservedExistingGenerateScopedName: Boolean(existingName)
+		};
+	}
+	parseViteConfig(filePath, withCss);
+	return {
+		code: formatInlineConfig(filePath, withCss, code),
+		preservedExistingGenerateScopedName: Boolean(existingName)
+	};
 }
 function ensureNativeAliases(output, config, modules, pathBinding, code) {
 	if (modules.length === 0) return;
@@ -818,11 +1394,7 @@ function ensureNativeAliases(output, config, modules, pathBinding, code) {
 }
 function updateViteConfigForCloudflare(filePath, code, options) {
 	const program = parseViteConfig(filePath, code);
-	const cacheOptions = options.cache ?? {
-		dataCache: "none",
-		cdnCache: "workers-cache",
-		imageOptimization: "cloudflare-images"
-	};
+	const cacheOptions = options.cache ?? DEFAULT_CLOUDFLARE_INIT_OPTIONS;
 	const config = findConfigObject(program);
 	if (!config) throw new Error(`Could not find a static Vite config object in ${path.basename(filePath)}. Use an object export or defineConfig({...}) so vinext init can update it.`);
 	const output = new MagicString(code);
@@ -832,9 +1404,45 @@ function updateViteConfigForCloudflare(filePath, code, options) {
 	const vinextBinding = commonJs ? ensureDefaultRequire(program, output, "vinext", vinextLocal) : ensureDefaultImport(program, output, "vinext", vinextLocal);
 	const existingVinextCall = findPluginCall(config, vinextBinding);
 	const existingImageOptimizer = getVinextImageOptimizer(existingVinextCall);
-	const needsPrerender = Boolean(options.prerender && !hasVinextPrerender(existingVinextCall));
 	const configureCaches = options.cache !== void 0;
+	const existingCache = getVinextCacheOption(existingVinextCall);
+	if (configureCaches && existingCache) {
+		const cacheObject = existingCache.value.type === "ObjectExpression" ? existingCache.value : void 0;
+		if (!cacheObject && cacheOptions.cdnCache !== "response-store" || cacheObject && (cacheOptions.cdnCache === "none" || cacheOptions.cdnCache === "data-cache") && findProperty(cacheObject, "cdn") || cacheObject && cacheOptions.dataCache === "none" && findProperty(cacheObject, "data")) throw new Error("The existing vinext() cache configuration does not match the selected cache options. Remove it before rerunning vinext init.");
+	}
 	const cacheAdditions = [];
+	let responseStoreExpression;
+	let responseStoreBinding = "responseStoreAdapter";
+	if (configureCaches && cacheOptions.cdnCache === "response-store") {
+		const source = "@vinext/cloudflare/cache/response-store-adapter";
+		const imported = "responseStoreAdapter";
+		const existing = commonJs ? findRequiredBinding(program, source, imported) : findImportedBinding(program, source, imported);
+		const cache = getVinextCacheOption(existingVinextCall);
+		const alreadyConfigured = Boolean(existing && cache?.value.type === "CallExpression" && cache.value.callee.type === "Identifier" && cache.value.callee.name === existing);
+		if (cache && !alreadyConfigured && !(cache.value.type === "ObjectExpression" && cache.value.properties.length === 0)) throw new Error("The vinext() cache option is already configured. Remove it before configuring Workers Response Store.");
+		if (!cache || alreadyConfigured || cache.value.type === "ObjectExpression" && cache.value.properties.length === 0) {
+			const local = existing ?? allocateBinding(bindings, imported);
+			const binding = commonJs ? ensureNamedRequire(program, output, source, imported, local) : ensureNamedImport(program, output, source, imported, local);
+			responseStoreBinding = binding;
+			responseStoreExpression = `${binding}(${cacheOptions.responseStoreMode === "self-contained" ? "{ mode: \"self-contained\" }" : ""})`;
+			if (alreadyConfigured && cache) {
+				const call = cache.value;
+				const argument = call.arguments[0];
+				const mode = cacheOptions.responseStoreMode ?? "service-binding";
+				if (!argument) {
+					if (mode === "self-contained") output.appendLeft(call.end - 1, "{ mode: \"self-contained\" }");
+				} else if (argument.type === "ObjectExpression") {
+					const optionsObject = argument;
+					const existingMode = findProperty(optionsObject, "mode");
+					if (existingMode) {
+						if (existingMode.shorthand) output.overwrite(existingMode.start, existingMode.end, `mode: ${JSON.stringify(mode)}`);
+						else output.overwrite(existingMode.value.start, existingMode.value.end, JSON.stringify(mode));
+					} else if (mode === "self-contained") insertObjectProperty(output, optionsObject, "      mode: \"self-contained\",", code);
+				} else throw new Error("responseStoreAdapter() options must be a static object for vinext init to update its mode.");
+				responseStoreExpression = void 0;
+			}
+		}
+	}
 	if (cacheOptions.dataCache === "kv" && !hasVinextCacheSlot(existingVinextCall, "data")) {
 		const local = (commonJs ? findRequiredBinding(program, "@vinext/cloudflare/cache/kv-data-adapter", "kvDataAdapter") : findImportedBinding(program, "@vinext/cloudflare/cache/kv-data-adapter", "kvDataAdapter")) ?? allocateBinding(bindings, "kvDataAdapter");
 		const binding = commonJs ? ensureNamedRequire(program, output, "@vinext/cloudflare/cache/kv-data-adapter", "kvDataAdapter", local) : ensureNamedImport(program, output, "@vinext/cloudflare/cache/kv-data-adapter", "kvDataAdapter", local);
@@ -843,15 +1451,41 @@ function updateViteConfigForCloudflare(filePath, code, options) {
 			expression: `${binding}()`
 		});
 	}
-	if (configureCaches && cacheOptions.cdnCache === "workers-cache" && !hasVinextCacheSlot(existingVinextCall, "cdn")) {
-		const imported = "cdnAdapter";
-		const source = "@vinext/cloudflare/cache/cdn-adapter";
-		const local = (commonJs ? findRequiredBinding(program, source, imported) : findImportedBinding(program, source, imported)) ?? allocateBinding(bindings, imported);
-		const binding = commonJs ? ensureNamedRequire(program, output, source, imported, local) : ensureNamedImport(program, output, source, imported, local);
-		cacheAdditions.push({
-			name: "cdn",
-			expression: `${binding}()`
-		});
+	if (configureCaches && cacheOptions.cdnCache === "workers-cache") {
+		const existingCdnSlot = getVinextCacheSlot(existingVinextCall, "cdn");
+		const existingCallee = existingCdnSlot?.value.type === "CallExpression" && existingCdnSlot.value.callee.type === "Identifier" ? existingCdnSlot.value.callee.name : void 0;
+		const adapterImports = [["@vinext/cloudflare/cache/workers-cache-cdn-adapter", "workersCacheCdnAdapter"], ["@vinext/cloudflare/cache/cdn-adapter", "cdnAdapter"]].map(([source, imported]) => ({
+			source,
+			imported,
+			local: commonJs ? findRequiredBinding(program, source, imported) : findImportedBinding(program, source, imported)
+		}));
+		const { source, imported, local: existing } = adapterImports.find(({ local }) => local && local === existingCallee) ?? adapterImports[0];
+		if (!existingCdnSlot || Boolean(existing && existingCallee === existing)) {
+			const local = existing ?? allocateBinding(bindings, imported);
+			const expression = `${commonJs ? ensureNamedRequire(program, output, source, imported, local) : ensureNamedImport(program, output, source, imported, local)}(${options.versionMetadataBinding && options.versionMetadataBinding !== DEFAULT_VERSION_METADATA_BINDING ? `{ versionMetadataBinding: ${JSON.stringify(options.versionMetadataBinding)} }` : ""})`;
+			if (existingCdnSlot) output.overwrite(existingCdnSlot.value.start, existingCdnSlot.value.end, expression);
+			else cacheAdditions.push({
+				name: "cdn",
+				expression
+			});
+		}
+	}
+	if (configureCaches && cacheOptions.cdnCache === "static-assets") {
+		const imported = "staticAssetsAdapter";
+		const source = "@vinext/cloudflare/cache/static-assets-adapter";
+		const existing = commonJs ? findRequiredBinding(program, source, imported) : findImportedBinding(program, source, imported);
+		const existingCdnSlot = getVinextCacheSlot(existingVinextCall, "cdn");
+		const existingUsesStaticAssets = Boolean(existing && existingCdnSlot?.value.type === "CallExpression" && existingCdnSlot.value.callee.type === "Identifier" && existingCdnSlot.value.callee.name === existing);
+		if (existingCdnSlot && !existingUsesStaticAssets) throw new Error("The existing vinext() CDN cache adapter does not match the selected Static Assets cache. Remove it before rerunning vinext init.");
+		if (!existingCdnSlot || existingUsesStaticAssets) {
+			const local = existing ?? allocateBinding(bindings, imported);
+			const expression = `${commonJs ? ensureNamedRequire(program, output, source, imported, local) : ensureNamedImport(program, output, source, imported, local)}(${options.assetsBinding && options.assetsBinding !== "ASSETS" ? `{ binding: ${JSON.stringify(options.assetsBinding)} }` : ""})`;
+			if (existingCdnSlot) output.overwrite(existingCdnSlot.value.start, existingCdnSlot.value.end, expression);
+			else cacheAdditions.push({
+				name: "cdn",
+				expression
+			});
+		}
 	}
 	let imageOptimizerExpression;
 	if (cacheOptions.imageOptimization === "cloudflare-images") {
@@ -866,37 +1500,44 @@ function updateViteConfigForCloudflare(filePath, code, options) {
 	const cloudflareLocal = (commonJs ? findRequiredBinding(program, "@cloudflare/vite-plugin", "cloudflare") : findImportedBinding(program, "@cloudflare/vite-plugin", "cloudflare")) ?? allocateBinding(bindings, "cloudflare");
 	const cloudflareBinding = commonJs ? ensureNamedRequire(program, output, "@cloudflare/vite-plugin", "cloudflare", cloudflareLocal) : ensureNamedImport(program, output, "@cloudflare/vite-plugin", "cloudflare", cloudflareLocal);
 	ensurePlugins(output, config, [{
-		expression: existingVinextCall ? `${vinextBinding}()` : options.cache || options.prerender ? vinextExpression(cacheOptions, vinextBinding, imageOptimizerExpression?.slice(0, imageOptimizerExpression.indexOf("(")) || "imagesOptimizer", options.imagesBinding, options.prerender) : `${vinextBinding}()`,
+		expression: existingVinextCall ? `${vinextBinding}()` : options.cache ? vinextExpression(cacheOptions, vinextBinding, imageOptimizerExpression?.slice(0, imageOptimizerExpression.indexOf("(")) || "imagesOptimizer", options.imagesBinding, options.versionMetadataBinding, responseStoreBinding, options.assetsBinding, options.assetsDirectory) : `${vinextBinding}()`,
 		binding: vinextBinding
 	}, {
 		expression: cloudflarePluginExpression(options.isAppRouter, cloudflareBinding),
 		binding: cloudflareBinding
 	}], code);
 	ensureCloudflareViteEnvironment(output, config, cloudflareBinding, options.isAppRouter, code);
-	if (existingVinextCall) if (existingVinextCall.arguments.length === 0 && (cacheAdditions.length > 0 || imageOptimizerExpression || needsPrerender)) {
-		const properties = [];
-		if (cacheAdditions.length > 0) properties.push(`cache: { ${cacheAdditions.map(({ name, expression }) => `${name}: ${expression}`).join(", ")} }`);
-		if (imageOptimizerExpression) properties.push(`images: { optimizer: ${imageOptimizerExpression} }`);
-		if (needsPrerender) properties.push(`prerender: { routes: "*" }`);
-		const plugins = findProperty(config, "plugins");
-		const closingIndent = `${plugins ? code.slice(0, plugins.start).split("\n").at(-1)?.match(/^\s*/)?.[0] ?? "" : ""}  `;
-		const propertyEntryIndent = `${closingIndent}  `;
-		output.appendLeft(existingVinextCall.end - 1, `{\n${propertyEntryIndent}${properties.join(`,\n${propertyEntryIndent}`)},\n${closingIndent}}`);
-	} else {
-		ensureVinextCache(output, config, vinextBinding, cacheAdditions, code);
-		ensureVinextImageOptimizer(output, config, vinextBinding, imageOptimizerExpression, code);
-		ensureVinextPrerender(output, config, vinextBinding, options.prerender, code);
+	if (existingVinextCall) {
+		if (existingVinextCall.arguments.length === 0 && (responseStoreExpression || cacheAdditions.length > 0 || imageOptimizerExpression || cacheOptions.cdnCache === "static-assets" || cacheOptions.prerender)) {
+			const properties = [];
+			if (responseStoreExpression) properties.push(`cache: ${responseStoreExpression}`);
+			else if (cacheAdditions.length > 0) properties.push(`cache: { ${cacheAdditions.map(({ name, expression }) => `${name}: ${expression}`).join(", ")} }`);
+			if (imageOptimizerExpression) properties.push(`images: { optimizer: ${imageOptimizerExpression} }`);
+			if (cacheOptions.cdnCache === "static-assets" || cacheOptions.prerender) properties.push("prerender: { routes: \"*\" }");
+			if (cacheOptions.cdnCache === "static-assets") {
+				if (options.assetsDirectory && path.normalize(options.assetsDirectory) !== path.normalize("dist/client")) properties.push(`clientOutDir: ${JSON.stringify(options.assetsDirectory)}`);
+			}
+			const plugins = findProperty(config, "plugins");
+			const closingIndent = `${plugins ? code.slice(0, plugins.start).split("\n").at(-1)?.match(/^\s*/)?.[0] ?? "" : ""}  `;
+			const propertyEntryIndent = `${closingIndent}  `;
+			output.appendLeft(existingVinextCall.end - 1, `{\n${propertyEntryIndent}${properties.join(`,\n${propertyEntryIndent}`)},\n${closingIndent}}`);
+		} else {
+			ensureVinextResponseStore(output, config, vinextBinding, responseStoreExpression, code);
+			ensureVinextCache(output, config, vinextBinding, cacheAdditions, code);
+			ensureVinextImageOptimizer(output, config, vinextBinding, imageOptimizerExpression, code);
+			if (cacheOptions.cdnCache === "static-assets" || cacheOptions.prerender) ensureVinextPrerenderOptions(output, config, vinextBinding, cacheOptions.cdnCache === "static-assets" ? options.assetsDirectory ?? "dist/client" : void 0, code);
+		}
 	}
 	if (options.nativeModulesToStub.length > 0) {
 		const pathLocal = (commonJs ? findRequiredBinding(program, "node:path", "default") : program.body.filter((statement) => statement.type === "ImportDeclaration").find((statement) => statement.source.value === "node:path")?.specifiers.find((specifier) => specifier.type === "ImportDefaultSpecifier")?.local.name) ?? allocateBinding(bindings, "path");
 		const pathBinding = commonJs ? ensureDefaultRequire(program, output, "node:path", pathLocal) : ensureDefaultImport(program, output, "node:path", pathLocal);
 		ensureNativeAliases(output, config, options.nativeModulesToStub, pathBinding, code);
 	}
-	return output.toString();
+	return formatInlineConfig(filePath, output.toString(), code);
 }
 function usesCommonJsViteConfig(filePath, code) {
 	if (/\.(?:cjs|cts)$/.test(filePath)) return true;
 	return parseViteConfig(filePath, code).body.some((statement) => statement.type === "ExpressionStatement" && statement.expression.type === "AssignmentExpression" && statement.expression.left.type === "MemberExpression" && statement.expression.left.object.type === "Identifier" && statement.expression.left.object.name === "module" && statement.expression.left.property.type === "Identifier" && statement.expression.left.property.name === "exports");
 }
 //#endregion
-export { generateAppRouterViteConfig, generatePagesRouterViteConfig, generateWranglerConfig, getWranglerImagesBinding, setupCloudflarePlatform, updateViteConfigForCloudflare, updateWranglerConfigForCloudflare, usesCommonJsViteConfig, validateCloudflarePlatformSetup };
+export { compactResourceName, cssModulesConfigSource, generateAppRouterViteConfig, generatePagesRouterViteConfig, generateResponseStoreWranglerConfig, generateWranglerConfig, getWranglerImagesBinding, getWranglerVersionMetadataBinding, setupCloudflarePlatform, updateViteConfigForCloudflare, updateViteConfigForCssModules, updateWranglerConfigForCloudflare, usesCommonJsViteConfig, validateCloudflarePlatformSetup };