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

package/dist/cli.js

@@ -38,16 +38,30 @@ async function deployCommand() {
 		root: process.cwd(),
 		preview: parsed.preview,
 		env: parsed.env,
+		config: parsed.config,
 		skipBuild: parsed.skipBuild,
 		dryRun: parsed.dryRun,
+		verbose: parsed.verbose,
 		name: parsed.name,
 		prerenderAll: parsed.prerenderAll,
 		prerenderConcurrency: parsed.prerenderConcurrency,
 		warmCdnCache: parsed.warmCdnCache,
+		warmCdnTarget: parsed.warmCdnTarget,
 		warmCdnConcurrency: parsed.warmCdnConcurrency,
 		warmCdnTimeout: parsed.warmCdnTimeout,
 		warmCdnRetries: parsed.warmCdnRetries,
-		warmCdnStrict: parsed.warmCdnStrict,
+		warmCdnDiscoveryTimeout: parsed.warmCdnDiscoveryTimeout,
+		warmCdnDiscoveryRetries: parsed.warmCdnDiscoveryRetries,
+		warmCdnProbeTimeout: parsed.warmCdnProbeTimeout,
+		warmCdnProbeRetries: parsed.warmCdnProbeRetries,
+		warmCdnCertify: parsed.warmCdnCertify,
+		warmCdnReadinessTimeout: parsed.warmCdnReadinessTimeout,
+		warmCdnReadinessRetries: parsed.warmCdnReadinessRetries,
+		warmCdnReadinessProbes: parsed.warmCdnReadinessProbes,
+		warmCdnReadinessProbeDelay: parsed.warmCdnReadinessProbeDelay,
+		dangerouslyPromoteOnCdnWarmError: parsed.dangerouslyPromoteOnCdnWarmError,
+		warmCdnPromote: parsed.warmCdnPromote,
+		warmCdnPromotionDelay: parsed.warmCdnPromotionDelay,
 		warmCdnIncludeFallbacks: parsed.warmCdnIncludeFallbacks,
 		experimentalTPR: parsed.experimentalTPR,
 		tprCoverage: parsed.tprCoverage,

package/dist/deploy-config.d.ts

@@ -23,6 +23,10 @@ type ResolvedKvDataAdapterConfig = {
   appPrefix?: string;
   ttlSeconds?: number;
 };
+type ResolvedCdnAdapterConfig = {
+  versionMetadataBinding: string;
+};
+declare function resolveCdnAdapterConfig(cache: VinextCacheConfig | null | undefined): ResolvedCdnAdapterConfig | null;
 declare function resolveKvDataAdapterConfig(cache: VinextCacheConfig | null | undefined): ResolvedKvDataAdapterConfig | null;
 declare function viteConfigHasImageAdapter(root: string): boolean;
 /**
@@ -51,4 +55,4 @@ declare function formatMissingCacheAdapterError(options: {
 }): string;
 declare function formatImageOptimizationHint(): string;
 //#endregion
-export { ResolvedKvDataAdapterConfig, formatImageOptimizationHint, formatMissingCacheAdapterError, resolveKvDataAdapterConfig, viteConfigHasCacheAdapter, viteConfigHasCloudflarePlugin, viteConfigHasImageAdapter, workerEntryHasCacheHandler };
+export { ResolvedCdnAdapterConfig, ResolvedKvDataAdapterConfig, formatImageOptimizationHint, formatMissingCacheAdapterError, resolveCdnAdapterConfig, resolveKvDataAdapterConfig, viteConfigHasCacheAdapter, viteConfigHasCloudflarePlugin, viteConfigHasImageAdapter, workerEntryHasCacheHandler };

package/dist/deploy-config.js

@@ -1,6 +1,8 @@
 import { DEFAULT_KV_DATA_CACHE_BINDING } from "./cache/kv-data-adapter.js";
-import path from "node:path";
+import { DEFAULT_CDN_VERSION_METADATA_BINDING } from "./cache/cdn-adapter.js";
 import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { findViteConfigPath } from "vinext/internal/utils/project";
 //#region src/deploy-config.ts
 function escapeRegExp(value) {
@@ -87,6 +89,17 @@ function viteConfigHasCacheAdapter(root) {
 	if (!block) return false;
 	return cacheFieldAssigned(block, "cdn") || cacheFieldAssigned(block, "data");
 }
+function isCloudflareCdnAdapterPath(adapter) {
+	const normalized = adapter.replace(/\\/g, "/");
+	const bundledRuntime = fileURLToPath(new URL("./cache/cdn-adapter.runtime.js", import.meta.url)).replace(/\\/g, "/");
+	return normalized === "@vinext/cloudflare/cache/cdn-adapter.runtime" || normalized === "@vinext/cloudflare/cache/cdn-adapter.runtime.js" || normalized === bundledRuntime;
+}
+function resolveCdnAdapterConfig(cache) {
+	const cdn = cache?.cdn;
+	if (!cdn?.adapter || !isCloudflareCdnAdapterPath(cdn.adapter)) return null;
+	const options = cdn.options;
+	return { versionMetadataBinding: typeof options?.versionMetadataBinding === "string" && options.versionMetadataBinding.length > 0 ? options.versionMetadataBinding : DEFAULT_CDN_VERSION_METADATA_BINDING };
+}
 function isCloudflareKvDataAdapterPath(adapter) {
 	const normalized = adapter.replace(/\\/g, "/");
 	return normalized === "@vinext/cloudflare/cache/kv-data-adapter.runtime" || normalized === "@vinext/cloudflare/cache/kv-data-adapter.runtime.js" || normalized.endsWith("/cache/kv-data-adapter.runtime.js");
@@ -166,4 +179,4 @@ function formatImageOptimizationHint() {
 	return "  [vinext] next/image is served unoptimized. To enable edge image\n  optimization via Cloudflare Images, run:\n\n    vinext init --platform=cloudflare --image-optimization=cloudflare-images\n\n  This adds the imagesOptimizer() option to your Vite config and the matching\n  IMAGES binding to your Wrangler config without replacing existing settings.";
 }
 //#endregion
-export { formatImageOptimizationHint, formatMissingCacheAdapterError, resolveKvDataAdapterConfig, viteConfigHasCacheAdapter, viteConfigHasCloudflarePlugin, viteConfigHasImageAdapter, workerEntryHasCacheHandler };
+export { formatImageOptimizationHint, formatMissingCacheAdapterError, resolveCdnAdapterConfig, resolveKvDataAdapterConfig, viteConfigHasCacheAdapter, viteConfigHasCloudflarePlugin, viteConfigHasImageAdapter, workerEntryHasCacheHandler };

package/dist/deploy-help.js

@@ -18,6 +18,7 @@ function formatDeployHelp() {
     --config <path>          Wrangler config path (default: wrangler.jsonc/json/toml)
     --skip-build             Skip the build step (use existing dist/)
     --dry-run                Validate setup without building or deploying
+    --verbose                Print raw output from internal Wrangler commands
     --prerender-all          Pre-render discovered routes after building (future
                              releases will auto-populate the remote cache)
     --prerender-concurrency <count>
@@ -25,11 +26,44 @@ function formatDeployHelp() {
     --experimental-warm-cdn-cache
                              Upload a Worker version, warm build-discovered paths
                              through the production URL, then promote it (experimental)
+    --warm-cdn-target <origin>
+                             HTTPS origin to use for discovery, probing, and warming
+                             (overrides URLs inferred from Wrangler output)
     --warm-cdn-concurrency <count>
-                             Maximum number of CDN warmup requests in parallel
-    --warm-cdn-timeout <ms>  Per-request CDN warmup timeout (default: 5000)
-    --warm-cdn-retries <n>   Retries for transient CDN warmup failures (default: 1)
-    --warm-cdn-strict        Fail deploy when any CDN warmup request fails
+                             Maximum number of CDN warmup requests in parallel (default: 25)
+    --warm-cdn-timeout <ms>  Per-request CDN warmup timeout (default: 10000)
+    --warm-cdn-retries <n>   Retries per failed CDN warmup request (default: 1;
+                             staged-version propagation default: 60)
+    --warm-cdn-discovery-timeout <ms>
+                             Total staged path-discovery deadline (default: 120000)
+    --warm-cdn-discovery-retries <n>
+                             Optional staged path-discovery retry limit
+                             (default: derived from the discovery deadline)
+    --warm-cdn-probe-timeout <ms>
+                             Abort when cacheability probing makes no progress for
+                             this duration (default: 120000)
+    --warm-cdn-probe-retries <n>
+                             Cacheability-probe retries (default: 2)
+    --warm-cdn-certify      With --experimental-warm-cdn-cache, re-request warmed
+                             entries using headers only and require every planned
+                             entry to be reusable before promotion
+    --warm-cdn-readiness-timeout <ms>
+                             Explicit total staged-readiness deadline (default:
+                             120000)
+    --warm-cdn-readiness-retries <n>
+                             Staged-readiness retries (default: 60)
+    --warm-cdn-readiness-probes <count>
+                             Consecutive successful staged-readiness probes
+                             required before warming (default: 6)
+    --warm-cdn-readiness-probe-delay <ms>
+                             Delay between staged-readiness probes (default: 1000)
+    --dangerously-promote-on-cdn-warm-error
+                             Promote even when ordinary staged warmup cannot be
+                             verified (never bypasses --warm-cdn-certify)
+    --warm-cdn-no-promote    Leave the warmed Worker version staged at 0% traffic;
+                             production triggers are still applied before warming
+    --warm-cdn-promotion-delay <ms>
+                             Delay before promotion after warmup (default: 15000)
     --warm-cdn-include-fallbacks
                              Also warm PPR fallback-shell placeholder paths
     -h, --help               Show this help
@@ -46,8 +80,9 @@ function formatDeployHelp() {
   a custom domain (zone analytics are unavailable on *.workers.dev) and the
   CLOUDFLARE_API_TOKEN environment variable with Zone.Analytics read permission.
 
-  CDN warmup requests populate the edge cache only in the Cloudflare data centers
-  reached by the warmup run; they do not globally prefill every edge location.
+  Workers Cache automatically uses tiered caching. Warmed entries can therefore
+  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.
 
   Examples:
     npx @vinext/cloudflare deploy                                      Build and deploy to production
@@ -59,6 +94,8 @@ function formatDeployHelp() {
     vinext-cloudflare deploy --dry-run                                 Validate setup without building or deploying
     vinext-cloudflare deploy --name my-app                             Deploy with a custom Worker name
     vinext-cloudflare deploy --experimental-warm-cdn-cache              Warm build-discovered paths during version deploy (experimental)
+    vinext-cloudflare deploy --experimental-warm-cdn-cache --warm-cdn-target https://example.com
+                                                                          Warm an explicit production origin
     vinext-cloudflare deploy --experimental-tpr                        Enable TPR during deploy
     vinext-cloudflare deploy --experimental-tpr --tpr-coverage 95      Cover 95% of traffic
     vinext-cloudflare deploy --experimental-tpr --tpr-limit 500        Cap at 500 pages

package/dist/deploy.d.ts

@@ -1,8 +1,12 @@
+import { CdnWarmOptions, CdnWarmRequestPlan, PrerenderWarmPlan } from "./cdn-warm.js";
 import { parseWranglerConfig } from "./tpr.js";
 import { WranglerDeploymentStatus, WranglerVersionTraffic } from "./version-deploy.js";
 import { KVBulkPair } from "./prerender-kv-populate.js";
 import { spawn } from "node:child_process";
+import { VinextCacheConfig } from "vinext/internal/config/prerender";
+import { ProjectInfo } from "vinext/internal/utils/project";
 //#region src/deploy.d.ts
+declare const DEFAULT_CDN_WARM_PROMOTION_DELAY_MS = 15000;
 type DeployOptions = {
   /** Project root directory */
   root: string;
@@ -18,20 +22,46 @@ type DeployOptions = {
   skipBuild?: boolean;
   /** Dry run — validate setup but don't build or deploy */
   dryRun?: boolean;
+  /** Print raw output from internal Wrangler commands. */
+  verbose?: boolean;
   /** Pre-render all discovered routes into the dist output after building */
   prerenderAll?: boolean;
   /** Maximum number of routes to prerender in parallel */
   prerenderConcurrency?: number;
   /** Warm Cloudflare's CDN cache by requesting build-discovered paths for the uploaded version */
   warmCdnCache?: boolean;
+  /** Explicit production origin to use for CDN discovery, probing, and warming */
+  warmCdnTarget?: string;
   /** Maximum number of CDN warmup requests to issue in parallel */
   warmCdnConcurrency?: number;
   /** Per-request CDN warmup timeout in milliseconds */
   warmCdnTimeout?: number;
   /** Number of CDN warmup retries for transient failures */
   warmCdnRetries?: number;
-  /** Fail deployment if any CDN warmup request fails */
-  warmCdnStrict?: boolean;
+  /** Maximum duration of staged Worker path discovery */
+  warmCdnDiscoveryTimeout?: number;
+  /** Number of transient staged Worker path discovery retries */
+  warmCdnDiscoveryRetries?: number;
+  /** Abort after this duration without a completed cacheability probe */
+  warmCdnProbeTimeout?: number;
+  /** Number of transient staged Worker cacheability probe retries */
+  warmCdnProbeRetries?: number;
+  /** Re-request warmed identities and require reusable CDN hits before promotion */
+  warmCdnCertify?: boolean;
+  /** Maximum duration of staged Worker readiness verification */
+  warmCdnReadinessTimeout?: number;
+  /** Number of staged Worker readiness retries */
+  warmCdnReadinessRetries?: number;
+  /** Consecutive successful probes required before warming the staged Worker */
+  warmCdnReadinessProbes?: number;
+  /** Delay between staged Worker readiness probes in milliseconds */
+  warmCdnReadinessProbeDelay?: number;
+  /** Promote even when staged CDN warmup cannot be completed */
+  dangerouslyPromoteOnCdnWarmError?: boolean;
+  /** Promote the warmed Worker version to 100% traffic (default: true) */
+  warmCdnPromote?: boolean;
+  /** Delay between successful warmup and promotion in milliseconds */
+  warmCdnPromotionDelay?: number;
   /** Include PPR fallback-shell placeholder paths during CDN warmup */
   warmCdnIncludeFallbacks?: boolean;
   /** Enable experimental TPR (Traffic-aware Pre-Rendering) */
@@ -51,13 +81,26 @@ declare function parseDeployArgs(args: string[]): {
   config: string | undefined;
   skipBuild: boolean;
   dryRun: boolean;
+  verbose: boolean;
   prerenderAll: boolean;
   prerenderConcurrency: number | undefined;
   warmCdnCache: boolean;
+  warmCdnTarget: string | undefined;
   warmCdnConcurrency: number | undefined;
   warmCdnTimeout: number | undefined;
   warmCdnRetries: number | undefined;
-  warmCdnStrict: boolean;
+  warmCdnDiscoveryTimeout: number | undefined;
+  warmCdnDiscoveryRetries: number | undefined;
+  warmCdnProbeTimeout: number | undefined;
+  warmCdnProbeRetries: number | undefined;
+  warmCdnCertify: boolean;
+  warmCdnReadinessTimeout: number | undefined;
+  warmCdnReadinessRetries: number | undefined;
+  warmCdnReadinessProbes: number | undefined;
+  warmCdnReadinessProbeDelay: number | undefined;
+  dangerouslyPromoteOnCdnWarmError: boolean;
+  warmCdnPromote: boolean;
+  warmCdnPromotionDelay: number | undefined;
   warmCdnIncludeFallbacks: boolean;
   experimentalTPR: boolean;
   tprCoverage: number | undefined;
@@ -115,13 +158,25 @@ declare function runWranglerKVBulkPut(root: string, options: {
   tempDir?: string;
 }, execute?: typeof spawn, nodeExecutable?: string): Promise<void>;
 declare function runWranglerDeploy(root: string, options: Pick<DeployOptions, "preview" | "env" | "name" | "config">, execute?: typeof spawn): Promise<string>;
-declare function deployWithCdnWarmup(root: string, paths: readonly string[], options: Pick<DeployOptions, "preview" | "env" | "name" | "config" | "warmCdnConcurrency" | "warmCdnTimeout" | "warmCdnRetries" | "warmCdnStrict">): Promise<string>;
+declare function hasCdnWarmRequests(plan: Omit<CdnWarmRequestPlan, "pagesDataPaths"> & {
+  pagesDataPaths?: readonly string[];
+}): boolean;
+declare function projectRequiresRouteCacheabilityProbeManifest(project: Pick<ProjectInfo, "isAppRouter" | "isPagesRouter">, cacheConfig: VinextCacheConfig | null): boolean;
+type CdnWarmDeployOptions = Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose" | "warmCdnTarget" | "warmCdnConcurrency" | "warmCdnTimeout" | "warmCdnRetries" | "warmCdnDiscoveryTimeout" | "warmCdnDiscoveryRetries" | "warmCdnProbeTimeout" | "warmCdnProbeRetries" | "warmCdnCertify" | "warmCdnReadinessTimeout" | "warmCdnReadinessRetries" | "warmCdnReadinessProbes" | "warmCdnReadinessProbeDelay" | "dangerouslyPromoteOnCdnWarmError" | "warmCdnPromote" | "warmCdnPromotionDelay"> & Pick<CdnWarmOptions, "deploymentId" | "expectedBuildId" | "expectedRscBuildId" | "loadingShellPaths" | "pagesDataPaths" | "routeHandlerPaths" | "routePatterns" | "rscPaths"> & {
+  /** Probe a staged Worker and upload the resulting manifest as a second version. */
+  cacheabilityProbe?: boolean;
+  discoverWarmPlan?: (target: {
+    headers?: HeadersInit;
+    targetUrl: string;
+  }) => Promise<PrerenderWarmPlan>;
+};
+declare function deployWithCdnWarmup(root: string, paths: readonly string[], options: CdnWarmDeployOptions): Promise<string>;
 declare function resolveCdnWarmupTargetUrl(root: string, deployedUrl: string | null): string | null;
-declare function resolveCdnWarmupTargetUrl(root: string, deployedUrl: string | null, options: Pick<DeployOptions, "preview" | "env" | "config">): string | null;
+declare function resolveCdnWarmupTargetUrl(root: string, deployedUrl: string | null, options: Pick<DeployOptions, "preview" | "env" | "config" | "warmCdnTarget">): string | null;
 declare function getZeroPercentStagingTraffic(deployment: WranglerDeploymentStatus | null, versionId: string): WranglerVersionTraffic[] | null;
 type ParsedWranglerConfig = NonNullable<ReturnType<typeof parseWranglerConfig>>;
 declare function resolveWorkerNameForVersionOverride(config: ParsedWranglerConfig | null, options: Pick<DeployOptions, "preview" | "env" | "name">): string | undefined;
 declare function buildVersionOverrideHeaders(workerName: string | undefined, versionId: string): HeadersInit | undefined;
 declare function deploy(options: DeployOptions): Promise<void>;
 //#endregion
-export { DeployOptions, buildNodeCliInvocation, buildVersionOverrideHeaders, buildWranglerDeployArgs, buildWranglerInvocation, buildWranglerKVBulkPutArgs, deploy, deployWithCdnWarmup, getZeroPercentStagingTraffic, parseDeployArgs, resolveCdnWarmupTargetUrl, resolveWorkerNameForVersionOverride, resolveWranglerBin, runWranglerDeploy, runWranglerKVBulkPut, validateWranglerEnvName, withCloudflareEnv };
+export { DEFAULT_CDN_WARM_PROMOTION_DELAY_MS, DeployOptions, buildNodeCliInvocation, buildVersionOverrideHeaders, buildWranglerDeployArgs, buildWranglerInvocation, buildWranglerKVBulkPutArgs, deploy, deployWithCdnWarmup, getZeroPercentStagingTraffic, hasCdnWarmRequests, parseDeployArgs, projectRequiresRouteCacheabilityProbeManifest, resolveCdnWarmupTargetUrl, resolveWorkerNameForVersionOverride, resolveWranglerBin, runWranglerDeploy, runWranglerKVBulkPut, validateWranglerEnvName, withCloudflareEnv };