@void/deploy-cloudflare 0.20.3 → 0.21.1

package/dist/index.d.mts

@@ -107,6 +107,10 @@ type CloudflareFrameworkDeployConfig = Readonly<{
   assetsIgnore?: ReadonlyArray<string>;
   crons?: ReadonlyArray<string>;
   requiredSecrets?: ReadonlyArray<string>;
+  ai?: Readonly<{
+    binding: string;
+    gateway?: string;
+  }>;
 }>;
 /**
  * Point a standalone framework Worker at the canonical root Cloudflare state.
@@ -227,6 +231,8 @@ export declare function deployCloudflareVersionTriggers(options: {
   previousTriggerConfig?: CloudflareTriggerConfig;
   /** Wrangler skips an empty Custom Domain set, so the caller may publish it directly. */
   publishEmptyCustomDomains?: () => Promise<CloudflareCommandResult>;
+  /** cf skips an empty Cron Trigger set, so the caller may publish it directly. */
+  publishEmptyCrons?: () => Promise<CloudflareCommandResult>;
   manageRoutes?: boolean;
 }): Promise<CloudflareCommandResult>;
 type CloudflareTriggerStabilization = Readonly<{
@@ -256,10 +262,13 @@ export declare function stabilizeCloudflareVersionTriggers(options: {
   previousTriggerConfig?: CloudflareTriggerConfig;
   knownTriggerConfigs?: Readonly<Record<string, CloudflareTriggerConfig>>;
   publishEmptyCustomDomains?: () => Promise<CloudflareCommandResult>;
+  publishEmptyCrons?: () => Promise<CloudflareCommandResult>;
   manageRoutes?: boolean;
   attempts?: number;
 }): Promise<CloudflareTriggerStabilization>;
 type CloudflareVersionActivationOptions = {
+  /** Human-readable deployment phases; the caller owns terminal rendering. */
+  onProgress?: (message: string) => void;
   /** Reuse an inspected Worker without republishing its domains or other triggers. */
   preserveTriggers?: boolean;
   expectedPreviousVersionId?: string;
@@ -284,6 +293,7 @@ type CloudflareVersionActivationOptions = {
   message: string;
   /** Direct empty-domain publisher for the Wrangler reconciliation gap. */
   publishEmptyCustomDomains?: () => Promise<CloudflareCommandResult>;
+  publishEmptyCrons?: () => Promise<CloudflareCommandResult>;
   /** Last successfully published traffic state, newer than immutable version annotations. */
   previousTrafficConfig?: CloudflareTrafficConfig;
   /** Explicitly Void-owned queue consumers retained for schema-1 cleanup and failed retries. */
@@ -324,7 +334,7 @@ export declare function extractWorkersDevSubdomain(url: string): string | undefi
 //#region src/metadata.d.ts
 /**
  * Share one authenticated transport for the activator's read-only metadata calls.
- * Writes and unsupported commands retain the pinned Wrangler runner. Responses
+ * Writes and unsupported commands use the pinned cf command adapter. Responses
  * keep its JSON contract so activation and concurrency checks remain unchanged.
  */
 export declare function createCloudflareMetadataRunner(options: {
@@ -336,7 +346,7 @@ export declare function createCloudflareMetadataRunner(options: {
   getToken: () => Promise<string | null>;
   verifyUploader: () => boolean;
   fetch?: typeof globalThis.fetch;
-  /** Environment used to decide whether Wrangler's proxy-aware transport is required. */
+  /** Environment used to decide whether the CLI's proxy-aware transport is required. */
   env?: Readonly<Record<string, string | undefined>>;
 }): CloudflareCommandRunner;
 //#endregion

package/dist/index.mjs

@@ -541,6 +541,13 @@ function writeCloudflareFrameworkDeployConfig(options) {
 		if (required !== void 0 && (!Array.isArray(required) || !required.every((name) => typeof name === "string"))) throw new Error("Cloudflare framework config has a malformed secrets.required field.");
 		upsert(["secrets", "required"], [.../* @__PURE__ */ new Set([...required ?? [], ...options.requiredSecrets])]);
 	}
+	if (options.ai) {
+		const config = parse(content);
+		if (config.ai === void 0) upsert(["ai"], { binding: options.ai.binding });
+		const binding = typeof config.ai?.binding === "string" ? config.ai.binding : options.ai.binding;
+		if (binding !== "AI") upsert(["vars", "__VOID_AI_BINDING"], binding);
+		if (options.ai.gateway) upsert(["vars", "__VOID_AI_GATEWAY"], options.ai.gateway);
+	}
 	let changed = content !== initial;
 	if (changed) writeFileSync(options.configPath, content);
 	const pointer = `${JSON.stringify({
@@ -790,6 +797,10 @@ async function deployCloudflareVersionTriggers(options) {
 			options.workerName
 		], { capture: false });
 		if (!isCleanCommandExit(deployed)) return deployed;
+		if (options.triggerConfig.crons.length === 0 && options.publishEmptyCrons) {
+			const published = await options.publishEmptyCrons();
+			if (!isCleanCommandExit(published)) return published;
+		}
 		for (const queue of removedQueueConsumers(options.triggerConfig, options.previousTriggerConfig)) {
 			const removed = await options.runWrangler([
 				"queues",
@@ -807,7 +818,7 @@ async function deployCloudflareVersionTriggers(options) {
 			if (!options.publishEmptyCustomDomains) return {
 				status: 1,
 				stdout: "",
-				stderr: "Wrangler cannot publish an empty Custom Domain set and no direct publisher was available."
+				stderr: "Cloudflare could not publish an empty Custom Domain set and no direct publisher was available."
 			};
 			const published = await options.publishEmptyCustomDomains();
 			if (!isCleanCommandExit(published)) return published;
@@ -877,6 +888,7 @@ async function stabilizeCloudflareVersionTriggers(options) {
 			triggerConfig: activeTriggerConfig,
 			previousTriggerConfig: cleanupBaseline,
 			publishEmptyCustomDomains: options.publishEmptyCustomDomains,
+			publishEmptyCrons: options.publishEmptyCrons,
 			manageRoutes: options.manageRoutes
 		});
 		if (!isCleanCommandExit(triggers)) return {
@@ -1109,6 +1121,7 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 		ok: false,
 		reason: "uploader-changed"
 	};
+	options.onProgress?.("Checking the current Worker deployment...");
 	const previous = await readCurrentProductionVersion(options, commonArgs);
 	if (previous.kind === "failed") return {
 		ok: false,
@@ -1201,6 +1214,7 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 	} : versionedPreviousTriggerConfig;
 	const previousTriggerConfig = triggerConfigWithQueueConsumerCleanup(versionedPreviousTriggerConfigWithTraffic, options.queueConsumerCleanup);
 	const alias = `void-ready-${Date.now().toString(36)}`;
+	options.onProgress?.("Uploading the Worker and assets...");
 	const upload = await Promise.resolve(options.runWrangler([
 		"versions",
 		"upload",
@@ -1240,6 +1254,7 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 		ok: false,
 		reason: "upload-output-invalid"
 	};
+	options.onProgress?.("Verifying the uploaded Worker...");
 	if (inheritanceBaseline) {
 		const recent = await readRecentCloudflareVersionIds(options, commonArgs);
 		const previousLatest = inheritanceBaseline.at(-1);
@@ -1306,6 +1321,7 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 		};
 		stagedVersionOverride = true;
 	}
+	options.onProgress?.("Waiting for the Worker to become ready...");
 	let ready = await probeReadiness(`${readinessUrl.replace(/\/$/, "")}/__void/ready`, options.workerName, readinessUsesCustomRoute ? void 0 : options.readinessHeaders, authenticatedWorkersDevSubdomain, stagedVersionOverride ? versionId : void 0, options.fetch ?? globalThis.fetch, options.sleep ?? defaultSleep, options.readinessAttempts ?? 6);
 	if (ready === "access-denied" && !stagedVersionOverride && previous.versionId !== null) {
 		const stableReadinessUrl = desiredTriggerConfig.workers_dev ? workersDevReadinessUrl(options.workerName, extractWorkersDevSubdomain(readinessUrl) ?? options.workersDevSubdomain) : customRouteReadinessUrl(desiredTriggerConfig.routes);
@@ -1376,6 +1392,7 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 		rollback: "not-needed",
 		triggerRepair: "succeeded"
 	};
+	options.onProgress?.("Activating the Worker...");
 	const activate = await deployVersionPercentages(options, commonArgs, [`${versionId}@100`], message);
 	if (!isCleanCommandExit(activate)) return {
 		ok: false,
@@ -1416,6 +1433,7 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 	}
 	const knownTriggerConfigs = { [versionId]: desiredTriggerConfig };
 	if (previous.versionId && previousTriggerConfig) knownTriggerConfigs[previous.versionId] = previousTriggerConfig;
+	options.onProgress?.("Updating routes and triggers...");
 	const triggers = await stabilizeCloudflareVersionTriggers({
 		runWrangler: options.runWrangler,
 		workerName: options.workerName,
@@ -1424,7 +1442,8 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 		targetTriggerConfig: desiredTriggerConfig,
 		previousTriggerConfig,
 		knownTriggerConfigs,
-		publishEmptyCustomDomains: options.publishEmptyCustomDomains
+		publishEmptyCustomDomains: options.publishEmptyCustomDomains,
+		publishEmptyCrons: options.publishEmptyCrons
 	});
 	if (!triggers.ok) {
 		if (triggers.activeVersionId && triggers.activeVersionId !== versionId) return {
@@ -1463,7 +1482,8 @@ async function activateCloudflareVersionWithSecretsFile(options) {
 				targetTriggerConfig: desiredTriggerConfig,
 				previousTriggerConfig,
 				knownTriggerConfigs,
-				publishEmptyCustomDomains: options.publishEmptyCustomDomains
+				publishEmptyCustomDomains: options.publishEmptyCustomDomains,
+				publishEmptyCrons: options.publishEmptyCrons
 			});
 			return {
 				ok: false,
@@ -1532,7 +1552,8 @@ async function restorePreviousVersionAndTriggers(options, commonArgs, previousVe
 		targetTriggerConfig,
 		previousTriggerConfig: failedTriggerConfig,
 		knownTriggerConfigs: { [previousVersionId]: targetTriggerConfig },
-		publishEmptyCustomDomains: options.publishEmptyCustomDomains
+		publishEmptyCustomDomains: options.publishEmptyCustomDomains,
+		publishEmptyCrons: options.publishEmptyCrons
 	});
 	return triggers.ok && triggers.targetOwnsTraffic ? "succeeded" : "failed";
 }
@@ -1664,6 +1685,7 @@ async function bootstrapFirstDeployment(options, commonArgs, previousVersionId)
 		ok: false,
 		reason: "uploader-changed"
 	};
+	options.onProgress?.("Publishing the first Worker deployment...");
 	const bootstrap = await Promise.resolve(options.runWrangler([
 		"deploy",
 		...commonArgs,
@@ -1702,6 +1724,7 @@ async function bootstrapFirstDeployment(options, commonArgs, previousVersionId)
 		...versionId ? { versionId } : {}
 	};
 	const previewUrl = publishedCloudflareUrl(options.workerName, desiredTriggerConfig, reportedOrConfiguredUrl);
+	options.onProgress?.("Waiting for the Worker to become ready...");
 	const ready = await probeReadiness(`${previewUrl.replace(/\/$/, "")}/__void/ready`, options.workerName, reportedUrl || desiredTriggerConfig.workers_dev ? options.readinessHeaders : void 0, extractWorkersDevSubdomain(previewUrl), void 0, options.fetch ?? globalThis.fetch, options.sleep ?? defaultSleep, options.readinessAttempts ?? 30, 6e4);
 	if (ready !== "ready") return {
 		ok: false,
@@ -1970,7 +1993,7 @@ function defaultSleep(milliseconds) {
 //#region src/metadata.ts
 /**
 * Share one authenticated transport for the activator's read-only metadata calls.
-* Writes and unsupported commands retain the pinned Wrangler runner. Responses
+* Writes and unsupported commands use the pinned cf command adapter. Responses
 * keep its JSON contract so activation and concurrency checks remain unchanged.
 */
 function createCloudflareMetadataRunner(options) {
@@ -1985,7 +2008,7 @@ function createCloudflareMetadataRunner(options) {
 	const prefix = `${options.apiBaseUrl.replace(/\/$/, "")}/accounts/${encodeURIComponent(options.accountId)}/workers/scripts/${encodeURIComponent(options.workerName)}`;
 	const fetcher = options.fetch ?? globalThis.fetch;
 	const proxyEnv = options.env ?? process.env;
-	const requiresWranglerProxy = Boolean(proxyEnv.https_proxy || proxyEnv.HTTPS_PROXY || proxyEnv.http_proxy || proxyEnv.HTTP_PROXY);
+	const requiresProxyTransport = Boolean(proxyEnv.https_proxy || proxyEnv.HTTPS_PROXY || proxyEnv.http_proxy || proxyEnv.HTTP_PROXY);
 	const refused = {
 		status: 1,
 		stdout: "",
@@ -2011,7 +2034,7 @@ function createCloudflareMetadataRunner(options) {
 			rest = args.slice(3);
 		}
 		if (!kind || !runOptions.capture || rest.length !== common.length || rest.some((value, i) => value !== common[i])) return fallback(args, runOptions);
-		if (requiresWranglerProxy) return fallback(args, runOptions);
+		if (requiresProxyTransport) return fallback(args, runOptions);
 		let response;
 		try {
 			if (!tokenPromise && !options.verifyUploader()) return refused;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void/deploy-cloudflare",
-  "version": "0.20.3",
+  "version": "0.21.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voidzero-dev/void.git",
@@ -20,7 +20,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@void/deploy-core": "0.20.3",
+    "@void/deploy-core": "0.21.1",
     "jsonc-parser": "3.3.1"
   },
   "devDependencies": {