@vinext/cloudflare 1.2.0 → 1.3.0

package/dist/deploy-help.js

@@ -16,6 +16,7 @@ function formatDeployHelp() {
     --env <name>             Cloudflare mode for typed config; Wrangler environment otherwise
     --name <name>            Custom Worker name for Wrangler config projects
     --config <path>          Wrangler config path (default: wrangler.jsonc/json/toml)
+    --vite-config <path>     Vite config file to build with (default: vite.config.*)
     --skip-build             Skip the build step (use existing dist/)
     --dry-run                Validate setup without building or deploying
     --verbose                Print raw output from internal Cloudflare CLI commands
@@ -129,9 +130,10 @@ function formatPreviewsDeployHelp() {
     preview-name    Optional Preview name (cf uses the CI or Git branch if omitted)
 
   Options:
-    --mode <mode>   Vite mode to build and deploy in (default: production)
-    --skip-build    Deploy existing Preview Build Output without rebuilding
-    -h, --help      Show this help
+    --mode <mode>          Vite mode to build and deploy in (default: production)
+    --skip-build           Deploy existing Preview Build Output without rebuilding
+    --vite-config <path>   Vite config file to build with (default: vite.config.*)
+    -h, --help             Show this help
 
   Examples:
     vinext-cloudflare previews deploy

package/dist/deploy.d.ts

@@ -23,6 +23,8 @@ export type DeployOptions = {
   name?: string;
   /** Wrangler config path, relative to root unless absolute */
   config?: string;
+  /** Vite config file used to build and read deploy metadata, relative to root unless absolute */
+  viteConfig?: string;
   /** Skip the build step (assume already built) */
   skipBuild?: boolean;
   /** Dry run — validate setup but don't build or deploy */
@@ -85,6 +87,7 @@ export declare function parseDeployArgs(args: string[]): {
   env: string | undefined;
   name: string | undefined;
   config: string | undefined;
+  viteConfig: string | undefined;
   skipBuild: boolean;
   dryRun: boolean;
   verbose: boolean;
@@ -192,4 +195,5 @@ export declare function resolveDeploymentControlPlaneOptions(options: Deployment
 export declare function resolveWorkerNameForVersionOverride(config: ParsedWranglerConfig | null, options: Pick<DeployOptions, "preview" | "env" | "name">): string | undefined;
 export declare function buildVersionOverrideHeaders(workerName: string | undefined, versionId: string): HeadersInit | undefined;
 export declare function deploy(options: DeployOptions): Promise<void>;
-//#endregion
+//#endregion
+export {};

package/dist/deploy.js

@@ -99,6 +99,7 @@ const deployArgOptions = {
 	env: { type: "string" },
 	name: { type: "string" },
 	config: { type: "string" },
+	"vite-config": { type: "string" },
 	"skip-build": {
 		type: "boolean",
 		default: false
@@ -249,6 +250,7 @@ function parseDeployArgs(args) {
 		env: values.env?.trim() || void 0,
 		name: values.name?.trim() || void 0,
 		config: values.config?.trim() || void 0,
+		viteConfig: values["vite-config"]?.trim() || void 0,
 		skipBuild: values["skip-build"],
 		dryRun: values["dry-run"],
 		verbose: values.verbose,
@@ -339,11 +341,11 @@ async function loadProjectWranglerApi(root) {
 function resolveViteBuildMode(deploymentTool, env) {
 	return deploymentTool === "cf" ? env ?? "production" : "production";
 }
-async function loadDeployViteConfigMetadata(root, mode) {
+async function loadDeployViteConfigMetadata(root, mode, configFile) {
 	const plugins = (await (await loadProjectViteApi(root)).loadConfigFromFile({
 		command: "build",
 		mode
-	}, void 0, root))?.config.plugins;
+	}, configFile, root))?.config.plugins;
 	return {
 		cacheConfig: await findVinextCacheConfigInPlugins(plugins),
 		nextConfig: await findVinextNextConfigInPlugins(plugins),
@@ -351,7 +353,7 @@ async function loadDeployViteConfigMetadata(root, mode) {
 		routeRootConfig: await findVinextRouteRootConfigInPlugins(plugins)
 	};
 }
-async function runBuild(info, env, mode) {
+async function runBuild(info, env, mode, configFile) {
 	console.log("\n  Building for Cloudflare Workers...\n");
 	const { createBuilder } = await loadProjectViteApi(info.root);
 	let completed = false;
@@ -362,6 +364,7 @@ async function runBuild(info, env, mode) {
 		await (await createBuilder({
 			root: info.root,
 			mode,
+			configFile,
 			[VINEXT_BUILD_LIFECYCLE_CONFIG]: invocation
 		})).buildApp();
 	});
@@ -1190,7 +1193,9 @@ async function deploy(options) {
 	if (isPreview && deploymentTool !== "cf") throw new Error("Worker Previews require a cloudflare.config.ts project and the cf CLI.");
 	if (deploymentTool === "cf" && options.name) throw new Error("--name is not supported for cloudflare.config.ts projects. Set `name` in cloudflare.config.ts instead.");
 	const viteMode = resolveViteBuildMode(deploymentTool, deployEnv);
+	const viteConfigFile = options.viteConfig ? path.resolve(root, options.viteConfig) : void 0;
 	const wranglerFallbackEnv = deploymentTool === "cf" ? void 0 : deployEnv;
+	if (!process.env.NODE_ENV) Reflect.set(process.env, "NODE_ENV", "production");
 	loadDotenv({
 		root,
 		mode: viteMode
@@ -1209,16 +1214,25 @@ async function deploy(options) {
 	console.log(`  Project: ${info.projectName}`);
 	console.log(`  Router:  ${info.isAppRouter ? "App Router" : "Pages Router"}`);
 	console.log(`  ISR:     ${info.hasISR ? "detected" : "none"}`);
-	const missingScaffolding = [!info.hasViteConfig && "Vite config", !info.hasWranglerConfig && "Wrangler config"].filter((value) => Boolean(value));
+	if (viteConfigFile && !fs.existsSync(viteConfigFile)) throw new Error(`Vite config file not found: ${viteConfigFile}`);
+	const hasViteConfig = Boolean(viteConfigFile) || info.hasViteConfig;
+	const missingScaffolding = [!hasViteConfig && "Vite config", !info.hasWranglerConfig && "Wrangler config"].filter((value) => Boolean(value));
 	if (missingScaffolding.length > 0) throw new Error(`Missing Cloudflare deployment setup: ${missingScaffolding.join(", ")}. Run \`vinext init --platform=cloudflare\` first.`);
 	const missingDeps = getMissingDeps(info);
 	if (missingDeps.length > 0) throw new Error(`Missing deployment dependencies: ${missingDeps.map((dependency) => dependency.name).join(", ")}. Run \`vinext init --platform=cloudflare\` first.`);
 	if (deploymentTool === "cf" && !isCfCliInstalled(root)) throw new Error("Missing deployment dependencies: cf. Run `vinext init --platform=cloudflare` first.");
-	if (info.hasViteConfig && !viteConfigHasCloudflarePlugin(root)) throw new Error(formatMissingCloudflarePluginError({ isAppRouter: info.isAppRouter }));
-	if (info.hasISR && !viteConfigHasCacheAdapter(root) && !workerEntryHasCacheHandler(root)) throw new Error(formatMissingCacheAdapterError({ typedConfig: deploymentTool === "cf" }));
-	if (!viteConfigHasImageAdapter(root)) {
+	if (hasViteConfig && !viteConfigHasCloudflarePlugin(root, viteConfigFile)) throw new Error(formatMissingCloudflarePluginError({
+		isAppRouter: info.isAppRouter,
+		configFile: viteConfigFile,
+		initUpdatesConfig: !viteConfigFile
+	}));
+	if (info.hasISR && !viteConfigHasCacheAdapter(root, viteConfigFile) && !workerEntryHasCacheHandler(root)) throw new Error(formatMissingCacheAdapterError({
+		configFile: viteConfigFile,
+		typedConfig: deploymentTool === "cf"
+	}));
+	if (!viteConfigHasImageAdapter(root, viteConfigFile)) {
 		console.log();
-		console.log(formatImageOptimizationHint(deploymentTool === "cf"));
+		console.log(formatImageOptimizationHint(deploymentTool === "cf", viteConfigFile));
 	}
 	if (options.dryRun) {
 		console.log("\n  Dry run complete. No build or deploy performed.\n");
@@ -1232,7 +1246,7 @@ async function deploy(options) {
 		}));
 		return;
 	}
-	const viteConfigMetadata = await withBuildContext(() => loadDeployViteConfigMetadata(info.root, viteMode));
+	const viteConfigMetadata = await withBuildContext(() => loadDeployViteConfigMetadata(info.root, viteMode, viteConfigFile));
 	const cdnAdapterConfig = resolveCdnAdapterConfig(viteConfigMetadata.cacheConfig);
 	const nextConfig = await withBuildContext(async () => {
 		const inlineNextConfig = viteConfigMetadata.nextConfig;
@@ -1258,7 +1272,7 @@ async function deploy(options) {
 		const replacement = isPreview ? "Preview deployments render these routes on request." : options.warmCdnCache ? "Routes will be rendered and warmed through the staged Worker instead." : "Use --warm-cache to render and warm routes through the deployed Worker instead.";
 		console.warn(`\n  Warning: ${trigger} is ignored by Cloudflare deploy. ${replacement}`);
 	}
-	if (!options.skipBuild) await withBuildContext(() => runBuild(info, cloudflareEnv, viteMode));
+	if (!options.skipBuild) await withBuildContext(() => runBuild(info, cloudflareEnv, viteMode, viteConfigFile));
 	else console.log("\n  Skipping build (--skip-build)");
 	const prerenderOutputDirs = resolvePrerenderOutputDirs(info.root, deploymentTool, viteConfigMetadata.routeRootConfig);
 	const canWarmTpr = options.experimentalTPR && !shouldPrerenderLocally && hasBuildIdentityHeader;

package/dist/previews-deploy.d.ts

@@ -5,5 +5,6 @@ export declare function parsePreviewsDeployArgs(args: string[]): {
   name: string | undefined;
   mode: string | undefined;
   skipBuild: boolean;
+  viteConfig: string | undefined;
 };
 //#endregion

package/dist/previews-deploy.js

@@ -28,7 +28,8 @@ function parsePreviewsDeployArgs(args) {
 			"skip-build": {
 				type: "boolean",
 				default: false
-			}
+			},
+			"vite-config": { type: "string" }
 		}
 	});
 	if (positionals.length > 1) throw new Error("Expected at most one Preview name: previews deploy [preview-name].");
@@ -36,7 +37,8 @@ function parsePreviewsDeployArgs(args) {
 		help: values.help,
 		name: positionals[0] === void 0 ? void 0 : validatePreviewName(positionals[0]),
 		mode: values.mode === void 0 ? void 0 : validateMode(values.mode),
-		skipBuild: values["skip-build"]
+		skipBuild: values["skip-build"],
+		viteConfig: values["vite-config"]?.trim() || void 0
 	};
 }
 //#endregion

package/dist/utils/cache-control-metadata.d.ts

@@ -6,5 +6,10 @@
  * helpers in the vinext core).
  */
 export declare function isUnknownRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * When a `"use cache"` entry's generation started (`ctx.timestamp`), which dates
+ * the entry like Next.js does. Absent, malformed or future values fall back to `now`.
+ */
+export declare function readCacheTimestamp(ctx: Record<string, unknown> | undefined, now: number): number;
 export declare function readCacheControlNumberField(ctx: Record<string, unknown> | undefined, field: string): number | undefined;
 //#endregion

package/dist/utils/cache-control-metadata.js

@@ -12,9 +12,17 @@ function readRecordField(ctx, field) {
 	const value = ctx?.[field];
 	return isUnknownRecord(value) ? value : void 0;
 }
+/**
+* When a `"use cache"` entry's generation started (`ctx.timestamp`), which dates
+* the entry like Next.js does. Absent, malformed or future values fall back to `now`.
+*/
+function readCacheTimestamp(ctx, now) {
+	const value = ctx?.timestamp;
+	return typeof value === "number" && Number.isFinite(value) && value > 0 && value <= now ? value : now;
+}
 function readCacheControlNumberField(ctx, field) {
 	const value = readRecordField(ctx, "cacheControl")?.[field] ?? ctx?.[field];
 	return typeof value === "number" ? value : void 0;
 }
 //#endregion
-export { isUnknownRecord, readCacheControlNumberField };
+export { isUnknownRecord, readCacheControlNumberField, readCacheTimestamp };

package/dist/version-headers.js

@@ -1,2 +1 @@
-import { VINEXT_EXPECTED_WORKER_VERSION_HEADER } from "vinext/internal/server/headers";
-export { VINEXT_EXPECTED_WORKER_VERSION_HEADER };
+export { VINEXT_EXPECTED_WORKER_VERSION_HEADER } from "vinext/internal/server/headers";

package/dist/wrangler-config.d.ts

@@ -16,4 +16,5 @@ type WranglerEnvironmentConfig = {
  * Parse the Wrangler fields used by TPR and staged CDN warming.
  */
 export declare function parseWranglerConfig(root: string, configPath?: string): WranglerConfig | null;
-//#endregion
+//#endregion
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vinext/cloudflare",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Cloudflare cache and image adapters for vinext.",
   "homepage": "https://vinext.dev/",
   "license": "MIT",
@@ -48,21 +48,20 @@
     }
   },
   "dependencies": {
-    "@cloudflare/workers-response-store": "1.1.2"
+    "@cloudflare/workers-response-store": "1.1.4"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",
     "cf": "1.0.0-beta.1",
     "miniflare": "5.20260730.0-alpha",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
-    "vite-plus": "1.1.0",
-    "vitest": "5.0.3",
-    "vinext": "1.3.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0",
+    "vite-plus": "1.3.0",
+    "vinext": "1.4.0"
   },
   "peerDependencies": {
     "@cloudflare/vite-plugin": "*",
     "cf": "*",
-    "vinext": "^1.3.0"
+    "vinext": "^1.4.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/vite-plugin": {
@@ -78,6 +77,6 @@
   "scripts": {
     "build": "vp pack",
     "dev": "vp pack --watch",
-    "test": "vp run vinext#build && vp run @cloudflare/workers-response-store#build && vp run @vinext/cloudflare#build && VINEXT_RESPONSE_STORE_MODE=self-contained VINEXT_RESPONSE_STORE_LOCATION_HINT=weur pnpm --filter response-store-demo run build && VINEXT_RESPONSE_STORE_LOCATION_HINT=wnam pnpm --filter response-store-demo run build && vitest run"
+    "test": "vp run vinext#build && vp run @cloudflare/workers-response-store#build && vp run @vinext/cloudflare#build && VINEXT_RESPONSE_STORE_MODE=self-contained VINEXT_RESPONSE_STORE_LOCATION_HINT=weur pnpm --filter response-store-demo run build && VINEXT_RESPONSE_STORE_LOCATION_HINT=wnam pnpm --filter response-store-demo run build && vp test run"
   }
 }