feat: add helpdesk channels and cases services

Author: svazquezco

mpt_api_client/mpt_client.py

@@ -8,11 +8,13 @@
     AsyncBilling,
     AsyncCatalog,
     AsyncCommerce,
+    AsyncHelpdesk,
     AsyncNotifications,
     Audit,
     Billing,
     Catalog,
     Commerce,
+    Helpdesk,
     Notifications,
 )
 
@@ -70,6 +72,11 @@ def notifications(self) -> AsyncNotifications:
         """Notifications MPT API Client."""
         return AsyncNotifications(http_client=self.http_client)
 
+    @property
+    def helpdesk(self) -> AsyncHelpdesk:
+        """Helpdesk MPT API Client."""
+        return AsyncHelpdesk(http_client=self.http_client)
+
 
 class MPTClient:
     """MPT API Client."""
@@ -128,3 +135,8 @@ def accounts(self) -> Accounts:
     def notifications(self) -> Notifications:
         """Notifications MPT API Client."""
         return Notifications(http_client=self.http_client)
+
+    @property
+    def helpdesk(self) -> Helpdesk:
+        """Helpdesk MPT API Client."""
+        return Helpdesk(http_client=self.http_client)

mpt_api_client/resources/__init__.py

@@ -3,6 +3,7 @@
 from mpt_api_client.resources.billing import AsyncBilling, Billing
 from mpt_api_client.resources.catalog import AsyncCatalog, Catalog
 from mpt_api_client.resources.commerce import AsyncCommerce, Commerce
+from mpt_api_client.resources.helpdesk import AsyncHelpdesk, Helpdesk
 from mpt_api_client.resources.notifications import AsyncNotifications, Notifications
 
 __all__ = [  # noqa: WPS410
@@ -12,10 +13,12 @@
     "AsyncBilling",
     "AsyncCatalog",
     "AsyncCommerce",
+    "AsyncHelpdesk",
     "AsyncNotifications",
     "Audit",
     "Billing",
     "Catalog",
     "Commerce",
+    "Helpdesk",
     "Notifications",
 ]

mpt_api_client/resources/helpdesk/__init__.py

@@ -0,0 +1,3 @@
+from mpt_api_client.resources.helpdesk.helpdesk import AsyncHelpdesk, Helpdesk
+
+__all__ = ["AsyncHelpdesk", "Helpdesk"]  # noqa: WPS410

mpt_api_client/resources/helpdesk/cases.py

@@ -0,0 +1,118 @@
+from mpt_api_client.http import AsyncService, Service
+from mpt_api_client.http.mixins import (
+    AsyncCollectionMixin,
+    AsyncCreateMixin,
+    AsyncGetMixin,
+    AsyncUpdateMixin,
+    CollectionMixin,
+    CreateMixin,
+    GetMixin,
+    UpdateMixin,
+)
+from mpt_api_client.models import Model, ResourceData
+
+
+class Case(Model):
+    """Helpdesk case resource."""
+
+
+class CasesServiceConfig:
+    """Cases service configuration."""
+
+    _endpoint = "/public/v1/helpdesk/cases"
+    _model_class = Case
+    _collection_key = "data"
+
+
+class CasesService(
+    CollectionMixin[Case],
+    CreateMixin[Case],
+    GetMixin[Case],
+    UpdateMixin[Case],
+    Service[Case],
+    CasesServiceConfig,
+):
+    """Cases service."""
+
+    def complete(self, resource_id: str, resource_data: ResourceData | None = None) -> Case:
+        """Switch case to complete state.
+
+        Args:
+            resource_id: Case resource ID
+            resource_data: Case data will be updated
+
+        Returns:
+            Updated case resource
+        """
+        return self._resource_action(resource_id, "POST", "complete", json=resource_data)
+
+    def process(self, resource_id: str, resource_data: ResourceData | None = None) -> Case:
+        """Switch case to process state.
+
+        Args:
+            resource_id: Case resource ID
+            resource_data: Case data will be updated
+
+        Returns:
+            Updated case resource
+        """
+        return self._resource_action(resource_id, "POST", "process", json=resource_data)
+
+    def query(self, resource_id: str, resource_data: ResourceData | None = None) -> Case:
+        """Switch case to query state.
+
+        Args:
+            resource_id: Case resource ID
+            resource_data: Case data will be updated
+
+        Returns:
+            Updated case resource
+        """
+        return self._resource_action(resource_id, "POST", "query", json=resource_data)
+
+
+class AsyncCasesService(
+    AsyncCollectionMixin[Case],
+    AsyncCreateMixin[Case],
+    AsyncGetMixin[Case],
+    AsyncUpdateMixin[Case],
+    AsyncService[Case],
+    CasesServiceConfig,
+):
+    """Async cases service."""
+
+    async def complete(self, resource_id: str, resource_data: ResourceData | None = None) -> Case:
+        """Switch case to complete state.
+
+        Args:
+            resource_id: Case resource ID
+            resource_data: Case data will be updated
+
+        Returns:
+            Updated case resource
+        """
+        return await self._resource_action(resource_id, "POST", "complete", json=resource_data)
+
+    async def process(self, resource_id: str, resource_data: ResourceData | None = None) -> Case:
+        """Switch case to process state.
+
+        Args:
+            resource_id: Case resource ID
+            resource_data: Case data will be updated
+
+        Returns:
+            Updated case resource
+        """
+        return await self._resource_action(resource_id, "POST", "process", json=resource_data)
+
+    async def query(self, resource_id: str, resource_data: ResourceData | None = None) -> Case:
+        """Switch case to query state.
+
+        Args:
+            resource_id: Case resource ID
+            resource_data: Case data will be updated
+
+        Returns:
+            Updated case resource
+        """
+        return await self._resource_action(resource_id, "POST", "query", json=resource_data)

mpt_api_client/resources/helpdesk/channels.py

@@ -0,0 +1,38 @@
+from mpt_api_client.http import AsyncService, Service
+from mpt_api_client.http.mixins import (
+    AsyncCollectionMixin,
+    AsyncManagedResourceMixin,
+    CollectionMixin,
+    ManagedResourceMixin,
+)
+from mpt_api_client.models import Model
+
+
+class Channel(Model):
+    """Helpdesk channel resource."""
+
+
+class ChannelsServiceConfig:
+    """Channels service configuration."""
+
+    _endpoint = "/public/v1/helpdesk/channels"
+    _model_class = Channel
+    _collection_key = "data"
+
+
+class ChannelsService(
+    CollectionMixin[Channel],
+    ManagedResourceMixin[Channel],
+    Service[Channel],
+    ChannelsServiceConfig,
+):
+    """Channels service."""
+
+
+class AsyncChannelsService(
+    AsyncCollectionMixin[Channel],
+    AsyncManagedResourceMixin[Channel],
+    AsyncService[Channel],
+    ChannelsServiceConfig,
+):
+    """Async channels service."""

mpt_api_client/resources/helpdesk/helpdesk.py

@@ -0,0 +1,37 @@
+from mpt_api_client.http import AsyncHTTPClient, HTTPClient
+from mpt_api_client.resources.helpdesk.cases import AsyncCasesService, CasesService
+from mpt_api_client.resources.helpdesk.channels import AsyncChannelsService, ChannelsService
+
+
+class Helpdesk:
+    """Helpdesk MPT API Module."""
+
+    def __init__(self, http_client: HTTPClient):
+        self.http_client = http_client
+
+    @property
+    def cases(self) -> CasesService:
+        """Cases service."""
+        return CasesService(http_client=self.http_client)
+
+    @property
+    def channels(self) -> ChannelsService:
+        """Channels service."""
+        return ChannelsService(http_client=self.http_client)
+
+
+class AsyncHelpdesk:
+    """Async Helpdesk MPT API Module."""
+
+    def __init__(self, http_client: AsyncHTTPClient):
+        self.http_client = http_client
+
+    @property
+    def cases(self) -> AsyncCasesService:
+        """Cases service."""
+        return AsyncCasesService(http_client=self.http_client)
+
+    @property
+    def channels(self) -> AsyncChannelsService:
+        """Channels service."""
+        return AsyncChannelsService(http_client=self.http_client)

tests/e2e/helpdesk/cases/test_async_cases.py

@@ -0,0 +1,11 @@
+import pytest
+
+pytestmark = [pytest.mark.flaky]
+
+
+async def test_list_cases(async_mpt_ops) -> None:
+    service = async_mpt_ops.helpdesk.cases
+
+    result = await service.fetch_page(limit=1)
+
+    assert result is not None

tests/e2e/helpdesk/cases/test_sync_cases.py

@@ -0,0 +1,11 @@
+import pytest
+
+pytestmark = [pytest.mark.flaky]
+
+
+def test_list_cases(mpt_ops) -> None:
+    service = mpt_ops.helpdesk.cases
+
+    result = service.fetch_page(limit=1)
+
+    assert result is not None

tests/e2e/helpdesk/channels/test_async_channels.py

@@ -0,0 +1,11 @@
+import pytest
+
+pytestmark = [pytest.mark.flaky]
+
+
+async def test_list_channels(async_mpt_ops) -> None:
+    service = async_mpt_ops.helpdesk.channels
+
+    result = await service.fetch_page(limit=1)
+
+    assert result is not None

tests/e2e/helpdesk/channels/test_sync_channels.py

@@ -0,0 +1,11 @@
+import pytest
+
+pytestmark = [pytest.mark.flaky]
+
+
+def test_list_channels(mpt_ops) -> None:
+    service = mpt_ops.helpdesk.channels
+
+    result = service.fetch_page(limit=1)
+
+    assert result is not None