Start pulling docker image after CLI install

If we start pulling docker image as a first thing in the setup process then `docker pull` consumes all the bandwidth and makes CLI download an order of magnitude longer.

If we start pulling image right after the install step it still takes advantage of time that user spends in the rest of setup steps.

Options considered: start `docker pull` right after CLI is downloaded. This way we could take advantage of time spent in another modal - global/local selection. Trade off is that passing image pull progress from/to runInstallProcess is adding complexity that is not justified with 2-3 seconds saved.

Author: tiurin

src/plugins/setup.ts

@@ -14,6 +14,7 @@ import {
 	activateLicenseUntilValid,
 } from "../utils/license.ts";
 import { minDelay } from "../utils/promises.ts";
+import { updateDockerImage } from "../utils/setup.ts";
 
 export default createPlugin(
 	"setup",
@@ -87,6 +88,14 @@ export default createPlugin(
 								}
 							}
 
+							let imagePulled = false;
+							const pullImageProcess = updateDockerImage(
+								outputChannel,
+								cancellationToken,
+							).then(() => {
+								imagePulled = true;
+							});
+
 							/////////////////////////////////////////////////////////////////////
 							progress.report({
 								message: "Verifying authentication...",
@@ -218,6 +227,15 @@ export default createPlugin(
 							});
 							await minDelay(Promise.resolve());
 
+							/////////////////////////////////////////////////////////////////////
+							if (!imagePulled) {
+								progress.report({
+									message:
+										"Waiting for the LocalStack docker image to finish downloading...",
+								});
+								await minDelay(pullImageProcess);
+							}
+
 							/////////////////////////////////////////////////////////////////////
 							window
 								.showInformationMessage("LocalStack is ready to start", {

src/utils/setup.ts

@@ -1,4 +1,4 @@
-import type { LogOutputChannel } from "vscode";
+import type { CancellationToken, LogOutputChannel } from "vscode";
 import * as z from "zod/v4-mini";
 
 import { checkIsAuthenticated } from "./authenticate.ts";
@@ -29,10 +29,11 @@ const LOCALSTACK_DOCKER_IMAGE = "localstack/localstack-pro";
 
 export async function updateDockerImage(
 	outputChannel: LogOutputChannel,
+	cancellationToken: CancellationToken,
 ): Promise<void> {
 	const imageVersion = await getDockerImageSemverVersion(outputChannel);
 	if (!imageVersion) {
-		await pullDockerImage(outputChannel);
+		await pullDockerImage(outputChannel, cancellationToken);
 	}
 }
 
@@ -79,11 +80,15 @@ async function getDockerImageSemverVersion(
 	return imageVersion;
 }
 
-async function pullDockerImage(outputChannel: LogOutputChannel): Promise<void> {
+async function pullDockerImage(
+	outputChannel: LogOutputChannel,
+	cancellationToken: CancellationToken,
+): Promise<void> {
 	try {
 		await spawn("docker", ["pull", LOCALSTACK_DOCKER_IMAGE], {
 			outputChannel,
 			outputLabel: "docker.pull",
+			cancellationToken: cancellationToken,
 		});
 	} catch (error) {
 		outputChannel.error("Could not pull LocalStack docker image");