@vinext/cloudflare 1.0.0-beta.6 → 1.0.0-beta.8

package/dist/images/images-optimizer.d.ts

@@ -1,6 +1,6 @@
 //#region src/images/images-optimizer.d.ts
 /** Options accepted by {@link imagesOptimizer}, forwarded to the runtime factory. */
-type ImagesOptimizerOptions = {
+export type ImagesOptimizerOptions = {
   /** Cloudflare Images binding name on the Worker `env`. @default "IMAGES" */
   binding?: string;
 };
@@ -21,9 +21,8 @@ type ImagesOptimizerOptions = {
  *   plugins: [vinext({ images: { optimizer: imagesOptimizer() } })],
  * });
  */
-declare function imagesOptimizer(options?: ImagesOptimizerOptions): {
+export declare function imagesOptimizer(options?: ImagesOptimizerOptions): {
   adapter: string;
   options: ImagesOptimizerOptions | undefined;
 };
-//#endregion
-export { ImagesOptimizerOptions, imagesOptimizer };
+//#endregion

package/dist/prerender-kv-populate.d.ts

@@ -7,13 +7,13 @@
  * KVCacheEntry shape written by KVCacheHandler.set(), and returns Wrangler KV
  * bulk import records for deploy-time upload.
  */
-type KVBulkPair = {
+export type KVBulkPair = {
   key: string;
   value: string;
   expiration_ttl?: number;
   metadata?: Record<string, unknown>;
 };
-declare function buildPrerenderKVPairs(serverDir: string, options?: {
+export declare function buildPrerenderKVPairs(serverDir: string, options?: {
   appPrefix?: string;
   now?: number;
   ttlSeconds?: number;
@@ -21,5 +21,4 @@ declare function buildPrerenderKVPairs(serverDir: string, options?: {
   routeCount: number;
   pairs: KVBulkPair[];
 };
-//#endregion
-export { KVBulkPair, buildPrerenderKVPairs };
+//#endregion

package/dist/prerender-kv-populate.js

@@ -1,6 +1,6 @@
 import { createKvKeySpace } from "./cache/kv-key.js";
-import path from "node:path";
 import fs from "node:fs";
+import path from "node:path";
 import { getRenderedAppRoutes, getRenderedMetadataRoutes, readPrerenderManifest } from "vinext/internal/server/prerender-manifest";
 import { appIsrCacheKey } from "vinext/internal/server/isr-cache";
 import { buildAppPageCacheTags, buildAppRouteCacheTags } from "vinext/internal/server/app-page-cache";
@@ -16,7 +16,7 @@ import { getAppRouteOutputPath, getOutputPath, getRscOutputPath } from "vinext/i
 * bulk import records for deploy-time upload.
 */
 /** Default KV expiration TTL used by KVCacheHandler for revalidating entries. */
-const DEFAULT_KV_TTL_SECONDS = 720 * 3600;
+const DEFAULT_KV_TTL_SECONDS = 2592e3;
 function resolveContainedFile(rootDir, relativePath) {
 	const resolvedRoot = path.resolve(rootDir);
 	const resolvedFile = path.resolve(resolvedRoot, relativePath);
@@ -48,7 +48,8 @@ function buildMetadata(tags) {
 	return JSON.stringify(metadata).length <= 1024 ? metadata : void 0;
 }
 function buildPrerenderKVPairs(serverDir, options) {
-	const manifest = readPrerenderManifest(path.join(serverDir, "vinext-prerender.json"));
+	const manifestPath = path.join(serverDir, "vinext-prerender.json");
+	const manifest = readPrerenderManifest(manifestPath);
 	if (!manifest?.buildId || !Array.isArray(manifest.routes)) return {
 		routeCount: 0,
 		pairs: []

package/dist/tpr.d.ts

@@ -20,7 +20,7 @@
  * gracefully skips when no custom domain, no API token, no traffic data,
  * or no KV namespace is configured.
  */
-type TPROptions = {
+export type TPROptions = {
   /** Project root directory. */
   root: string;
   /** Wrangler config path, relative to root unless absolute. */
@@ -32,7 +32,7 @@ type TPROptions = {
   /** Analytics lookback window in hours. Default: 24. */
   window: number;
 };
-type TPRResult = {
+export type TPRResult = {
   /** Total unique page paths found in analytics. */
   totalPaths: number;
   /** Number of pages successfully pre-rendered and uploaded. */
@@ -57,7 +57,7 @@ type WranglerConfig = {
   legacyEnv?: boolean;
   env?: Record<string, WranglerEnvironmentConfig>;
 };
-type WranglerEnvironmentConfig = {
+export type WranglerEnvironmentConfig = {
   customDomain?: string;
   name?: string;
 };
@@ -65,7 +65,7 @@ type WranglerEnvironmentConfig = {
  * Parse wrangler config (JSONC or TOML) to extract the fields TPR needs:
  * account_id, VINEXT_KV_CACHE KV namespace ID, and custom domain.
  */
-declare function parseWranglerConfig(root: string, configPath?: string): WranglerConfig | null;
+export declare function parseWranglerConfig(root: string, configPath?: string): WranglerConfig | null;
 /**
  * Generate zone lookup candidates from shortest (2-part) to longest.
  * Tries the most common case first (e.g., "example.com") and progressively
@@ -75,8 +75,8 @@ declare function parseWranglerConfig(root: string, configPath?: string): Wrangle
  * "shop.example.co.uk"  → ["co.uk", "example.co.uk", "shop.example.co.uk"]
  * "example.com"         → ["example.com"]
  */
-declare function domainCandidates(domain: string): string[];
-declare function resolveVinextProdServerPath(root: string): string;
+export declare function domainCandidates(domain: string): string[];
+export declare function resolveVinextProdServerPath(root: string): string;
 /**
  * Build KV bulk API pairs from pre-rendered entries.
  *
@@ -84,7 +84,7 @@ declare function resolveVinextProdServerPath(root: string): string;
  *   createKvKeySpace().entryKey(isrCacheKey("app", pathname, buildId) + ":html")
  *   → "cache:app:<buildId>:<pathname>:html"
  */
-declare function buildTprKVPairs(entries: Map<string, PrerenderResult>, buildId: string | undefined, defaultRevalidateSeconds: number): Array<{
+export declare function buildTprKVPairs(entries: Map<string, PrerenderResult>, buildId: string | undefined, defaultRevalidateSeconds: number): Array<{
   key: string;
   value: string;
   expiration_ttl: number;
@@ -96,6 +96,5 @@ declare function buildTprKVPairs(entries: Map<string, PrerenderResult>, buildId:
  * `vinext-cloudflare deploy` pipeline. Gracefully skips (never errors) when
  * the prerequisites aren't met.
  */
-declare function runTPR(options: TPROptions): Promise<TPRResult>;
-//#endregion
-export { TPROptions, TPRResult, WranglerEnvironmentConfig, buildTprKVPairs, domainCandidates, parseWranglerConfig, resolveVinextProdServerPath, runTPR };
+export declare function runTPR(options: TPROptions): Promise<TPRResult>;
+//#endregion

package/dist/tpr.js

@@ -1,10 +1,10 @@
 import { createKvKeySpace } from "./cache/kv-key.js";
 import { createRequire } from "node:module";
-import path from "node:path";
 import fs from "node:fs";
+import path from "node:path";
+import { VINEXT_REVALIDATE_HEADER } from "vinext/internal/server/headers";
 import { spawn } from "node:child_process";
 import { pathToFileURL } from "node:url";
-import { VINEXT_REVALIDATE_HEADER } from "vinext/internal/server/headers";
 import { isrCacheKey } from "vinext/internal/server/isr-cache";
 import { buildAppPageCacheTags } from "vinext/internal/server/app-page-cache";
 //#region src/tpr.ts
@@ -573,7 +573,7 @@ async function waitForServer(port, timeoutMs) {
 /** KV bulk API accepts up to 10,000 pairs per request */
 const KV_BATCH_SIZE = 1e4;
 /** Maximum KV expiration TTL: 30 days */
-const MAX_KV_TTL_SECONDS = 720 * 3600;
+const MAX_KV_TTL_SECONDS = 2592e3;
 /**
 * Build KV bulk API pairs from pre-rendered entries.
 *

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

@@ -5,7 +5,6 @@
  * so the Cloudflare adapters stay self-contained (these mirror the equivalent
  * helpers in the vinext core).
  */
-declare function isUnknownRecord(value: unknown): value is Record<string, unknown>;
-declare function readCacheControlNumberField(ctx: Record<string, unknown> | undefined, field: string): number | undefined;
-//#endregion
-export { isUnknownRecord, readCacheControlNumberField };
+export declare function isUnknownRecord(value: unknown): value is Record<string, unknown>;
+export declare function readCacheControlNumberField(ctx: Record<string, unknown> | undefined, field: string): number | undefined;
+//#endregion

package/dist/version-deploy.d.ts

@@ -2,20 +2,22 @@ import { parseWorkersDevUrl } from "./workers-dev-url.js";
 import { DeployOptions } from "./deploy.js";
 import { execFileSync } from "node:child_process";
 //#region src/version-deploy.d.ts
-type WranglerVersionUploadResult = {
+export type WranglerVersionUploadResult = {
   versionId: string;
   previewUrl: string | null;
+  workerName: string | null;
   output: string;
 };
-type WranglerVersionDeployResult = {
+export type WranglerVersionDeployResult = {
   deployedUrl: string | null;
   output: string;
 };
-type WranglerVersionTraffic = {
+export type WranglerVersionTraffic = {
   versionId: string;
   percentage: number;
 };
-type WranglerDeploymentStatus = {
+export type WranglerDeploymentStatus = {
+  deploymentId: string | null;
   versions: WranglerVersionTraffic[];
   output: string;
 };
@@ -23,20 +25,21 @@ type WranglerVersionArgs = {
   args: string[];
   env: string | undefined;
 };
-declare function parseVersionId(output: string): string | null;
-declare function parseWranglerVersionUploadOutput(output: string): WranglerVersionUploadResult;
-declare function buildWranglerVersionUploadArgs(options: Pick<DeployOptions, "preview" | "env" | "name" | "config"> & {
+export declare function parseVersionId(output: string): string | null;
+export declare function parseUploadedWorkerName(output: string): string | null;
+export declare function parseWranglerVersionUploadOutput(output: string): WranglerVersionUploadResult;
+export declare function buildWranglerVersionUploadArgs(options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose"> & {
   previewAlias?: string;
 }): WranglerVersionArgs;
-declare function buildWranglerVersionDeployArgs(versionTraffic: readonly WranglerVersionTraffic[], options: Pick<DeployOptions, "preview" | "env" | "name" | "config">): WranglerVersionArgs;
-declare function buildWranglerDeploymentsStatusArgs(options: Pick<DeployOptions, "preview" | "env" | "name" | "config">): WranglerVersionArgs;
-declare function buildWranglerTriggersDeployArgs(options: Pick<DeployOptions, "preview" | "env" | "name" | "config">): WranglerVersionArgs;
-declare function parseWranglerDeploymentStatusOutput(output: string): WranglerDeploymentStatus;
-declare function runWranglerVersionUpload(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config"> & {
+export declare function buildWranglerVersionDeployArgs(versionTraffic: readonly WranglerVersionTraffic[], options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose">): WranglerVersionArgs;
+export declare function buildWranglerDeploymentsStatusArgs(options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose">): WranglerVersionArgs;
+export declare function buildWranglerTriggersDeployArgs(options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose">): WranglerVersionArgs;
+export declare function parseWranglerDeploymentStatusOutput(output: string): WranglerDeploymentStatus;
+export declare function runWranglerVersionUpload(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose"> & {
   previewAlias?: string;
 }, execute?: typeof execFileSync): WranglerVersionUploadResult;
-declare function runWranglerVersionDeploy(root: string, versionTraffic: readonly WranglerVersionTraffic[], options: Pick<DeployOptions, "preview" | "env" | "name" | "config">, phase?: "stage" | "promote-warmed" | "promote-uploaded", execute?: typeof execFileSync): WranglerVersionDeployResult;
-declare function runWranglerDeploymentStatus(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config">, execute?: typeof execFileSync): WranglerDeploymentStatus;
-declare function runWranglerTriggersDeploy(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config">, execute?: typeof execFileSync): WranglerVersionDeployResult;
+export declare function runWranglerVersionDeploy(root: string, versionTraffic: readonly WranglerVersionTraffic[], options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose">, phase?: "stage" | "promote-warmed" | "promote-uploaded", execute?: typeof execFileSync): WranglerVersionDeployResult;
+export declare function runWranglerDeploymentStatus(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose">, execute?: typeof execFileSync): WranglerDeploymentStatus;
+export declare function runWranglerTriggersDeploy(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose">, execute?: typeof execFileSync): WranglerVersionDeployResult;
 //#endregion
-export { WranglerDeploymentStatus, WranglerVersionDeployResult, WranglerVersionTraffic, WranglerVersionUploadResult, buildWranglerDeploymentsStatusArgs, buildWranglerTriggersDeployArgs, buildWranglerVersionDeployArgs, buildWranglerVersionUploadArgs, parseVersionId, parseWorkersDevUrl, parseWranglerDeploymentStatusOutput, parseWranglerVersionUploadOutput, runWranglerDeploymentStatus, runWranglerTriggersDeploy, runWranglerVersionDeploy, runWranglerVersionUpload };
+export { parseWorkersDevUrl };

package/dist/version-deploy.js

@@ -1,4 +1,5 @@
 import { parseWorkersDevUrl } from "./workers-dev-url.js";
+import { parseCdnWarmupDeploymentUrl } from "./worker-deployment-url.js";
 import { buildNodeCliInvocation, resolveWranglerBin, validateWranglerEnvName } from "./deploy.js";
 import { execFileSync } from "node:child_process";
 //#region src/version-deploy.ts
@@ -56,16 +57,24 @@ function findPreviewUrlInUploadJson(parsed) {
 	]);
 }
 function parseVersionId(output) {
-	return output.match(/\b[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\b/)?.[0] ?? null;
+	const versionIdPattern = "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}";
+	const labeledVersionId = output.match(new RegExp(`Worker\\s+Version\\s+ID\\s*:\\s*(${versionIdPattern})\\b`, "i"))?.[1];
+	if (labeledVersionId) return labeledVersionId;
+	return output.match(new RegExp(`\\b${versionIdPattern}\\b`))?.[0] ?? null;
+}
+function parseUploadedWorkerName(output) {
+	return output.match(/^\s*Uploaded\s+(\S+)\s+\(\d+(?:\.\d+)?\s+sec\)\s*$/im)?.[1] ?? null;
 }
 function parseWranglerVersionUploadOutput(output) {
 	const parsed = parseJsonObject(output);
 	const versionId = findVersionIdInUploadJson(parsed) ?? parseVersionId(output);
 	const previewUrl = findPreviewUrlInUploadJson(parsed) ?? parseWorkersDevUrl(output);
+	const workerName = parseUploadedWorkerName(output);
 	if (!versionId) throw new Error("Could not detect Worker version ID from `wrangler versions upload` output.");
 	return {
 		versionId,
 		previewUrl,
+		workerName,
 		output
 	};
 }
@@ -123,8 +132,9 @@ function buildWranglerTriggersDeployArgs(options) {
 		env
 	};
 }
-function runWranglerCommand(root, args, execute = execFileSync) {
-	const invocation = buildNodeCliInvocation(resolveWranglerBin(root), args);
+function runWranglerCommand(root, args, execute = execFileSync, verbose = false) {
+	const wranglerBin = resolveWranglerBin(root);
+	const invocation = buildNodeCliInvocation(wranglerBin, args);
 	const execOpts = {
 		cwd: root,
 		stdio: "pipe",
@@ -132,7 +142,7 @@ function runWranglerCommand(root, args, execute = execFileSync) {
 		shell: false
 	};
 	const output = execute(invocation.file, invocation.args, execOpts);
-	if (output.trim()) for (const line of output.trim().split("\n")) console.log(`  ${line}`);
+	if (verbose && output.trim()) for (const line of output.trim().split("\n")) console.log(`  ${line}`);
 	return output;
 }
 function errorText(error) {
@@ -176,6 +186,11 @@ function parseWranglerDeploymentStatusOutput(output) {
 	const parsed = parseJsonObject(output);
 	if (!parsed) throw new Error("Could not parse `wrangler deployments status --json` output.");
 	return {
+		deploymentId: findStringInRecord(Array.isArray(parsed) ? parsed.at(-1) : parsed, [
+			"id",
+			"deployment_id",
+			"deploymentId"
+		]),
 		versions: parseDeploymentVersions(parsed),
 		output
 	};
@@ -185,7 +200,7 @@ function runWranglerVersionUpload(root, options, execute = execFileSync) {
 	if (env) console.log(`\n  Uploading Worker version for env: ${env}...`);
 	else console.log("\n  Uploading Worker version for production...");
 	try {
-		return parseWranglerVersionUploadOutput(runWranglerCommand(root, args, execute));
+		return parseWranglerVersionUploadOutput(runWranglerCommand(root, args, execute, options.verbose === true));
 	} catch (error) {
 		if (isMissingWorkerVersionUploadError(error)) throw withInitialDeployRequiredMessage();
 		throw error;
@@ -197,7 +212,7 @@ function runWranglerVersionDeploy(root, versionTraffic, options, phase = "promot
 	if (phase === "stage") console.log(`\n  Staging uploaded Worker version at 0% for CDN warmup in ${target}...`);
 	else if (phase === "promote-warmed") console.log(`\n  Promoting warmed Worker version to ${target}...`);
 	else console.log(`\n  Promoting uploaded Worker version to ${target}...`);
-	const output = runWranglerCommand(root, args, execute);
+	const output = runWranglerCommand(root, args, execute, options.verbose === true);
 	return {
 		deployedUrl: parseWorkersDevUrl(output),
 		output
@@ -205,19 +220,21 @@ function runWranglerVersionDeploy(root, versionTraffic, options, phase = "promot
 }
 function runWranglerDeploymentStatus(root, options, execute = execFileSync) {
 	const { args, env } = buildWranglerDeploymentsStatusArgs(options);
-	if (env) console.log(`\n  Reading current Worker deployment for env: ${env}...`);
-	else console.log("\n  Reading current Worker deployment...");
-	return parseWranglerDeploymentStatusOutput(runWranglerCommand(root, args, execute));
+	if (options.verbose) {
+		if (env) console.log(`\n  Reading current Worker deployment for env: ${env}...`);
+		else console.log("\n  Reading current Worker deployment...");
+	}
+	return parseWranglerDeploymentStatusOutput(runWranglerCommand(root, args, execute, options.verbose === true));
 }
 function runWranglerTriggersDeploy(root, options, execute = execFileSync) {
 	const { args, env } = buildWranglerTriggersDeployArgs(options);
 	if (env) console.log(`\n  Applying Worker triggers for env: ${env}...`);
 	else console.log("\n  Applying Worker triggers...");
-	const output = runWranglerCommand(root, args, execute);
+	const output = runWranglerCommand(root, args, execute, options.verbose === true);
 	return {
-		deployedUrl: parseWorkersDevUrl(output),
+		deployedUrl: parseCdnWarmupDeploymentUrl(output),
 		output
 	};
 }
 //#endregion
-export { buildWranglerDeploymentsStatusArgs, buildWranglerTriggersDeployArgs, buildWranglerVersionDeployArgs, buildWranglerVersionUploadArgs, parseVersionId, parseWorkersDevUrl, parseWranglerDeploymentStatusOutput, parseWranglerVersionUploadOutput, runWranglerDeploymentStatus, runWranglerTriggersDeploy, runWranglerVersionDeploy, runWranglerVersionUpload };
+export { buildWranglerDeploymentsStatusArgs, buildWranglerTriggersDeployArgs, buildWranglerVersionDeployArgs, buildWranglerVersionUploadArgs, parseUploadedWorkerName, parseVersionId, parseWorkersDevUrl, parseWranglerDeploymentStatusOutput, parseWranglerVersionUploadOutput, runWranglerDeploymentStatus, runWranglerTriggersDeploy, runWranglerVersionDeploy, runWranglerVersionUpload };

package/dist/version-headers.d.ts

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

package/dist/version-headers.js

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

package/dist/worker-deployment-url.d.ts

@@ -1,4 +1,9 @@
 //#region src/worker-deployment-url.d.ts
-declare function parseWorkerDeploymentUrl(output: string): string | null;
-//#endregion
-export { parseWorkerDeploymentUrl };
+export declare function parseWorkerDeploymentUrl(output: string): string | null;
+/**
+ * Parse the concrete hostname that Wrangler reports after applying Worker
+ * triggers. Catch-all routes are valid warmup targets even though they are not
+ * canonical deployment URLs for general CLI reporting.
+ */
+export declare function parseCdnWarmupDeploymentUrl(output: string): string | null;
+//#endregion

package/dist/worker-deployment-url.js

@@ -3,6 +3,28 @@ import { parseWorkersDevUrl } from "./workers-dev-url.js";
 function parseWorkerDeploymentUrl(output) {
 	return parseWorkersDevUrl(output) ?? parseCustomDomainUrl(output);
 }
+/**
+* Parse the concrete hostname that Wrangler reports after applying Worker
+* triggers. Catch-all routes are valid warmup targets even though they are not
+* canonical deployment URLs for general CLI reporting.
+*/
+function parseCdnWarmupDeploymentUrl(output) {
+	return parseCustomDomainUrl(output) ?? parseCatchAllWorkerRouteOrigin(output) ?? parseWorkersDevUrl(output);
+}
+function parseCatchAllWorkerRouteOrigin(output) {
+	for (const line of output.split(/\r?\n/)) {
+		const route = line.trim().split(/\s+/, 1)[0];
+		if (!route || !route.endsWith("/*")) continue;
+		try {
+			const url = new URL(route.includes("://") ? route : `https://${route}`);
+			if (url.protocol !== "https:" && url.protocol !== "http:" || url.hostname.includes("*") || url.username !== "" || url.password !== "" || url.port !== "" || url.pathname !== "/*" || url.search !== "" || url.hash !== "") continue;
+			return url.origin;
+		} catch {
+			continue;
+		}
+	}
+	return null;
+}
 function parseCustomDomainUrl(output) {
 	for (const line of output.split(/\r?\n/)) {
 		const match = /^\s*(\S+)\s+\(custom domain(?: - zone (?:id|name): [^)]+)?\)(?: \[([^\]\r\n]+)\])?\s*$/.exec(line);
@@ -20,4 +42,4 @@ function parseCustomDomainUrl(output) {
 	return null;
 }
 //#endregion
-export { parseWorkerDeploymentUrl };
+export { parseCdnWarmupDeploymentUrl, parseWorkerDeploymentUrl };

package/dist/workers-dev-url.d.ts

@@ -1,4 +1,3 @@
 //#region src/workers-dev-url.d.ts
-declare function parseWorkersDevUrl(output: string): string | null;
-//#endregion
-export { parseWorkersDevUrl };
+export declare function parseWorkersDevUrl(output: string): string | null;
+//#endregion

package/dist/wrangler-version-metadata.d.ts

@@ -0,0 +1,7 @@
+//#region src/wrangler-version-metadata.d.ts
+export declare function assertCdnVersionMetadataConfig({ binding, configuredBinding, configPath }: {
+  binding: string;
+  configuredBinding: string | undefined;
+  configPath: string | undefined;
+}): void;
+//#endregion

package/dist/wrangler-version-metadata.js

@@ -0,0 +1,9 @@
+//#region src/wrangler-version-metadata.ts
+function assertCdnVersionMetadataConfig({ binding, configuredBinding, configPath }) {
+	if (configuredBinding === binding) return;
+	const location = configPath ? ` in ${configPath}` : "";
+	const found = configuredBinding ? ` declares ${JSON.stringify(configuredBinding)} instead` : " does not declare version_metadata";
+	throw new Error(`[vinext] Cloudflare CDN warmup requires version metadata binding ${JSON.stringify(binding)}, but the effective Wrangler config${location}${found}. Deploy the generated Wrangler config finalized by cdnAdapter(), or add the binding to this effective config and align cdnAdapter({ versionMetadataBinding }) when using a custom name.`);
+}
+//#endregion
+export { assertCdnVersionMetadataConfig };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@vinext/cloudflare",
-  "version": "1.0.0-beta.6",
-  "description": "Cloudflare adapters for vinext (KV data cache and Images-backed image optimization).",
+  "version": "1.0.0-beta.8",
+  "description": "Cloudflare cache and image adapters for vinext.",
+  "homepage": "https://vinext.dev/",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -50,20 +51,26 @@
       "import": "./dist/images/*.js"
     }
   },
+  "dependencies": {
+    "@cloudflare/workers-response-store": "0.1.0-beta.0"
+  },
   "devDependencies": {
     "@types/node": "^25.9.2",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.6",
-    "vite-plus": "0.2.6",
-    "vinext": "1.0.0-beta.6"
+    "miniflare": "5.20260730.0-alpha",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.2",
+    "vite-plus": "0.3.2",
+    "vitest": "4.1.11",
+    "vinext": "1.0.0-beta.10"
   },
   "peerDependencies": {
-    "vinext": "^1.0.0-beta.6"
+    "vinext": "^1.0.0-beta.10"
   },
   "engines": {
     "node": ">=22"
   },
   "scripts": {
     "build": "vp pack",
-    "dev": "vp pack --watch"
+    "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 pnpm --filter response-store-demo run build && pnpm --filter response-store-demo run build && vitest run"
   }
 }