Improve send_raw_command UX and debug visibility

Author: Ted Roberts

custom_components/novastar_h/__init__.py

@@ -199,6 +199,13 @@ async def async_send_raw_command(call: ServiceCall) -> None:
             )
             return
 
+        _LOGGER.debug(
+            "send_raw_command host=%s endpoint=%s effective_body=%s",
+            resolved_host,
+            endpoint,
+            effective_body,
+        )
+
         result = await client_found.async_send_raw_command(endpoint, effective_body)
         if result is None:
             _LOGGER.warning("Raw command to %s failed", endpoint)

custom_components/novastar_h/manifest.json

@@ -21,5 +21,5 @@
     }
   ],
   "zeroconf": ["_novastar._tcp.local."],
-  "version": "0.2.61"
+  "version": "0.2.62"
 }

custom_components/novastar_h/services.yaml

@@ -1,17 +1,17 @@
 send_raw_command:
   name: Send Raw Command
-  description: Send a raw API command to the Novastar processor (requires "Allow Raw Commands" option in configuration).
+  description: Send a raw API command to the Novastar processor (requires "Allow Raw Commands" option in configuration). Host is optional when only one Novastar device is configured.
   fields:
     host:
       name: Host
-      description: The IP address of the Novastar processor to send the command to.
-      required: true
+      description: Optional IP address of the Novastar processor. Host is optional when only one Novastar device is configured.
+      required: false
       example: "192.168.1.100"
       selector:
         text:
     endpoint:
-      name: Endpoint
-      description: The API endpoint path (e.g., "device/readDetail", "screen/writeBrightness").
+      name: Command
+      description: The API command endpoint path (e.g., "device/readDetail", "screen/writeBrightness").
       required: true
       example: "device/readDetail"
       selector:

custom_components/novastar_h/strings.json

@@ -178,8 +178,8 @@
           "description": "The IP address of the Novastar processor."
         },
         "endpoint": {
-          "name": "Endpoint",
-          "description": "The API endpoint path (e.g., 'device/readDetail')."
+          "name": "Command",
+          "description": "The API command endpoint path (e.g., 'device/readDetail')."
         },
         "body": {
           "name": "Body",

custom_components/novastar_h/translations/en.json

@@ -178,8 +178,8 @@
           "description": "The IP address of the Novastar processor."
         },
         "endpoint": {
-          "name": "Endpoint",
-          "description": "The API endpoint path (e.g., 'device/readDetail')."
+          "name": "Command",
+          "description": "The API command endpoint path (e.g., 'device/readDetail')."
         },
         "body": {
           "name": "Body",