Update based on PR feedback

Author: WillTaylorDev

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

@@ -4446,7 +4446,7 @@ addEventListener('fetch', event => {});`
 			`);
 		});
 
-		it("should warn when using smart placement with assets-first", async () => {
+		it("should warn when using smart placement with Worker first", async () => {
 			const assets = [
 				{ filePath: ".assetsignore", content: "*.bak\nsub-dir" },
 				{ filePath: "file-1.txt", content: "Content of file-1" },
@@ -4456,10 +4456,13 @@ addEventListener('fetch', event => {});`
 				{ filePath: "sub-dir/file-5.txt", content: "Content of file-5" },
 			];
 			writeAssets(assets, "assets");
+			writeWorkerSource({ format: "js" });
 			writeWranglerConfig({
+				main: "index.js",
 				assets: {
 					directory: "assets",
-					experimental_serve_directly: true,
+					experimental_serve_directly: false,
+					binding: "ASSETS",
 				},
 				placement: {
 					mode: "smart",
@@ -4472,57 +4475,21 @@ addEventListener('fetch', event => {});`
 				expectedAssets: {
 					jwt: "<<aus-completion-token>>",
 					config: {
-						serve_directly: true,
+						serve_directly: false,
 					},
 				},
-				expectedType: "none",
+				expectedMainModule: "index.js",
+				expectedBindings: [{ name: "ASSETS", type: "assets" }],
 			});
 
 			await runWrangler("deploy");
 
 			expect(std.warn).toMatchInlineSnapshot(`
-				"[33m▲ [43;33m[[43;30mWARNING[43;33m][0m [1mUsing assets with smart placement turned on may result in poor performance.[0m
+				"[33m▲ [43;33m[[43;30mWARNING[43;33m][0m [1mTurning on Smart Placement in a Worker that is using assets and serve_directlyset tofalse means that your entire Worker could be moved to run closer to your data source, and all requests will go to that Worker before serving assets.[0m
 
-				"
-			`);
-		});
+				  This could result in poor performance as round trip times could increase when serving assets.
 
-		it("should warn when using smart placement with assets-first", async () => {
-			const assets = [
-				{ filePath: ".assetsignore", content: "*.bak\nsub-dir" },
-				{ filePath: "file-1.txt", content: "Content of file-1" },
-				{ filePath: "file-2.bak", content: "Content of file-2" },
-				{ filePath: "file-3.txt", content: "Content of file-3" },
-				{ filePath: "sub-dir/file-4.bak", content: "Content of file-4" },
-				{ filePath: "sub-dir/file-5.txt", content: "Content of file-5" },
-			];
-			writeAssets(assets, "assets");
-			writeWranglerConfig({
-				assets: {
-					directory: "assets",
-					experimental_serve_directly: true,
-				},
-				placement: {
-					mode: "smart",
-				},
-			});
-			const bodies: AssetManifest[] = [];
-			await mockAUSRequest(bodies);
-			mockSubDomainRequest();
-			mockUploadWorkerRequest({
-				expectedAssets: {
-					jwt: "<<aus-completion-token>>",
-					config: {
-						serve_directly: true,
-					},
-				},
-				expectedType: "none",
-			});
-
-			await runWrangler("deploy");
-
-			expect(std.warn).toMatchInlineSnapshot(`
-				"▲ [WARNING] Using assets with smart placement turned on may result in poor performance.
+				  Read more: https://developers.cloudflare.com/workers/static-assets/binding/#smart-placement
 
 				"
 			`);
@@ -4562,13 +4529,18 @@ addEventListener('fetch', event => {});`
 			await runWrangler("deploy");
 
 			expect(std.warn).toMatchInlineSnapshot(`
-				"▲ [WARNING] experimental_serve_directly=false but no assets.binding provided.
+				"▲ [WARNING] Assets are not accessible, as the [assets.experimental_serve_directly] configuration key is set to \`false\`, but no [assets.binding] configuration is provided.
+
+				  ❯❯ Add an assets binding to your assets configuration: binding = \\"ASSETS\\", or
+				  ❯❯ Set experimental_serve_directly=false in your assets configuration
+
+				  Read more: https://developers.cloudflare.com/workers/static-assets/binding/#binding
 
 				"
 			`);
 		});
 
-		it("should error if an experimental_serve_directly is false without providing a user Worker", async () => {
+		it("should error if experimental_serve_directly is false and no user Worker is provided", async () => {
 			writeWranglerConfig({
 				assets: {
 					directory: "xyz",

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

@@ -1720,13 +1720,18 @@ describe.sequential("wrangler dev", () => {
 			await runWranglerUntilConfig("dev");
 
 			expect(std.warn).toMatchInlineSnapshot(`
-				"▲ [WARNING] experimental_serve_directly=false but no assets.binding provided.
+				"▲ [WARNING] Assets are not accessible, as the [assets.experimental_serve_directly] configuration key is set to \`false\`, but no [assets.binding] configuration is provided.
+
+				  ❯❯ Add an assets binding to your assets configuration: binding = \\"ASSETS\\", or
+				  ❯❯ Set experimental_serve_directly=false in your assets configuration
+
+				  Read more: https://developers.cloudflare.com/workers/static-assets/binding/#binding
 
 				"
 			`);
 		});
 
-		it("should error if an experimental_serve_directly is false without providing a user Worker", async () => {
+		it("should error if experimental_serve_directly is false and no user Worker is provided", async () => {
 			writeWranglerConfig({
 				assets: { directory: "assets", experimental_serve_directly: false },
 			});

packages/wrangler/src/assets.ts

@@ -447,14 +447,16 @@ export function validateAssetsArgsAndConfig(
 	// Smart placement turned on when using assets
 	if (
 		config?.placement?.mode === "smart" &&
-		config?.assets?.experimental_serve_directly
+		config?.assets?.experimental_serve_directly === false
 	) {
 		logger.warn(
-			"Using assets with smart placement turned on may result in poor performance."
+			"Turning on Smart Placement in a Worker that is using assets and serve_directly set to false means that your entire Worker could be moved to run closer to your data source, and all requests will go to that Worker before serving assets.\n" +
+				"This could result in poor performance as round trip times could increase when serving assets.\n\n" +
+				"Read more: https://developers.cloudflare.com/workers/static-assets/binding/#smart-placement"
 		);
 	}
 
-	// User worker ahead of assets, but no assets binding provided
+	// User Worker ahead of assets, but no assets binding provided
 	if (
 		"legacy" in args
 			? args.assets?.assetConfig?.serve_directly === false &&
@@ -463,7 +465,10 @@ export function validateAssetsArgsAndConfig(
 				!config?.assets?.binding
 	) {
 		logger.warn(
-			"experimental_serve_directly=false but no assets.binding provided."
+			"Assets are not accessible, as the [assets.experimental_serve_directly] configuration key is set to `false`, but no [assets.binding] configuration is provided.\n" +
+				'❯❯ Add an assets binding to your assets configuration: binding = "ASSETS", or\n' +
+				"❯❯ Set experimental_serve_directly=false in your assets configuration\n\n" +
+				"Read more: https://developers.cloudflare.com/workers/static-assets/binding/#binding"
 		);
 	}