refactor(api): rename list methods to streaming methods in assets.proto

Updated the RPC methods in assets.proto to use streaming for electrical components and connections, enhancing consistency with other APIs. Adjusted corresponding request and response message names in the proto file. Updated release notes to reflect these breaking changes.

Author: sandovalrr

RELEASE_NOTES.md

@@ -2,11 +2,8 @@
 
 ## Summary
 
+## Breaking Changes
 
-## Upgrading
-
-- Update the `frequenz-api-common` dependency 
-
-## New Features
+- Changed list methods to streaming methods to align with the rest of the APIs
 
 

proto/frequenz/api/assets/v1/assets.proto

@@ -25,14 +25,14 @@ service PlatformAssets {
   rpc GetMicrogrid(GetMicrogridRequest) returns (GetMicrogridResponse);
 
   // Returns list of a electrical components for a specific microgrid.
-  rpc ListMicrogridElectricalComponents(ListMicrogridElectricalComponentsRequest)
-    returns (ListMicrogridElectricalComponentsResponse);
+  rpc ReceiveMicrogridElectricalComponents(ReceiveMicrogridElectricalComponentsRequest)
+    returns (stream ReceiveMicrogridElectricalComponentsResponse);
 
   // Returns a list of the connections between electrical components for a
   // specific microgrid.
-  rpc ListMicrogridElectricalComponentConnections(
-    ListMicrogridElectricalComponentConnectionsRequest
-  ) returns (ListMicrogridElectricalComponentConnectionsResponse);
+  rpc ReceiveMicrogridElectricalComponentConnections(
+    ReceiveMicrogridElectricalComponentConnectionsRequest
+  ) returns (stream ReceiveMicrogridElectricalComponentConnectionsResponse);
 }
 
 // GetMicrogridRequest is the input parameter for fetching details
@@ -49,8 +49,8 @@ message GetMicrogridResponse {
   frequenz.api.common.v1alpha8.microgrid.Microgrid microgrid = 1;
 }
 
-// Request parameters for the RPC `ListMicrogridElectricalComponents`.
-message ListMicrogridElectricalComponentsRequest {
+// Request parameters for the RPC `ReceiveMicrogridElectricalComponents`.
+message ReceiveMicrogridElectricalComponentsRequest {
   // Mandatory field. The ID of the microgrid for which components
   // are to be listed.
   uint64 microgrid_id = 1;
@@ -63,15 +63,15 @@ message ListMicrogridElectricalComponentsRequest {
 }
 
 // A message containing a list of electrical components.
-message ListMicrogridElectricalComponentsResponse {
+message ReceiveMicrogridElectricalComponentsResponse {
   // Unique microgrid identifier used in the request.
   uint64 microgrid_id = 1;
 
   // List of electrical components matching the filter criteria.
   repeated frequenz.api.common.v1alpha8.microgrid.electrical_components.ElectricalComponent components = 2;
 }
 
-// ListMicrogridElectricalComponentConnectionsRequest is used for filtering and listing
+// ReceiveMicrogridElectricalComponentConnectionsRequest is used for filtering and listing
 // the electrical connections between components in a specific microgrid. 
 // These connections can be used to construct a component graph of the
 // microgrid.
@@ -94,7 +94,7 @@ message ListMicrogridElectricalComponentsResponse {
 //     destination_component_id. If these fields are left empty, connections with
 //     any source or destination will be returned.
 //
-message ListMicrogridElectricalComponentConnectionsRequest {
+message ReceiveMicrogridElectricalComponentConnectionsRequest {
   // Mandatory field. The ID of the microgrid
   // for which connections are to be listed.
   uint64 microgrid_id = 1;
@@ -108,10 +108,10 @@ message ListMicrogridElectricalComponentConnectionsRequest {
   repeated uint64 destination_component_ids = 3;
 }
 
-// ListMicrogridElectricalComponentConnectionsResponse holds the list of electrical
+// ReceiveMicrogridElectricalComponentConnectionsResponse holds the list of electrical
 // connections that match the filter criteria specified in the
-// ListMicrogridElectricalComponentConnectionsRequest.
-message ListMicrogridElectricalComponentConnectionsResponse {
+// ReceiveMicrogridElectricalComponentConnectionsRequest.
+message ReceiveMicrogridElectricalComponentConnectionsResponse {
   // The ID of the microgrid for which connections are returned.
   uint64 microgrid_id = 1;