Add new message definitions for streaming events

Signed-off-by: Mathias L. Baumann <[email protected]>

Author: Marenz

RELEASE_NOTES.md

@@ -19,6 +19,7 @@
 - The enum `SensorErrorCode` has now been renamed to `SensorDiagnosticCode` to better reflect its shared usage with warnings and errors.
 - Added warnings to sensor `SensorState`.
 - Added a common `TimeIntervalFilter` message in `frequenz.api.common.v1.types` to standardize time interval filtering across APIs. This uses `start_time` (inclusive) and `end_time` (exclusive) fields, aligning with ISO 8601 and common programming conventions.
+- Added new message definitions for streaming events (Deleted, Created, Updated)
 
 ## Bug Fixes
 

proto/frequenz/api/common/v1/streaming/event.proto

@@ -0,0 +1,26 @@
+// Possible streaming events
+//
+// Copyright 2025 Frequenz Energy-as-a-Service GmbH
+//
+// Licensed under the MIT License (the "License");
+// you may not use this file except in compliance with the License.
+
+syntax = "proto3";
+
+package frequenz.api.common.v1.streaming;
+
+// This enum message is used to inform receivers of events what kind of
+// event they just received
+enum Event {
+  // Default, unspecified event
+  EVENT_UNSPECIFIED = 0;
+
+  // A new dispatch has been created
+  EVENT_CREATED = 1;
+
+  // An existing dispatch has been updated
+  EVENT_UPDATED = 2;
+
+  // An existing dispatch has been deleted
+  EVENT_DELETED = 3;
+}

py/frequenz/api/common/v1/streaming/__init__.py

@@ -0,0 +1,4 @@
+# License: MIT
+# Copyright © 2023 Frequenz Energy-as-a-Service GmbH
+
+"""Frequenz common gRPC API and bindings."""