feat: add conversation events

Author: giancarloromeo

services/web/server/src/simcore_service_webserver/conversations/_conversation_message_service.py

@@ -16,12 +16,10 @@
 from models_library.rest_pagination import PageTotalCount
 from models_library.users import UserID
 
-from ..projects._groups_repository import list_project_groups
-from ..users._users_service import get_users_in_group
-
 # Import or define SocketMessageDict
 from ..users.api import get_user_primary_group_id
 from . import _conversation_message_repository
+from ._conversation_service import _get_recipients
 from ._socketio import (
     notify_conversation_message_created,
     notify_conversation_message_deleted,
@@ -31,16 +29,6 @@
 _logger = logging.getLogger(__name__)
 
 
-async def _get_recipients(app: web.Application, project_id: ProjectID) -> set[UserID]:
-    groups = await list_project_groups(app, project_id=project_id)
-    return {
-        user
-        for group in groups
-        if group.read
-        for user in await get_users_in_group(app, gid=group.gid)
-    }
-
-
 async def create_message(
     app: web.Application,
     *,

services/web/server/src/simcore_service_webserver/conversations/_conversation_service.py

@@ -16,12 +16,25 @@
 from models_library.rest_pagination import PageTotalCount
 from models_library.users import UserID
 
+from ..conversations._socketio import notify_conversation_created
+from ..projects._groups_repository import list_project_groups
+from ..users._users_service import get_users_in_group
 from ..users.api import get_user_primary_group_id
 from . import _conversation_repository
 
 _logger = logging.getLogger(__name__)
 
 
+async def _get_recipients(app: web.Application, project_id: ProjectID) -> set[UserID]:
+    groups = await list_project_groups(app, project_id=project_id)
+    return {
+        user
+        for group in groups
+        if group.read
+        for user in await get_users_in_group(app, gid=group.gid)
+    }
+
+
 async def create_conversation(
     app: web.Application,
     *,
@@ -37,7 +50,7 @@ async def create_conversation(
 
     _user_group_id = await get_user_primary_group_id(app, user_id=user_id)
 
-    return await _conversation_repository.create(
+    created_conversation = await _conversation_repository.create(
         app,
         name=name,
         project_uuid=project_uuid,
@@ -46,6 +59,15 @@ async def create_conversation(
         product_name=product_name,
     )
 
+    await notify_conversation_created(
+        app,
+        recipients=await _get_recipients(app, project_uuid),
+        project_id=project_uuid,
+        conversation=created_conversation,
+    )
+
+    return created_conversation
+
 
 async def get_conversation(
     app: web.Application,

services/web/server/src/simcore_service_webserver/conversations/_socketio.py

@@ -3,12 +3,15 @@
 
 from aiohttp import web
 from models_library.conversations import (
+    ConversationGetDB,
     ConversationID,
     ConversationMessageGetDB,
     ConversationMessageID,
     ConversationMessageType,
+    ConversationType,
 )
 from models_library.groups import GroupID
+from models_library.products import ProductName
 from models_library.projects import ProjectID
 from models_library.socketio import SocketMessageDict
 from models_library.users import UserID
@@ -20,6 +23,10 @@
 
 _MAX_CONCURRENT_SENDS: Final[int] = 3
 
+SOCKET_IO_CONVERSATION_CREATED_EVENT: Final[str] = "conversation:created"
+SOCKET_IO_CONVERSATION_DELETED_EVENT: Final[str] = "conversation:deleted"
+SOCKET_IO_CONVERSATION_UPDATED_EVENT: Final[str] = "conversation:updated"
+
 SOCKET_IO_CONVERSATION_MESSAGE_CREATED_EVENT: Final[str] = (
     "conversation:message:created"
 )
@@ -31,7 +38,30 @@
 )
 
 
-class BaseConversationMessage(BaseModel):
+class BaseEvent(BaseModel):
+    model_config = ConfigDict(
+        populate_by_name=True,
+        from_attributes=True,
+        alias_generator=AliasGenerator(
+            serialization_alias=to_camel,
+        ),
+    )
+
+
+class BaseConversationEvent(BaseEvent):
+    product_name: ProductName
+    project_id: ProjectID | None
+    user_group_id: GroupID
+    conversation_id: ConversationID
+    type: ConversationType
+
+
+class ConversationCreatedOrUpdatedEvent(BaseConversationEvent):
+    created: datetime.datetime
+    modified: datetime.datetime
+
+
+class BaseConversationMessageEvent(BaseEvent):
     conversation_id: ConversationID
     message_id: ConversationMessageID
     user_group_id: GroupID
@@ -46,13 +76,13 @@ class BaseConversationMessage(BaseModel):
     )
 
 
-class ConversationMessageCreatedOrUpdated(BaseConversationMessage):
+class ConversationMessageCreatedOrUpdatedEvent(BaseConversationMessageEvent):
     content: str
     created: datetime.datetime
     modified: datetime.datetime
 
 
-class ConversationMessageDeleted(BaseConversationMessage): ...
+class ConversationMessageDeletedEvent(BaseConversationMessageEvent): ...
 
 
 async def _send_message_to_recipients(
@@ -72,6 +102,26 @@ async def _send_message_to_recipients(
         ...
 
 
+async def notify_conversation_created(
+    app: web.Application,
+    *,
+    recipients: set[UserID],
+    project_id: ProjectID,
+    conversation: ConversationGetDB,
+) -> None:
+    notification_message = SocketMessageDict(
+        event_type=SOCKET_IO_CONVERSATION_CREATED_EVENT,
+        data={
+            "projectId": project_id,
+            **ConversationCreatedOrUpdatedEvent(**conversation.model_dump()).model_dump(
+                mode="json", by_alias=True
+            ),
+        },
+    )
+
+    await _send_message_to_recipients(app, recipients, notification_message)
+
+
 async def notify_conversation_message_created(
     app: web.Application,
     *,
@@ -83,7 +133,7 @@ async def notify_conversation_message_created(
         event_type=SOCKET_IO_CONVERSATION_MESSAGE_CREATED_EVENT,
         data={
             "projectId": project_id,
-            **ConversationMessageCreatedOrUpdated(
+            **ConversationMessageCreatedOrUpdatedEvent(
                 **conversation_message.model_dump()
             ).model_dump(mode="json", by_alias=True),
         },
@@ -104,7 +154,7 @@ async def notify_conversation_message_updated(
         event_type=SOCKET_IO_CONVERSATION_MESSAGE_UPDATED_EVENT,
         data={
             "projectId": project_id,
-            **ConversationMessageCreatedOrUpdated(
+            **ConversationMessageCreatedOrUpdatedEvent(
                 **conversation_message.model_dump()
             ).model_dump(mode="json", by_alias=True),
         },
@@ -127,7 +177,7 @@ async def notify_conversation_message_deleted(
         event_type=SOCKET_IO_CONVERSATION_MESSAGE_DELETED_EVENT,
         data={
             "projectId": project_id,
-            **ConversationMessageDeleted(
+            **ConversationMessageDeletedEvent(
                 conversation_id=conversation_id,
                 message_id=message_id,
                 user_group_id=user_group_id,