feat: add --domain flag to deploy command for custom domains

- Add --domain flag (alias: --domains) to wrangler deploy command
- Convert domain strings to custom domain route format automatically
- Add comprehensive tests for domain flag functionality
- Validate domains using existing custom domain validation rules

Fixes #10215

Co-Authored-By: [email protected] <[email protected]>

Author: devin-ai-integration[bot]

.changeset/nine-onions-wonder.md

@@ -0,0 +1,5 @@
+---
+"wrangler": minor
+---
+
+Added `--domain` flag to `wrangler deploy` command for deploying to custom domains. Use `--domain example.com` to deploy directly to a custom domain without manually configuring routes.

packages/wrangler/src/__tests__/deploy.test.ts

@@ -1696,6 +1696,117 @@ Update them to point to this script instead?`,
 					'Publishing to Custom Domain "api.example.com" was skipped, fix conflict and try again'
 				);
 			});
+			it("should deploy domains passed via --domain flag as custom domains", async () => {
+				writeWranglerConfig({});
+				writeWorkerSource();
+				mockSubDomainRequest();
+				mockUpdateWorkerSubdomain({ enabled: false });
+				mockUploadWorkerRequest({ expectedType: "esm" });
+				mockCustomDomainsChangesetRequest({});
+				mockPublishCustomDomainsRequest({
+					publishFlags: {
+						override_scope: true,
+						override_existing_origin: false,
+						override_existing_dns_record: false,
+					},
+					domains: [{ hostname: "api.example.com" }],
+				});
+
+				await runWrangler("deploy ./index --domain api.example.com");
+				expect(std.out).toContain("api.example.com (custom domain)");
+			});
+
+			it("should deploy multiple domains passed via --domain flags", async () => {
+				writeWranglerConfig({});
+				writeWorkerSource();
+				mockSubDomainRequest();
+				mockUpdateWorkerSubdomain({ enabled: false });
+				mockUploadWorkerRequest({ expectedType: "esm" });
+				mockCustomDomainsChangesetRequest({});
+				mockPublishCustomDomainsRequest({
+					publishFlags: {
+						override_scope: true,
+						override_existing_origin: false,
+						override_existing_dns_record: false,
+					},
+					domains: [
+						{ hostname: "api.example.com" },
+						{ hostname: "app.example.com" },
+					],
+				});
+
+				await runWrangler(
+					"deploy ./index --domain api.example.com --domain app.example.com"
+				);
+				expect(std.out).toContain("api.example.com (custom domain)");
+				expect(std.out).toContain("app.example.com (custom domain)");
+			});
+
+			it("should combine --domain flags with existing routes configuration", async () => {
+				writeWranglerConfig({
+					routes: ["example.com/api/*"],
+				});
+				writeWorkerSource();
+				mockSubDomainRequest();
+				mockUpdateWorkerSubdomain({ enabled: false });
+				mockUploadWorkerRequest({ expectedType: "esm" });
+				mockCustomDomainsChangesetRequest({});
+				mockPublishCustomDomainsRequest({
+					publishFlags: {
+						override_scope: true,
+						override_existing_origin: false,
+						override_existing_dns_record: false,
+					},
+					domains: [{ hostname: "api.example.com" }],
+				});
+				// Mock the regular route deployment for the configured route
+				msw.use(
+					http.put(
+						"*/accounts/:accountId/workers/scripts/:scriptName/routes",
+						() => {
+							return HttpResponse.json(
+								{
+									success: true,
+									errors: [],
+									messages: [],
+									result: ["example.com/api/*"],
+								},
+								{ status: 200 }
+							);
+						},
+						{ once: true }
+					)
+				);
+
+				await runWrangler("deploy ./index --domain api.example.com");
+				expect(std.out).toContain("example.com/api/*");
+				expect(std.out).toContain("api.example.com (custom domain)");
+			});
+
+			it("should validate domain flags and reject invalid domains with wildcards", async () => {
+				writeWranglerConfig({});
+				writeWorkerSource();
+
+				await expect(runWrangler("deploy ./index --domain *.example.com"))
+					.rejects.toThrowErrorMatchingInlineSnapshot(`
+					[Error: Invalid Routes:
+					*.example.com:
+					Wildcard operators (*) are not allowed in Custom Domains]
+				`);
+			});
+
+			it("should validate domain flags and reject invalid domains with paths", async () => {
+				writeWranglerConfig({});
+				writeWorkerSource();
+
+				await expect(
+					runWrangler("deploy ./index --domain api.example.com/path")
+				).rejects.toThrowErrorMatchingInlineSnapshot(`
+					[Error: Invalid Routes:
+					api.example.com/path:
+					Paths are not allowed in Custom Domains]
+				`);
+			});
 		});
 
 		describe("deploy asset routes", () => {

packages/wrangler/src/deploy/deploy.ts

@@ -94,6 +94,7 @@ type Props = {
 	alias: Record<string, string> | undefined;
 	triggers: string[] | undefined;
 	routes: string[] | undefined;
+	domains: string[] | undefined;
 	legacyEnv: boolean | undefined;
 	jsxFactory: string | undefined;
 	jsxFragment: string | undefined;
@@ -416,8 +417,13 @@ See https://developers.cloudflare.com/workers/platform/compatibility-dates for m
 		);
 	}
 
-	const routes =
+	const configRoutes =
 		props.routes ?? config.routes ?? (config.route ? [config.route] : []) ?? [];
+	const domainRoutes = (props.domains || []).map((domain) => ({
+		pattern: domain,
+		custom_domain: true,
+	}));
+	const routes = [...configRoutes, ...domainRoutes];
 	validateRoutes(routes, props.assetsOptions);
 
 	const jsxFactory = props.jsxFactory || config.jsx_factory;
@@ -1050,7 +1056,10 @@ See https://developers.cloudflare.com/workers/platform/compatibility-dates for m
 	}
 
 	// deploy triggers
-	const targets = await triggersDeploy(props);
+	const targets = await triggersDeploy({
+		...props,
+		routes: routes,
+	});
 
 	logger.log("Current Version ID:", versionId);
 

packages/wrangler/src/deploy/index.ts

@@ -144,6 +144,13 @@ export const deployCommand = createCommand({
 			requiresArg: true,
 			array: true,
 		},
+		domains: {
+			describe: "Custom domains to deploy to",
+			alias: "domain",
+			type: "string",
+			requiresArg: true,
+			array: true,
+		},
 		"jsx-factory": {
 			describe: "The function that is called for each JSX element",
 			type: "string",
@@ -344,6 +351,7 @@ export const deployCommand = createCommand({
 			jsxFragment: args.jsxFragment,
 			tsconfig: args.tsconfig,
 			routes: args.routes,
+			domains: args.domains,
 			assetsOptions,
 			legacyAssetPaths: siteAssetPaths,
 			legacyEnv: isLegacyEnv(config),

packages/wrangler/src/triggers/deploy.ts

@@ -27,7 +27,7 @@ type Props = {
 	name: string | undefined;
 	env: string | undefined;
 	triggers: string[] | undefined;
-	routes: string[] | undefined;
+	routes: Route[] | undefined;
 	legacyEnv: boolean | undefined;
 	dryRun: boolean | undefined;
 	assetsOptions: AssetsOptions | undefined;