update event callback signatures in documentation

docs/custom_plugins.md

@@ -28,21 +28,24 @@ its own variables to configure its behavior.
 Plugins that are defined in the`project.entry-points` are notified of events if the subclass 
 implements one or more of these methods:
 
-- `async def on_mqtt_packet_sent(self, packet: MQTTPacket[MQTTVariableHeader, MQTTPayload[MQTTVariableHeader], MQTTFixedHeader], session: Session | None = None) -> None`
-- `async def on_mqtt_packet_received(self, packet: MQTTPacket[MQTTVariableHeader, MQTTPayload[MQTTVariableHeader], MQTTFixedHeader], session: Session | None = None) -> None`
+- `async def on_mqtt_packet_sent(self, *, packet: MQTTPacket[MQTTVariableHeader, MQTTPayload[MQTTVariableHeader], MQTTFixedHeader], session: Session | None = None) -> None`
+- `async def on_mqtt_packet_received(self, *, packet: MQTTPacket[MQTTVariableHeader, MQTTPayload[MQTTVariableHeader], MQTTFixedHeader], session: Session | None = None) -> None`
 
-- `async def on_broker_pre_start() -> None`
-- `async def on_broker_post_start() -> None`
-- `async def on_broker_pre_shutdown() -> None`
-- `async def on_broker_post_shutdown() -> None`
+- `async def on_broker_pre_start(self) -> None`
+- `async def on_broker_post_start(self) -> None`
+- `async def on_broker_pre_shutdown(self) -> None`
+- `async def on_broker_post_shutdown(self) -> None`
 
 - `async def on_broker_client_connected(self, client_id:str, client_session:Session) -> None`
 - `async def on_broker_client_disconnected(self, client_id:str, client_session:Session) -> None`
 
-- `async def on_broker_client_subscribed(self, client_id: str, topic: str, qos: int) -> None`
-- `async def on_broker_client_unsubscribed(self, client_id: str, topic: str) -> None`
+- `async def on_broker_client_connected(self, *, client_id:str) -> None`
+- `async def on_broker_client_disconnected(self, *, client_id:str) -> None`
 
-- `async def on_broker_message_received(self, client_id: str, message: ApplicationMessage) -> None`
+- `async def on_broker_client_subscribed(self, *, client_id: str, topic: str, qos: int) -> None`
+- `async def on_broker_client_unsubscribed(self, *, client_id: str, topic: str) -> None`
+
+- `async def on_broker_message_received(self, *, client_id: str, message: ApplicationMessage) -> None`
 
 
 ## Authentication Plugins