docs: normalize & make basic corrections to documentation

2025-12-10 00:07:20 -06:00 · 2025-08-01 21:19:47 -05:00
parent e13fd6ab5b
commit 292879a8a9
28 changed files with 132 additions and 229 deletions
--- a/internal/services/alarm_control_panel.go
+++ b/internal/services/alarm_control_panel.go
@@ -8,9 +8,7 @@ type AlarmControlPanel struct {
 	conn *connect.HAConnection
 }

-// Send the alarm the command for arm away.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the alarm the command for arm away. Takes an entityId and an optional map that is translated into service_data.
 func (acp AlarmControlPanel) ArmAway(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "alarm_control_panel"
@@ -22,9 +20,7 @@ func (acp AlarmControlPanel) ArmAway(entityId string, serviceData ...map[string]
 	return acp.conn.WriteMessage(req)
 }

-// Send the alarm the command for arm away.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the alarm the command for arm away. Takes an entityId and an optional map that is translated into service_data.
 func (acp AlarmControlPanel) ArmWithCustomBypass(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "alarm_control_panel"
@@ -36,9 +32,7 @@ func (acp AlarmControlPanel) ArmWithCustomBypass(entityId string, serviceData ..
 	return acp.conn.WriteMessage(req)
 }

-// Send the alarm the command for arm home.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the alarm the command for arm home. Takes an entityId and an optional map that is translated into service_data.
 func (acp AlarmControlPanel) ArmHome(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "alarm_control_panel"
@@ -50,9 +44,7 @@ func (acp AlarmControlPanel) ArmHome(entityId string, serviceData ...map[string]
 	return acp.conn.WriteMessage(req)
 }

-// Send the alarm the command for arm night.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the alarm the command for arm night. Takes an entityId and an optional map that is translated into service_data.
 func (acp AlarmControlPanel) ArmNight(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "alarm_control_panel"
@@ -64,9 +56,7 @@ func (acp AlarmControlPanel) ArmNight(entityId string, serviceData ...map[string
 	return acp.conn.WriteMessage(req)
 }

-// Send the alarm the command for arm vacation.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the alarm the command for arm vacation. Takes an entityId and an optional map that is translated into service_data.
 func (acp AlarmControlPanel) ArmVacation(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "alarm_control_panel"
@@ -78,9 +68,7 @@ func (acp AlarmControlPanel) ArmVacation(entityId string, serviceData ...map[str
 	return acp.conn.WriteMessage(req)
 }

-// Send the alarm the command for disarm.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the alarm the command for disarm. Takes an entityId and an optional map that is translated into service_data.
 func (acp AlarmControlPanel) Disarm(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "alarm_control_panel"
@@ -92,9 +80,7 @@ func (acp AlarmControlPanel) Disarm(entityId string, serviceData ...map[string]a
 	return acp.conn.WriteMessage(req)
 }

-// Send the alarm the command for trigger.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the alarm the command for trigger. Takes an entityId and an optional map that is translated into service_data.
 func (acp AlarmControlPanel) Trigger(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "alarm_control_panel"
--- a/internal/services/cover.go
+++ b/internal/services/cover.go
@@ -44,8 +44,7 @@ func (c Cover) OpenTilt(entityId string) error {
 	return c.conn.WriteMessage(req)
 }

-// Move to specific position all or specified cover. Takes an entityId and an optional
-// map that is translated into service_data.
+// Move to specific position all or specified cover. Takes an entityId and an optional map that is translated into service_data.
 func (c Cover) SetPosition(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "cover"
@@ -57,8 +56,7 @@ func (c Cover) SetPosition(entityId string, serviceData ...map[string]any) error
 	return c.conn.WriteMessage(req)
 }

-// Move to specific position all or specified cover tilt. Takes an entityId and an optional
-// map that is translated into service_data.
+// Move to specific position all or specified cover tilt. Takes an entityId and an optional map that is translated into service_data.
 func (c Cover) SetTiltPosition(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "cover"
--- a/internal/services/event.go
+++ b/internal/services/event.go
@@ -17,8 +17,7 @@ type FireEventRequest struct {
 	EventData map[string]any `json:"event_data,omitempty"`
 }

-// Fire an event. Takes an event type and an optional map that is sent
-// as `event_data`.
+// Fire an event. Takes an event type and an optional map that is sent as `event_data`.
 func (e Event) Fire(eventType string, eventData ...map[string]any) error {
 	req := FireEventRequest{
 		Id:   internal.NextId(),
--- a/internal/services/home_assistant.go
+++ b/internal/services/home_assistant.go
@@ -8,8 +8,7 @@ type HomeAssistant struct {
 	conn *connect.HAConnection
 }

-// TurnOn a Home Assistant entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// TurnOn a Home Assistant entity. Takes an entityId and an optional map that is translated into service_data.
 func (ha *HomeAssistant) TurnOn(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "homeassistant"
@@ -21,8 +20,7 @@ func (ha *HomeAssistant) TurnOn(entityId string, serviceData ...map[string]any)
 	return ha.conn.WriteMessage(req)
 }

-// Toggle a Home Assistant entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// Toggle a Home Assistant entity. Takes an entityId and an optional map that is translated into service_data.
 func (ha *HomeAssistant) Toggle(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "homeassistant"
@@ -34,6 +32,7 @@ func (ha *HomeAssistant) Toggle(entityId string, serviceData ...map[string]any)
 	return ha.conn.WriteMessage(req)
 }

+// TurnOff turns off a Home Assistant entity.
 func (ha *HomeAssistant) TurnOff(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "homeassistant"
--- a/internal/services/input_boolean.go
+++ b/internal/services/input_boolean.go
@@ -8,6 +8,7 @@ type InputBoolean struct {
 	conn *connect.HAConnection
 }

+// TurnOn turns on an input boolean entity.
 func (ib InputBoolean) TurnOn(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "input_boolean"
@@ -16,6 +17,7 @@ func (ib InputBoolean) TurnOn(entityId string) error {
 	return ib.conn.WriteMessage(req)
 }

+// Toggle toggles an input boolean entity.
 func (ib InputBoolean) Toggle(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "input_boolean"
@@ -24,6 +26,7 @@ func (ib InputBoolean) Toggle(entityId string) error {
 	return ib.conn.WriteMessage(req)
 }

+// TurnOff turns off an input boolean entity.
 func (ib InputBoolean) TurnOff(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "input_boolean"
--- a/internal/services/input_button.go
+++ b/internal/services/input_button.go
@@ -8,6 +8,7 @@ type InputButton struct {
 	conn *connect.HAConnection
 }

+// Press presses an input button entity.
 func (ib InputButton) Press(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "input_button"
--- a/internal/services/input_text.go
+++ b/internal/services/input_text.go
@@ -8,6 +8,7 @@ type InputText struct {
 	conn *connect.HAConnection
 }

+// Set sets the value of an input text entity.
 func (ib InputText) Set(entityId string, value string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "input_text"
--- a/internal/services/light.go
+++ b/internal/services/light.go
@@ -8,8 +8,7 @@ type Light struct {
 	conn *connect.HAConnection
 }

-// TurnOn a light entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// TurnOn a light entity. Takes an entityId and an optional map that is translated into service_data.
 func (l Light) TurnOn(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "light"
@@ -21,8 +20,7 @@ func (l Light) TurnOn(entityId string, serviceData ...map[string]any) error {
 	return l.conn.WriteMessage(req)
 }

-// Toggle a light entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// Toggle a light entity. Takes an entityId and an optional map that is translated into service_data.
 func (l Light) Toggle(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "light"
@@ -34,6 +32,7 @@ func (l Light) Toggle(entityId string, serviceData ...map[string]any) error {
 	return l.conn.WriteMessage(req)
 }

+// TurnOff turns off a light entity.
 func (l Light) TurnOff(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "light"
--- a/internal/services/lock.go
+++ b/internal/services/lock.go
@@ -8,8 +8,7 @@ type Lock struct {
 	conn *connect.HAConnection
 }

-// Lock a lock entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// Lock a lock entity. Takes an entityId and an optional map that is translated into service_data.
 func (l Lock) Lock(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "lock"
@@ -21,8 +20,7 @@ func (l Lock) Lock(entityId string, serviceData ...map[string]any) error {
 	return l.conn.WriteMessage(req)
 }

-// Unlock a lock entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// Unlock a lock entity. Takes an entityId and an optional map that is translated into service_data.
 func (l Lock) Unlock(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "lock"
--- a/internal/services/media_player.go
+++ b/internal/services/media_player.go
@@ -8,8 +8,7 @@ type MediaPlayer struct {
 	conn *connect.HAConnection
 }

-// Send the media player the command to clear players playlist.
-// Takes an entityId.
+// Send the media player the command to clear players playlist. Takes an entityId.
 func (mp MediaPlayer) ClearPlaylist(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -18,9 +17,7 @@ func (mp MediaPlayer) ClearPlaylist(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Group players together. Only works on platforms with support for player groups.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Group players together. Only works on platforms with support for player groups. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) Join(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -32,8 +29,7 @@ func (mp MediaPlayer) Join(entityId string, serviceData ...map[string]any) error
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command for next track.
-// Takes an entityId.
+// Send the media player the command for next track. Takes an entityId.
 func (mp MediaPlayer) Next(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -42,8 +38,7 @@ func (mp MediaPlayer) Next(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command for pause.
-// Takes an entityId.
+// Send the media player the command for pause. Takes an entityId.
 func (mp MediaPlayer) Pause(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -52,8 +47,7 @@ func (mp MediaPlayer) Pause(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command for play.
-// Takes an entityId.
+// Send the media player the command for play. Takes an entityId.
 func (mp MediaPlayer) Play(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -62,8 +56,7 @@ func (mp MediaPlayer) Play(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Toggle media player play/pause state.
-// Takes an entityId.
+// Toggle media player play/pause state. Takes an entityId.
 func (mp MediaPlayer) PlayPause(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -72,8 +65,7 @@ func (mp MediaPlayer) PlayPause(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command for previous track.
-// Takes an entityId.
+// Send the media player the command for previous track. Takes an entityId.
 func (mp MediaPlayer) Previous(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -82,9 +74,7 @@ func (mp MediaPlayer) Previous(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command to seek in current playing media.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the media player the command to seek in current playing media. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) Seek(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -96,8 +86,7 @@ func (mp MediaPlayer) Seek(entityId string, serviceData ...map[string]any) error
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the stop command.
-// Takes an entityId.
+// Send the media player the stop command. Takes an entityId.
 func (mp MediaPlayer) Stop(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -106,9 +95,7 @@ func (mp MediaPlayer) Stop(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command for playing media.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Send the media player the command to play a media. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) PlayMedia(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -120,8 +107,7 @@ func (mp MediaPlayer) PlayMedia(entityId string, serviceData ...map[string]any)
 	return mp.conn.WriteMessage(req)
 }

-// Set repeat mode. Takes an entityId and an optional
-// map that is translated into service_data.
+// Set repeat mode. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) RepeatSet(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -133,9 +119,7 @@ func (mp MediaPlayer) RepeatSet(entityId string, serviceData ...map[string]any)
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command to change sound mode.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Select a sound mode. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) SelectSoundMode(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -147,9 +131,7 @@ func (mp MediaPlayer) SelectSoundMode(entityId string, serviceData ...map[string
 	return mp.conn.WriteMessage(req)
 }

-// Send the media player the command to change input source.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Select a source. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) SelectSource(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -161,9 +143,7 @@ func (mp MediaPlayer) SelectSource(entityId string, serviceData ...map[string]an
 	return mp.conn.WriteMessage(req)
 }

-// Set shuffling state.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Toggle shuffle state. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) Shuffle(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -175,8 +155,7 @@ func (mp MediaPlayer) Shuffle(entityId string, serviceData ...map[string]any) er
 	return mp.conn.WriteMessage(req)
 }

-// Toggles a media player power state.
-// Takes an entityId.
+// Toggle a media player on/off. Takes an entityId.
 func (mp MediaPlayer) Toggle(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -185,8 +164,7 @@ func (mp MediaPlayer) Toggle(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Turn a media player power off.
-// Takes an entityId.
+// Turn off a media player. Takes an entityId.
 func (mp MediaPlayer) TurnOff(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -195,8 +173,7 @@ func (mp MediaPlayer) TurnOff(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Turn a media player power on.
-// Takes an entityId.
+// Turn on a media player. Takes an entityId.
 func (mp MediaPlayer) TurnOn(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -205,9 +182,7 @@ func (mp MediaPlayer) TurnOn(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Unjoin the player from a group. Only works on
-// platforms with support for player groups.
-// Takes an entityId.
+// Separate a player from a group. Only works on platforms with support for player groups. Takes an entityId.
 func (mp MediaPlayer) Unjoin(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -216,8 +191,7 @@ func (mp MediaPlayer) Unjoin(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Turn a media player volume down.
-// Takes an entityId.
+// Send the media player the command for volume down. Takes an entityId.
 func (mp MediaPlayer) VolumeDown(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -226,9 +200,7 @@ func (mp MediaPlayer) VolumeDown(entityId string) error {
 	return mp.conn.WriteMessage(req)
 }

-// Mute a media player's volume.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Mute a media player. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) VolumeMute(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -240,9 +212,7 @@ func (mp MediaPlayer) VolumeMute(entityId string, serviceData ...map[string]any)
 	return mp.conn.WriteMessage(req)
 }

-// Set a media player's volume level.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Set volume level. Takes an entityId and an optional map that is translated into service_data.
 func (mp MediaPlayer) VolumeSet(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
@@ -254,8 +224,7 @@ func (mp MediaPlayer) VolumeSet(entityId string, serviceData ...map[string]any)
 	return mp.conn.WriteMessage(req)
 }

-// Turn a media player volume up.
-// Takes an entityId.
+// Send the media player the command for volume up. Takes an entityId.
 func (mp MediaPlayer) VolumeUp(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "media_player"
--- a/internal/services/scene.go
+++ b/internal/services/scene.go
@@ -20,8 +20,7 @@ func (s Scene) Apply(serviceData ...map[string]any) error {
 	return s.conn.WriteMessage(req)
 }

-// Create a scene entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// Create a scene entity. Takes an entityId and an optional map that is translated into service_data.
 func (s Scene) Create(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "scene"
@@ -42,8 +41,7 @@ func (s Scene) Reload() error {
 	return s.conn.WriteMessage(req)
 }

-// TurnOn a scene entity. Takes an entityId and an optional
-// map that is translated into service_data.
+// TurnOn a scene entity. Takes an entityId and an optional map that is translated into service_data.
 func (s Scene) TurnOn(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "scene"
--- a/internal/services/switch.go
+++ b/internal/services/switch.go
@@ -8,6 +8,7 @@ type Switch struct {
 	conn *connect.HAConnection
 }

+// TurnOn turns on a switch entity.
 func (s Switch) TurnOn(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "switch"
@@ -16,6 +17,7 @@ func (s Switch) TurnOn(entityId string) error {
 	return s.conn.WriteMessage(req)
 }

+// Toggle toggles a switch entity.
 func (s Switch) Toggle(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "switch"
@@ -24,6 +26,7 @@ func (s Switch) Toggle(entityId string) error {
 	return s.conn.WriteMessage(req)
 }

+// TurnOff turns off a switch entity.
 func (s Switch) TurnOff(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "switch"
--- a/internal/services/tts.go
+++ b/internal/services/tts.go
@@ -17,9 +17,7 @@ func (tts TTS) ClearCache() error {
 	return tts.conn.WriteMessage(req)
 }

-// Say something using text-to-speech on a media player with cloud.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Say something using text-to-speech on a media player with cloud. Takes an entityId and an optional map that is translated into service_data.
 func (tts TTS) CloudSay(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "tts"
@@ -31,9 +29,7 @@ func (tts TTS) CloudSay(entityId string, serviceData ...map[string]any) error {
 	return tts.conn.WriteMessage(req)
 }

-// Say something using text-to-speech on a media player with google_translate.
-// Takes an entityId and an optional
-// map that is translated into service_data.
+// Say something using text-to-speech on a media player with google_translate. Takes an entityId and an optional map that is translated into service_data.
 func (tts TTS) GoogleTranslateSay(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "tts"
--- a/internal/services/vacuum.go
+++ b/internal/services/vacuum.go
@@ -8,8 +8,7 @@ type Vacuum struct {
 	conn *connect.HAConnection
 }

-// Tell the vacuum cleaner to do a spot clean-up.
-// Takes an entityId.
+// Tell the vacuum cleaner to do a spot clean-up. Takes an entityId.
 func (v Vacuum) CleanSpot(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -18,8 +17,7 @@ func (v Vacuum) CleanSpot(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Locate the vacuum cleaner robot.
-// Takes an entityId.
+// Locate the vacuum cleaner robot. Takes an entityId.
 func (v Vacuum) Locate(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -28,8 +26,7 @@ func (v Vacuum) Locate(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Pause the cleaning task.
-// Takes an entityId.
+// Pause the cleaning task. Takes an entityId.
 func (v Vacuum) Pause(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -38,8 +35,7 @@ func (v Vacuum) Pause(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Tell the vacuum cleaner to return to its dock.
-// Takes an entityId.
+// Tell the vacuum cleaner to return to its dock. Takes an entityId.
 func (v Vacuum) ReturnToBase(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -48,8 +44,7 @@ func (v Vacuum) ReturnToBase(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Send a raw command to the vacuum cleaner. Takes an entityId and an optional
-// map that is translated into service_data.
+// Send a raw command to the vacuum cleaner. Takes an entityId and an optional map that is translated into service_data.
 func (v Vacuum) SendCommand(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -61,8 +56,7 @@ func (v Vacuum) SendCommand(entityId string, serviceData ...map[string]any) erro
 	return v.conn.WriteMessage(req)
 }

-// Set the fan speed of the vacuum cleaner. Takes an entityId and an optional
-// map that is translated into service_data.
+// Set the fan speed of the vacuum cleaner. Takes an entityId and an optional map that is translated into service_data.
 func (v Vacuum) SetFanSpeed(entityId string, serviceData ...map[string]any) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -75,8 +69,7 @@ func (v Vacuum) SetFanSpeed(entityId string, serviceData ...map[string]any) erro
 	return v.conn.WriteMessage(req)
 }

-// Start or resume the cleaning task.
-// Takes an entityId.
+// Start or resume the cleaning task. Takes an entityId.
 func (v Vacuum) Start(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -85,8 +78,7 @@ func (v Vacuum) Start(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Start, pause, or resume the cleaning task.
-// Takes an entityId.
+// Start, pause, or resume the cleaning task. Takes an entityId.
 func (v Vacuum) StartPause(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -95,8 +87,7 @@ func (v Vacuum) StartPause(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Stop the current cleaning task.
-// Takes an entityId.
+// Stop the current cleaning task. Takes an entityId.
 func (v Vacuum) Stop(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -105,8 +96,7 @@ func (v Vacuum) Stop(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Stop the current cleaning task and return to home.
-// Takes an entityId.
+// Stop the current cleaning task and return to home. Takes an entityId.
 func (v Vacuum) TurnOff(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"
@@ -115,8 +105,7 @@ func (v Vacuum) TurnOff(entityId string) error {
 	return v.conn.WriteMessage(req)
 }

-// Start a new cleaning task.
-// Takes an entityId.
+// Start a new cleaning task. Takes an entityId.
 func (v Vacuum) TurnOn(entityId string) error {
 	req := NewBaseServiceRequest(entityId)
 	req.Domain = "vacuum"