Improve gateway reliability and client e2e coverage

clients/python/src/mxgateway_cli/commands.py

@@ -150,6 +150,40 @@ def advise(**kwargs: Any) -> None:
     _run(_advise(**kwargs), output_json=kwargs["output_json"], secrets=_secrets(kwargs))
 
 
+@main.command("subscribe-bulk")
+@gateway_options
+@click.option("--session-id", required=True, help="Gateway session id.")
+@click.option("--server-handle", required=True, type=int, help="MXAccess server handle.")
+@click.option("--items", required=True, help="Comma-separated MXAccess item definitions.")
+@click.option("--correlation-id", default="", help="Client correlation id.")
+@click.option("--json", "output_json", is_flag=True, help="Emit JSON output.")
+def subscribe_bulk(**kwargs: Any) -> None:
+    """Invoke MXAccess SubscribeBulk."""
+
+    _run(
+        _subscribe_bulk(**kwargs),
+        output_json=kwargs["output_json"],
+        secrets=_secrets(kwargs),
+    )
+
+
+@main.command("unsubscribe-bulk")
+@gateway_options
+@click.option("--session-id", required=True, help="Gateway session id.")
+@click.option("--server-handle", required=True, type=int, help="MXAccess server handle.")
+@click.option("--item-handles", required=True, help="Comma-separated MXAccess item handles.")
+@click.option("--correlation-id", default="", help="Client correlation id.")
+@click.option("--json", "output_json", is_flag=True, help="Emit JSON output.")
+def unsubscribe_bulk(**kwargs: Any) -> None:
+    """Invoke MXAccess UnsubscribeBulk."""
+
+    _run(
+        _unsubscribe_bulk(**kwargs),
+        output_json=kwargs["output_json"],
+        secrets=_secrets(kwargs),
+    )
+
+
 @main.command("stream-events")
 @gateway_options
 @click.option("--session-id", required=True, help="Gateway session id.")
@@ -282,6 +316,28 @@ async def _advise(**kwargs: Any) -> dict[str, Any]:
         return {"ok": True}
 
 
+async def _subscribe_bulk(**kwargs: Any) -> dict[str, Any]:
+    async with await _connect(kwargs) as client:
+        session = _session(client, kwargs["session_id"])
+        results = await session.subscribe_bulk(
+            kwargs["server_handle"],
+            _parse_string_list(kwargs["items"]),
+            correlation_id=kwargs["correlation_id"],
+        )
+        return {"results": [_message_dict(result) for result in results]}
+
+
+async def _unsubscribe_bulk(**kwargs: Any) -> dict[str, Any]:
+    async with await _connect(kwargs) as client:
+        session = _session(client, kwargs["session_id"])
+        results = await session.unsubscribe_bulk(
+            kwargs["server_handle"],
+            _parse_int_list(kwargs["item_handles"]),
+            correlation_id=kwargs["correlation_id"],
+        )
+        return {"results": [_message_dict(result) for result in results]}
+
+
 async def _stream_events(**kwargs: Any) -> dict[str, Any]:
     async with await _connect(kwargs) as client:
         session = _session(client, kwargs["session_id"])
@@ -470,6 +526,20 @@ def _parse_datetime(raw_value: str) -> datetime:
     return parsed
 
 
+def _parse_string_list(raw_value: str) -> list[str]:
+    values = [item.strip() for item in raw_value.split(",") if item.strip()]
+    if not values:
+        raise click.BadParameter("at least one item is required", param_hint="--items")
+    return values
+
+
+def _parse_int_list(raw_value: str) -> list[int]:
+    values = [item.strip() for item in raw_value.split(",") if item.strip()]
+    if not values:
+        raise click.BadParameter("at least one item handle is required", param_hint="--item-handles")
+    return [int(item) for item in values]
+
+
 def _message_dict(message: Any) -> dict[str, Any]:
     return MessageToDict(
         message,