@vinext/cloudflare 1.0.0-beta.10 → 1.0.0-beta.11

package/dist/deploy.d.ts

@@ -1,7 +1,7 @@
 import { CdnWarmOptions, CdnWarmRequestPlan, PrerenderWarmPlan } from "./cdn-warm.js";
 import { parseWranglerConfig } from "./wrangler-config.js";
 import { TrafficEntry } from "./tpr.js";
-import { WranglerDeploymentStatus, WranglerVersionTraffic } from "./version-deploy.js";
+import { WranglerDeploymentStatus, WranglerVersionTraffic, WranglerVersionUploadResult } from "./version-deploy.js";
 import { KVBulkPair } from "./prerender-kv-populate.js";
 import { spawn } from "node:child_process";
 import { VinextCacheConfig } from "vinext/internal/config/prerender";
@@ -74,6 +74,7 @@ export type DeployOptions = {
   /** TPR: analytics lookback window in hours (default: 24) */
   tprWindow?: number;
 };
+export type DeploymentTool = "cf" | "wrangler";
 export declare function parseDeployArgs(args: string[]): {
   help: boolean;
   preview: boolean;
@@ -121,16 +122,24 @@ 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>;
+export declare function resolveViteBuildMode(deploymentTool: DeploymentTool, env: string | undefined): string;
 type WranglerDeployArgs = {
   args: string[];
   env: string | undefined;
 };
+type CfDeployArgs = {
+  args: string[];
+  mode: string | undefined;
+};
 type WranglerKVBulkPutArgs = {
   args: string[];
   env: string | undefined;
 };
 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 buildWranglerKVBulkPutArgs(options: {
   binding: string;
   env?: string;
@@ -143,6 +152,7 @@ export declare function buildWranglerKVBulkPutArgs(options: {
  * shim and command shell that package managers create on Windows.
  */
 export declare function resolveWranglerBin(root: string, resolvePackageJson?: (root: string) => string | null): string;
+export declare function resolveCfBin(root: string, resolvePackageJson?: (root: string) => string | null): string;
 export declare function buildNodeCliInvocation(scriptPath: string, args: string[], nodeExecutable?: string): {
   file: string;
   args: string[];
@@ -152,8 +162,9 @@ export declare function buildWranglerInvocation(root: string, options: Pick<Depl
   args: string[];
   env: string | undefined;
 };
-export declare function runWranglerKVBulkPut(root: string, options: {
+export declare function runKVBulkPut(root: string, options: {
   binding: string;
+  deploymentTool: DeploymentTool;
   env?: string;
   pairs: KVBulkPair[];
   tempDir?: string;
@@ -161,12 +172,14 @@ export declare function runWranglerKVBulkPut(root: string, options: {
 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 hasCdnWarmRequests(plan: Omit<CdnWarmRequestPlan, "pagesDataPaths"> & {
   pagesDataPaths?: readonly string[];
 }): boolean;
 export declare function selectTPRWarmPlan(plan: PrerenderWarmPlan, traffic: readonly TrafficEntry[], coverage: number, limit: number): PrerenderWarmPlan;
 export 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" | "statusSource"> & {
+  deploymentTool?: DeploymentTool;
   /** Allow optional route selection to discover no warmable requests. */
   allowEmptyWarmPlan?: boolean;
   /** Probe a staged Worker and upload the resulting manifest as a second version. */
@@ -178,11 +191,15 @@ type CdnWarmDeployOptions = Pick<DeployOptions, "preview" | "env" | "name" | "co
   /** Narrow the final warm requests without changing discovery or probe metadata. */
   selectWarmPlan?: (plan: PrerenderWarmPlan) => PrerenderWarmPlan;
 };
+type DeploymentControlPlaneOptions = Pick<DeployOptions, "preview" | "env" | "name" | "config" | "verbose"> & {
+  deploymentTool?: DeploymentTool;
+};
 export declare function deployWithCdnWarmup(root: string, paths: readonly string[], options: CdnWarmDeployOptions): Promise<string>;
 export declare function resolveCdnWarmupTargetUrl(root: string, deployedUrl: string | null): string | null;
 export declare function resolveCdnWarmupTargetUrl(root: string, deployedUrl: string | null, options: Pick<DeployOptions, "preview" | "env" | "config" | "warmCdnTarget">): string | null;
 export declare function getZeroPercentStagingTraffic(deployment: WranglerDeploymentStatus | null, versionId: string): WranglerVersionTraffic[] | null;
 type ParsedWranglerConfig = NonNullable<ReturnType<typeof parseWranglerConfig>>;
+export declare function resolveDeploymentControlPlaneOptions(options: DeploymentControlPlaneOptions, upload: Pick<WranglerVersionUploadResult, "workerName">): DeploymentControlPlaneOptions;
 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>;