@vinext/cloudflare 1.1.1 → 1.2.0

package/dist/cache/cdn-adapter.runtime.js

@@ -132,6 +132,7 @@ function toEdgeCacheControl(cacheControl) {
 */
 const MAX_CACHE_TAG_BYTES = 16384;
 const CACHE_TAG_PREFIX = "vinext-";
+const MAX_TAGS_PER_PURGE = 100;
 /** Encode a case-sensitive Next.js tag into a fixed Workers Cache tag. */
 function encodeCloudflareCacheTag(tag) {
 	return `${CACHE_TAG_PREFIX}${fnv1a64(`0:${tag}`)}${fnv1a64(`1:${tag}`)}`;
@@ -222,11 +223,16 @@ var CloudflareCdnCacheAdapter = class {
 		if (!cache) return;
 		const tagList = (Array.isArray(tags) ? tags : [tags]).filter((t) => typeof t === "string");
 		if (tagList.length === 0) return;
-		const options = { tags: tagList.map(encodeCloudflareCacheTag) };
+		const encodedTags = [...new Set(tagList.map(encodeCloudflareCacheTag))];
 		const operation = isStaleTagInvalidation(durations) ? "invalidate" : "purge";
-		const result = await (operation === "invalidate" ? invalidateOrPurge(cache, options) : cache.purge(options));
-		if (result?.success === false) {
-			const errors = result.errors.map(({ code, message }) => `${code}: ${message}`).join(", ");
+		const chunks = [];
+		for (let i = 0; i < encodedTags.length; i += MAX_TAGS_PER_PURGE) chunks.push(encodedTags.slice(i, i + MAX_TAGS_PER_PURGE));
+		const settled = await Promise.allSettled(chunks.map(async (chunk) => await (operation === "invalidate" ? invalidateOrPurge(cache, { tags: chunk }) : cache.purge({ tags: chunk }))));
+		const rejection = settled.find((result) => result.status === "rejected");
+		if (rejection) throw rejection.reason;
+		const failures = settled.flatMap((result) => result.status === "fulfilled" && result.value?.success === false ? [result.value] : []);
+		if (failures.length > 0) {
+			const errors = failures.flatMap((result) => result.errors).map(({ code, message }) => `${code}: ${message}`).join(", ");
 			throw new Error(`[vinext] Workers Cache ${operation} failed${errors ? `: ${errors}` : ""}`);
 		}
 	}

package/dist/cache/cdn-adapter.worker.js

@@ -132,7 +132,8 @@ async function createCacheFacingRequest(request, serializedInvocation) {
 	return new Request(url, {
 		cf: { vary: { default: { action: "passthrough" } } },
 		headers,
-		method: request.method
+		method: request.method,
+		redirect: "manual"
 	});
 }
 function restoreResponseStageRequest(request, requestUrl, requestMethod) {

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { deploy, parseDeployArgs } from "./deploy.js";
-import { printDeployHelp } from "./deploy-help.js";
+import { printDeployHelp, printPreviewsDeployHelp } from "./deploy-help.js";
+import { parsePreviewsDeployArgs } from "./previews-deploy.js";
 import fs from "node:fs";
 //#region src/cli.ts
 const VERSION = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf-8")).version;
@@ -11,6 +12,10 @@ function printHelp(commandName) {
 		printDeployHelp();
 		return;
 	}
+	if (commandName === "previews") {
+		printPreviewsDeployHelp();
+		return;
+	}
 	console.log(`
   vinext-cloudflare v${VERSION}
 
@@ -21,7 +26,8 @@ function printHelp(commandName) {
     vp exec vinext-cloudflare <command>    Run the locally installed bin
 
   Commands:
-    deploy   Deploy to Cloudflare Workers
+    deploy                          Deploy to Cloudflare Workers
+    previews deploy [preview-name]  Deploy a Cloudflare Worker Preview
 
   Options:
     -h, --help     Show this help
@@ -68,6 +74,30 @@ async function deployCommand() {
 		tprWindow: parsed.tprWindow
 	});
 }
+async function previewsCommand() {
+	const subcommand = rawArgs[0];
+	if (subcommand !== "deploy") {
+		if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+			printHelp("previews");
+			return;
+		}
+		throw new Error(`Unknown previews command: ${subcommand}`);
+	}
+	const options = parsePreviewsDeployArgs(rawArgs.slice(1));
+	if (options.help) {
+		printHelp("previews");
+		return;
+	}
+	await deploy({
+		root: process.cwd(),
+		env: options.mode,
+		skipBuild: options.skipBuild,
+		target: {
+			type: "preview",
+			name: options.name
+		}
+	});
+}
 if (command === "--version" || command === "-v") {
 	console.log(`vinext-cloudflare v${VERSION}`);
 	process.exit(0);
@@ -83,6 +113,12 @@ switch (command) {
 			process.exit(1);
 		});
 		break;
+	case "previews":
+		previewsCommand().catch((error) => {
+			console.error(error instanceof Error ? error.message : String(error));
+			process.exit(1);
+		});
+		break;
 	default:
 		console.error(`Unknown command: ${command}`);
 		printHelp();

package/dist/deploy-help.d.ts

@@ -1,4 +1,6 @@
 //#region src/deploy-help.d.ts
 export declare function formatDeployHelp(): string;
 export declare function printDeployHelp(): void;
+export declare function formatPreviewsDeployHelp(): string;
+export declare function printPreviewsDeployHelp(): void;
 //#endregion

package/dist/deploy-help.js

@@ -87,11 +87,14 @@ function formatDeployHelp() {
   be reused outside the data center reached by the warmup request after cache
   propagation, but the deploy does not wait for every edge location to fill.
 
+  --preview is an alias for --env preview. It selects a mode/environment,
+  not a Preview deployment. Use previews deploy to deploy a Worker Preview.
+
   Examples:
     npx @vinext/cloudflare deploy                                      Build and deploy to production
     vpx @vinext/cloudflare deploy                                      Build and deploy with Vite+
     vp exec vinext-cloudflare deploy                                   Run the locally installed Vite+ bin
-    vinext-cloudflare deploy --preview                                 Deploy to a preview URL
+    vinext-cloudflare deploy --preview                                 Deploy using mode/environment preview
     vinext-cloudflare deploy --env staging                             Deploy using Cloudflare mode/environment staging
     vinext-cloudflare deploy --config dist/server/wrangler.json        Deploy using a generated Wrangler config
     vinext-cloudflare deploy --dry-run                                 Validate setup without building or deploying
@@ -113,5 +116,32 @@ function formatDeployHelp() {
 function printDeployHelp() {
 	console.log(formatDeployHelp());
 }
+function formatPreviewsDeployHelp() {
+	return `
+  vinext-cloudflare previews deploy - Deploy a Cloudflare Worker Preview
+
+  Usage: vinext-cloudflare previews deploy [preview-name] [options]
+
+  Builds the app with isPreview=true, then deploys its Preview Build Output
+  using cf previews deploy. Requires cloudflare.config.ts and the cf CLI.
+
+  Arguments:
+    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
+
+  Examples:
+    vinext-cloudflare previews deploy
+    vinext-cloudflare previews deploy pr-123
+    vinext-cloudflare previews deploy pr-123 --mode staging
+    vinext-cloudflare previews deploy pr-123 --skip-build
+`;
+}
+function printPreviewsDeployHelp() {
+	console.log(formatPreviewsDeployHelp());
+}
 //#endregion
-export { formatDeployHelp, printDeployHelp };
+export { formatDeployHelp, formatPreviewsDeployHelp, printDeployHelp, printPreviewsDeployHelp };

package/dist/deploy.d.ts

@@ -12,6 +12,11 @@ export type DeployOptions = {
   root: string;
   /** Deploy to preview environment (default: production) */
   preview?: boolean;
+  /** Deploy to Preview deployment, supported only by cf. */
+  target?: {
+    type: "preview";
+    name?: string;
+  };
   /** Wrangler environment name from wrangler.jsonc env.<name> */
   env?: string;
   /** Custom project name for the Worker */
@@ -120,6 +125,8 @@ export declare function parseDeployArgs(args: string[]): {
  * Passing `undefined` is a no-op; the callback runs with `process.env` untouched.
  */
 export declare function withCloudflareEnv<T>(env: string | undefined, fn: () => Promise<T>): Promise<T>;
+/** Cloudflare Vite Plugin reads this flag when evaluating the typed config and emitting Build Output. */
+export declare function withCloudflarePreviewBuild<T>(fn: () => Promise<T>): Promise<T>;
 export declare function resolveViteBuildMode(deploymentTool: DeploymentTool, env: string | undefined): string;
 type WranglerDeployArgs = {
   args: string[];
@@ -133,7 +140,7 @@ export declare function validateWranglerEnvName(env: string): string;
 export declare function buildWranglerDeployArgs(options: Pick<DeployOptions, "preview" | "env" | "name" | "config">): WranglerDeployArgs;
 export declare function resolveDeploymentTool(root: string): DeploymentTool;
 export declare function isCfCliInstalled(root: string, resolvePackageJson?: (root: string) => string | null): boolean;
-export declare function buildCfDeployArgs(options: Pick<DeployOptions, "preview" | "env">): CfDeployArgs;
+export declare function buildCfDeployArgs(options: Pick<DeployOptions, "preview" | "env" | "target">): CfDeployArgs;
 /**
  * Resolve Wrangler's JavaScript CLI entrypoint in node_modules.
  *
@@ -154,7 +161,7 @@ export declare function buildWranglerInvocation(root: string, options: Pick<Depl
 export declare function runWranglerDeploy(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose"> & {
   promote?: boolean;
 }, execute?: typeof spawn): Promise<string>;
-export declare function runCfDeploy(root: string, options: Pick<DeployOptions, "preview" | "env">, execute?: typeof spawn): Promise<string>;
+export declare function runCfDeploy(root: string, options: Pick<DeployOptions, "preview" | "env" | "target">, execute?: typeof spawn): Promise<string>;
 export declare function hasCdnWarmRequests(plan: Omit<CdnWarmRequestPlan, "pagesDataPaths"> & {
   pagesDataPaths?: readonly string[];
 }): boolean;

package/dist/deploy.js

@@ -16,7 +16,7 @@ import { setTimeout } from "node:timers/promises";
 import { DEFAULT_REMOTE_PATH_DISCOVERY_PHASE_TIMEOUT_MS, DEFAULT_REMOTE_PATH_DISCOVERY_RETRY_DELAY_MS, discoverPrerenderPathManifest, emitPrerenderPathManifest } from "vinext/internal/build/prerender-paths";
 import { normalizePathTrailingSlash } from "vinext/shims/url-utils";
 import { spawn } from "node:child_process";
-import { parseArgs } from "node:util";
+import { parseArgs, stripVTControlCharacters } from "node:util";
 import { pathToFileURL } from "node:url";
 import { VINEXT_BUILD_LIFECYCLE_CONFIG } from "vinext/internal/build/lifecycle";
 import { runPrerender } from "vinext/internal/build/run-prerender";
@@ -301,6 +301,18 @@ async function withCloudflareEnv(env, fn) {
 		else delete process.env.CLOUDFLARE_ENV;
 	}
 }
+/** Cloudflare Vite Plugin reads this flag when evaluating the typed config and emitting Build Output. */
+async function withCloudflarePreviewBuild(fn) {
+	const hadPrevious = "CLOUDFLARE_PREVIEW_BUILD" in process.env;
+	const previous = process.env.CLOUDFLARE_PREVIEW_BUILD;
+	process.env.CLOUDFLARE_PREVIEW_BUILD = "true";
+	try {
+		return await fn();
+	} finally {
+		if (hadPrevious) process.env.CLOUDFLARE_PREVIEW_BUILD = previous;
+		else delete process.env.CLOUDFLARE_PREVIEW_BUILD;
+	}
+}
 async function loadProjectViteApi(root) {
 	let vitePath;
 	try {
@@ -384,7 +396,10 @@ function isCfCliInstalled(root, resolvePackageJson = (projectRoot) => {
 }
 function buildCfDeployArgs(options) {
 	const mode = options.env || (options.preview ? "preview" : void 0);
-	const args = ["deploy", "--prebuilt"];
+	const isPreviewDeploy = options.target?.type === "preview";
+	const args = isPreviewDeploy ? ["previews", "deploy"] : ["deploy"];
+	if (isPreviewDeploy && options.target?.name) args.push(options.target.name);
+	args.push("--prebuilt");
 	if (mode) args.push("--mode", validateWranglerEnvName(mode));
 	return {
 		args,
@@ -482,7 +497,8 @@ async function runWranglerDeploy(root, options, execute = spawn) {
 }
 async function runCfDeploy(root, options, execute = spawn) {
 	const { args, mode } = buildCfDeployArgs(options);
-	console.log(mode ? `\n  Deploying Build Output in mode: ${mode}...` : "\n  Deploying Build Output...");
+	const isPreview = options.target?.type === "preview";
+	console.log(mode ? `\n  Deploying ${isPreview ? "Preview " : ""}Build Output in mode: ${mode}...` : "\n  Deploying Build Output...");
 	const child = execute(process.execPath, [resolveCfBin(root), ...args], {
 		cwd: root,
 		stdio: [
@@ -493,9 +509,11 @@ async function runCfDeploy(root, options, execute = spawn) {
 		shell: false
 	});
 	let output = "";
+	let stdout = "";
 	child.stdout?.on("data", (chunk) => {
 		const text = chunk.toString();
 		output += text;
+		stdout += text;
 		process.stdout.write(text);
 	});
 	child.stderr?.on("data", (chunk) => {
@@ -507,11 +525,27 @@ async function runCfDeploy(root, options, execute = spawn) {
 		child.once("error", reject);
 		child.once("close", (code, signal) => {
 			if (code === 0) resolve();
-			else reject(/* @__PURE__ */ new Error(`cf deploy failed with ${signal ? `signal ${signal}` : `exit code ${code ?? "unknown"}`}.`));
+			else reject(/* @__PURE__ */ new Error(`cf ${isPreview ? "previews deploy" : "deploy"} failed with ${signal ? `signal ${signal}` : `exit code ${code ?? "unknown"}`}.`));
 		});
 	});
+	if (isPreview) return parseCfPreviewUrl(stdout) ?? parseWorkerDeploymentUrl(output) ?? "(Preview URL not detected in cf output)";
 	return parseWorkerDeploymentUrl(output) ?? "(URL not detected in cf output)";
 }
+/** `cf previews deploy` prints a JSON result; prefer the named Preview URL over the deployment URL. */
+function parseCfPreviewUrl(stdout) {
+	const text = stripVTControlCharacters(stdout);
+	const start = text.indexOf("{");
+	const end = text.lastIndexOf("}");
+	if (start === -1 || end < start) return null;
+	let result;
+	try {
+		result = JSON.parse(text.slice(start, end + 1));
+	} catch {
+		return null;
+	}
+	for (const urls of [result.preview_urls, result.deployment_urls]) if (Array.isArray(urls) && typeof urls[0] === "string") return urls[0];
+	return null;
+}
 function hasCdnWarmRequests(plan) {
 	return plan.paths.length + (plan.pagesDataPaths?.length ?? 0) + (plan.routeHandlerPaths?.length ?? 0) + plan.rscPaths.length + plan.loadingShellPaths.length > 0;
 }
@@ -1130,13 +1164,30 @@ function withPromotedVersionWarmupNote(error) {
 	const message = error instanceof Error ? error.message : String(error);
 	return new Error(`${message} The uploaded version is already promoted to 100% and its Worker triggers/routes were updated; rerun deploy to retry cache warming or create a deployment for the previous version.`, { cause: error });
 }
+/** Worker Previews skip production-only steps, so reject options that would otherwise be ignored. */
+function assertPreviewDeployOptions(options) {
+	const unsupported = Object.entries({
+		preview: options.preview,
+		name: options.name !== void 0,
+		config: options.config !== void 0,
+		warmCdnCache: options.warmCdnCache,
+		warmCdnTarget: options.warmCdnTarget !== void 0,
+		warmCdnCertify: options.warmCdnCertify,
+		warmCdnPromote: options.warmCdnPromote === false,
+		experimentalTPR: options.experimentalTPR
+	}).filter(([, isSet]) => isSet).map(([option]) => option);
+	if (unsupported.length > 0) throw new Error(`Worker Preview deployments do not support: ${unsupported.join(", ")}.`);
+}
 async function deploy(options) {
+	const isPreview = options.target?.type === "preview";
+	if (isPreview) assertPreviewDeployOptions(options);
 	if (options.warmCdnTarget !== void 0 && !options.warmCdnCache && !options.experimentalTPR) throw new Error("--warm-cache-target requires --warm-cache or --traffic-aware-warm-cache.");
 	const warmCdnTarget = options.warmCdnTarget === void 0 ? void 0 : validateCdnWarmTarget(options.warmCdnTarget);
 	const deployEnv = options.env || (options.preview ? "preview" : void 0);
 	if (deployEnv) validateWranglerEnvName(deployEnv);
 	const root = path.resolve(options.root);
 	const deploymentTool = resolveDeploymentTool(root);
+	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 wranglerFallbackEnv = deploymentTool === "cf" ? void 0 : deployEnv;
@@ -1144,7 +1195,9 @@ async function deploy(options) {
 		root,
 		mode: viteMode
 	});
-	console.log("\n  vinext-cloudflare deploy\n");
+	const cloudflareEnv = isPreview ? void 0 : deployEnv;
+	const withBuildContext = (fn) => withCloudflareEnv(cloudflareEnv, () => isPreview ? withCloudflarePreviewBuild(fn) : fn());
+	console.log(isPreview ? "\n  vinext-cloudflare previews deploy\n" : "\n  vinext-cloudflare deploy\n");
 	const info = detectProject(root);
 	if (!info.isAppRouter && !info.isPagesRouter) {
 		console.error("  Error: No app/ or pages/ directory found.");
@@ -1171,9 +1224,17 @@ async function deploy(options) {
 		console.log("\n  Dry run complete. No build or deploy performed.\n");
 		return;
 	}
-	const viteConfigMetadata = await withCloudflareEnv(deployEnv, () => loadDeployViteConfigMetadata(info.root, viteMode));
+	if (isPreview && options.skipBuild) {
+		console.log("\n  Skipping build (--skip-build)");
+		printDeployUrl("Preview URL", await runCfDeploy(root, {
+			env: viteMode,
+			target: options.target
+		}));
+		return;
+	}
+	const viteConfigMetadata = await withBuildContext(() => loadDeployViteConfigMetadata(info.root, viteMode));
 	const cdnAdapterConfig = resolveCdnAdapterConfig(viteConfigMetadata.cacheConfig);
-	const nextConfig = await withCloudflareEnv(deployEnv, async () => {
+	const nextConfig = await withBuildContext(async () => {
 		const inlineNextConfig = viteConfigMetadata.nextConfig;
 		const rawNextConfig = inlineNextConfig ? await resolveNextConfigInput(inlineNextConfig, PHASE_PRODUCTION_BUILD) : await loadNextConfig(info.root, PHASE_PRODUCTION_BUILD);
 		return resolveNextConfig(rawNextConfig, info.root);
@@ -1194,10 +1255,10 @@ async function deploy(options) {
 	const shouldEmitPrerenderPathManifest = !options.skipBuild && shouldPrerenderLocally;
 	if (prerenderDecision && !shouldPrerenderLocally) {
 		const trigger = prerenderDecision.reason === "flag" ? "--prerender-all" : "vinext prerender config";
-		const replacement = 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.";
+		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 runBuild(info, deployEnv, viteMode);
+	if (!options.skipBuild) await withBuildContext(() => runBuild(info, cloudflareEnv, viteMode));
 	else console.log("\n  Skipping build (--skip-build)");
 	const prerenderOutputDirs = resolvePrerenderOutputDirs(info.root, deploymentTool, viteConfigMetadata.routeRootConfig);
 	const canWarmTpr = options.experimentalTPR && !shouldPrerenderLocally && hasBuildIdentityHeader;
@@ -1355,15 +1416,21 @@ async function deploy(options) {
 	}
 	if (url === void 0) {
 		if (deploymentTool === "cf" && options.warmCdnPromote === false) url = runCfVersionUpload(root, wranglerOptions).previewUrl ?? "(Preview URL not detected in cf output)";
-		else if (deploymentTool === "cf") url = await runCfDeploy(root, wranglerOptions);
+		else if (deploymentTool === "cf") url = await runCfDeploy(root, {
+			...wranglerOptions,
+			target: options.target
+		});
 		else url = await runWranglerDeploy(root, {
 			...wranglerOptions,
 			promote: options.warmCdnPromote
 		});
 	}
+	printDeployUrl(isPreview ? "Preview URL" : options.warmCdnPromote === false ? "Version URL" : "Deployed to", url);
+}
+function printDeployUrl(label, url) {
 	console.log("\n  ─────────────────────────────────────────");
-	console.log(`  ${options.warmCdnPromote === false ? "Version URL" : "Deployed to"}: ${url}`);
+	console.log(`  ${label}: ${url}`);
 	console.log("  ─────────────────────────────────────────\n");
 }
 //#endregion
-export { DEFAULT_CDN_WARM_PROMOTION_DELAY_MS, buildCfDeployArgs, buildNodeCliInvocation, buildVersionOverrideHeaders, buildWranglerDeployArgs, buildWranglerInvocation, deploy, deployWithCdnWarmup, getZeroPercentStagingTraffic, hasCdnWarmRequests, isCfCliInstalled, parseDeployArgs, projectRequiresRouteCacheabilityProbeManifest, resolveCdnWarmupTargetUrl, resolveCfBin, resolveDeploymentControlPlaneOptions, resolveDeploymentTool, resolvePrerenderOutputDirs, resolveViteBuildMode, resolveWorkerNameForVersionOverride, resolveWranglerBin, runCfDeploy, runWranglerDeploy, selectTPRWarmPlan, validateWranglerEnvName, withCloudflareEnv };
+export { DEFAULT_CDN_WARM_PROMOTION_DELAY_MS, buildCfDeployArgs, buildNodeCliInvocation, buildVersionOverrideHeaders, buildWranglerDeployArgs, buildWranglerInvocation, deploy, deployWithCdnWarmup, getZeroPercentStagingTraffic, hasCdnWarmRequests, isCfCliInstalled, parseDeployArgs, projectRequiresRouteCacheabilityProbeManifest, resolveCdnWarmupTargetUrl, resolveCfBin, resolveDeploymentControlPlaneOptions, resolveDeploymentTool, resolvePrerenderOutputDirs, resolveViteBuildMode, resolveWorkerNameForVersionOverride, resolveWranglerBin, runCfDeploy, runWranglerDeploy, selectTPRWarmPlan, validateWranglerEnvName, withCloudflareEnv, withCloudflarePreviewBuild };

package/dist/previews-deploy.d.ts

@@ -0,0 +1,9 @@
+//#region src/previews-deploy.d.ts
+/** CLI options for `vinext-cloudflare previews deploy`. */
+export declare function parsePreviewsDeployArgs(args: string[]): {
+  help: boolean;
+  name: string | undefined;
+  mode: string | undefined;
+  skipBuild: boolean;
+};
+//#endregion

package/dist/previews-deploy.js

@@ -0,0 +1,43 @@
+import { parseArgs } from "node:util";
+//#region src/previews-deploy.ts
+function validatePreviewName(name) {
+	const trimmed = name.trim();
+	if (!trimmed) throw new Error("Preview name must not be empty.");
+	if (trimmed.includes("\0")) throw new Error("Preview names cannot contain null bytes.");
+	if (trimmed.startsWith("-")) throw new Error("Preview name must not start with '-'.");
+	return trimmed;
+}
+function validateMode(mode) {
+	const trimmed = mode.trim();
+	if (!trimmed) throw new Error("--mode requires a non-empty value.");
+	return trimmed;
+}
+/** CLI options for `vinext-cloudflare previews deploy`. */
+function parsePreviewsDeployArgs(args) {
+	const { values, positionals } = parseArgs({
+		args,
+		allowPositionals: true,
+		strict: true,
+		options: {
+			help: {
+				type: "boolean",
+				short: "h",
+				default: false
+			},
+			mode: { type: "string" },
+			"skip-build": {
+				type: "boolean",
+				default: false
+			}
+		}
+	});
+	if (positionals.length > 1) throw new Error("Expected at most one Preview name: previews deploy [preview-name].");
+	return {
+		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"]
+	};
+}
+//#endregion
+export { parsePreviewsDeployArgs };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vinext/cloudflare",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Cloudflare cache and image adapters for vinext.",
   "homepage": "https://vinext.dev/",
   "license": "MIT",
@@ -48,7 +48,7 @@
     }
   },
   "dependencies": {
-    "@cloudflare/workers-response-store": "1.1.1"
+    "@cloudflare/workers-response-store": "1.1.2"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",
@@ -57,12 +57,12 @@
     "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
     "vite-plus": "1.1.0",
     "vitest": "5.0.3",
-    "vinext": "1.2.0"
+    "vinext": "1.3.0"
   },
   "peerDependencies": {
     "@cloudflare/vite-plugin": "*",
     "cf": "*",
-    "vinext": "^1.2.0"
+    "vinext": "^1.3.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/vite-plugin": {