📝 Add docstrings to fix/ws_open_chck (#84)

* 📝 Add docstrings to `fix/ws_open_chck`

Docstrings generation was requested by @JarbasAl.

* #83 (comment)

The following files were modified:

* `hivemind_bus_client/client.py`

* Update client.py

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: JarbasAI <[email protected]>

Author: coderabbitai[bot]

hivemind_bus_client/client.py

@@ -234,6 +234,12 @@ def on_close(self, *args):
         super().on_close(*args)
 
     def wait_for_handshake(self, timeout=5):
+        """
+        Waits for the HiveMind handshake to complete; if the handshake is not set and the websocket connection is open, starts the handshake, otherwise waits for the websocket to open and retries.
+        
+        Parameters:
+            timeout (float): Number of seconds to wait for each handshake or connection attempt before retrying.
+        """
         self.handshake_event.wait(timeout=timeout)
         if not self.handshake_event.is_set():
             if self.connected_event.is_set():
@@ -340,18 +346,19 @@ def _handle_hive_protocol(self, message: HiveMessage):
     def emit(self, message: Union[MycroftMessage, HiveMessage],
              binary_type: HiveMindBinaryPayloadType = HiveMindBinaryPayloadType.UNDEFINED):
         """
-        Send a HiveMessage or MycroftMessage to the HiveMind network, injecting routing context for BUS messages and optionally sending binary payloads.
-       
+        Send a HiveMind message (or wrap and send a MycroftMessage) and optionally transmit it as a binary payload.
+         
         Parameters:
-            message (MycroftMessage | HiveMessage): The message to send. If a MycroftMessage is provided it will be wrapped into a BUS HiveMessage.
-            binary_type (HiveMindBinaryPayloadType): When sending binary payloads, indicates the binary payload subtype; defaults to UNDEFINED.
-       
-        Notes:
-            - For messages with msg_type == HiveMessageType.BUS, the function will ensure the payload.context contains routing fields (source, platform, destination, session) and will emit the payload to the client's internal bus before sending.
-            - This method transmits the message over the client's WebSocket and may perform serialization, optional compression, and optional encryption depending on client configuration.
-       
+            message (MycroftMessage | HiveMessage): The outgoing message. A MycroftMessage will be wrapped into a BUS HiveMessage.
+            binary_type (HiveMindBinaryPayloadType): Binary payload subtype to use when sending BINARY messages; defaults to UNDEFINED.
+         
+        Behavior:
+            - For BUS messages, ensures payload.context contains routing fields (source, platform, destination, session_id, site_id) and emits the payload to the client's internal bus before sending.
+            - Chooses binary or text transport according to message type and client configuration; the payload may be compressed and/or encrypted based on client settings.
+         
         Raises:
-            ValueError: If the client has not been started with run_forever() and the connection is not ready.
+            ValueError: If the client has not been started (run_forever() not executed) and therefore cannot send messages.
+            RuntimeError: If the client was started but the websocket connection did not open within the wait period, preventing the message from being sent.
         """
         if isinstance(message, MycroftMessage):
             message = HiveMessage(msg_type=HiveMessageType.BUS,