surface friendly license error for self-validating emulators (azure/snowflake)

Author: carole-lavillonniere

CLAUDE.md

@@ -63,7 +63,7 @@ When no config file exists, lstk creates one at `$HOME/.config/lstk/config.toml`
 Use `lstk config path` to print the resolved config file path currently in use.
 When adding a new command that depends on configuration, wire config initialization explicitly in that command (`PreRunE: initConfig`). Keep side-effect-free commands (e.g., `version`, `config path`) without config initialization.
 
-Created automatically on first run with defaults. Supports emulator types: `aws` and `snowflake`.
+Created automatically on first run with defaults. Supports emulator types: `aws`, `snowflake`, and `azure`.
 
 # Emulator Setup Commands
 

internal/container/start.go

@@ -385,10 +385,10 @@ func startContainers(ctx context.Context, rt runtime.Runtime, sink output.Sink,
 			sink.Emit(output.SpinnerStop())
 			errCode := telemetry.ErrCodeStartFailed
 			var licErr *licenseNotCoveredError
-			if errors.As(err, &licErr) && c.EmulatorType == config.EmulatorSnowflake {
+			if errors.As(err, &licErr) && c.EmulatorType.SelfValidatesLicense() {
 				errCode = telemetry.ErrCodeLicenseInvalid
 				sink.Emit(output.ErrorEvent{
-					Title: "Your license does not include the Snowflake emulator.",
+					Title: fmt.Sprintf("Your license does not include the %s emulator.", c.EmulatorType.ShortName()),
 					Actions: []output.ErrorAction{
 						{Label: "Sign up for a free trial:", Value: "https://app.localstack.cloud/sign-up"},
 						{Label: "Contact our team:", Value: "https://www.localstack.cloud/demo"},

internal/container/start_test.go

@@ -357,3 +357,49 @@ func TestStartContainers_SnowflakeLicenseError(t *testing.T) {
 		t.Fatal("no telemetry event received")
 	}
 }
+
+func TestStartContainers_AzureLicenseError(t *testing.T) {
+	ctrl := gomock.NewController(t)
+	mockRT := runtime.NewMockRuntime(ctrl)
+
+	c := runtime.ContainerConfig{
+		Image:         "localstack/localstack-azure-alpha:latest",
+		Name:          "localstack-azure",
+		EmulatorType:  config.EmulatorAzure,
+		Tag:           "latest",
+		Port:          "4566",
+		ContainerPort: "4566/tcp",
+		HealthPath:    "/_localstack/health",
+	}
+	const containerID = "abc123"
+	licenseLog := "The Azure emulator is currently not covered by your license."
+	mockRT.EXPECT().Start(gomock.Any(), c).Return(containerID, nil)
+	mockRT.EXPECT().IsRunning(gomock.Any(), containerID).Return(false, nil)
+	mockRT.EXPECT().Logs(gomock.Any(), containerID, 20).Return(licenseLog, nil)
+
+	tel, capturedEvents := newCapturingTelClient(t)
+
+	var out bytes.Buffer
+	sink := output.NewPlainSink(&out)
+
+	err := startContainers(context.Background(), mockRT, sink, tel, []runtime.ContainerConfig{c}, map[string]bool{})
+	tel.Close()
+
+	require.Error(t, err)
+	assert.True(t, output.IsSilent(err), "error should be silent since ErrorEvent was already emitted")
+	got := out.String()
+	assert.Contains(t, got, "Your license does not include the Azure emulator.")
+	assert.Contains(t, got, "https://app.localstack.cloud/sign-up")
+	assert.Contains(t, got, "https://www.localstack.cloud/demo")
+
+	select {
+	case ev := <-capturedEvents:
+		payload, ok := ev["payload"].(map[string]any)
+		require.True(t, ok, "telemetry event should have a payload map")
+		assert.Equal(t, telemetry.LifecycleStartError, payload["event_type"])
+		assert.Equal(t, telemetry.ErrCodeLicenseInvalid, payload["error_code"])
+		assert.Equal(t, "azure", payload["emulator"])
+	default:
+		t.Fatal("no telemetry event received")
+	}
+}