codemie-sdk-python 0.1.589__tar.gz → 0.1.591__tar.gz

{codemie_sdk_python-0.1.589 → codemie_sdk_python-0.1.591}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codemie-sdk-python
-Version: 0.1.589
+Version: 0.1.591
 Summary: CodeMie SDK for Python
 Author: Vadym Vlasenko
 Author-email: vadym_vlasenko@epam.com

{codemie_sdk_python-0.1.589 → codemie_sdk_python-0.1.591}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "codemie-sdk-python"
-version = "0.1.589"
+version = "0.1.591"
 description = "CodeMie SDK for Python"
 authors = [
     "Vadym Vlasenko <vadym_vlasenko@epam.com>",

{codemie_sdk_python-0.1.589 → codemie_sdk_python-0.1.591}/src/codemie_sdk/__init__.py

@@ -94,6 +94,7 @@ from .models.analytics import (
     AnalyticsQueryParams,
     PaginatedAnalyticsQueryParams,
 )
+from .services.customer_config_service import CustomerConfigService
 from .services.vendor_assistant import VendorAssistantService
 from .services.vendor_workflow import VendorWorkflowService
 from .services.vendor_knowledgebase import VendorKnowledgeBaseService
@@ -252,6 +253,7 @@ __all__ = [
     "AnalyticsQueryParams",
     "PaginatedAnalyticsQueryParams",
     "AnalyticsService",
+    "CustomerConfigService",
     "MermaidDiagramRequest",
     "MermaidDiagramResponse",
     "ContentType",

{codemie_sdk_python-0.1.589 → codemie_sdk_python-0.1.591}/src/codemie_sdk/client/client.py

@@ -28,6 +28,7 @@ from ..services.activity_event import ActivityEventService
 from ..services.codemie_guardrails import CodemieGuardrailService
 from ..services.dynamic_config import DynamicConfigService
 from ..services.mcp_configs import MCPConfigsService
+from ..services.customer_config_service import CustomerConfigService
 
 
 class CodeMieClient:
@@ -169,6 +170,9 @@ class CodeMieClient:
         self.dynamic_config = DynamicConfigService(
             self._api_domain, _token_source, verify_ssl=self._verify_ssl
         )
+        self.customer_config = CustomerConfigService(
+            self._api_domain, _token_source, verify_ssl=self._verify_ssl
+        )
 
     @property
     def token(self) -> str:

codemie_sdk_python-0.1.591/src/codemie_sdk/services/customer_config_service.py

@@ -0,0 +1,105 @@
+"""Customer config service implementation.
+
+Wraps four endpoints introduced in EPMCDME-13983:
+  GET  /v1/config/declarations            — list dynamic-config declarations (admin/maintainer)
+  PUT  /v1/config/declarations/{id}       — save override settings for a component
+  DELETE /v1/config/declarations/{id}     — reset component to YAML default (idempotent)
+  GET  /v1/config                         — merged component values (anonymous)
+"""
+
+from ..utils.http import ApiRequestHandler, TokenSource
+
+
+class CustomerConfigService:
+    """Service for managing customer configuration overrides via the admin endpoint."""
+
+    def __init__(self, api_domain: str, token: TokenSource, verify_ssl: bool = True):
+        """Initialize the customer config service.
+
+        Args:
+            api_domain: Base URL for the CodeMie API
+            token: Authentication token source
+            verify_ssl: Whether to verify SSL certificates. Default: True
+        """
+        self._api = ApiRequestHandler(api_domain, token, verify_ssl)
+
+    def list_declarations(self) -> list[dict]:
+        """GET /v1/config/declarations — list all registered setting declarations.
+
+        Requires admin or maintainer role.  Read path bypasses the TTL cache so
+        the response always reflects the current DB state.
+
+        Returns:
+            List of declaration dicts, each containing:
+            ``component_id``, ``label``, ``description``, ``overridden``,
+            ``value`` (current merged value), ``fields`` (field metadata).
+
+        Raises:
+            requests.HTTPError: On non-2xx response (e.g. 403 for non-admin).
+        """
+        return self._api.get(
+            "/v1/config/declarations",
+            list[dict],
+            wrap_response=False,
+        )
+
+    def get_config(self) -> list[dict]:
+        """GET /v1/config — merged component values (anonymous access).
+
+        Returns the merged list of all active components with their current
+        settings (YAML defaults merged with any dynamic overrides).  The
+        writing pod invalidates its own cache immediately after a PUT or
+        DELETE, so a same-pod GET reflects the change right away (AC-20).
+
+        Returns:
+            List of component dicts, each with ``id`` and ``settings``.
+        """
+        return self._api.get(
+            "/v1/config",
+            list[dict],
+            wrap_response=False,
+        )
+
+    def save_setting(self, component_id: str, settings: dict) -> dict:
+        """PUT /v1/config/declarations/{component_id} — persist a settings override.
+
+        Validates and sanitises the payload on the server side; rejects block-level
+        Markdown and ``javascript:`` URLs.  Audits the change to the activity log.
+        Invalidates the writing-pod TTL cache immediately.
+
+        Args:
+            component_id: Component identifier, e.g. ``"chatDisclaimer"``.
+            settings: Key/value map of field names to new values,
+                e.g. ``{"enabled": True, "text": "Notice [link](https://...)"}``.
+
+        Returns:
+            Response dict with ``component_id`` and ``settings`` as persisted.
+
+        Raises:
+            requests.HTTPError: 400 on validation failure, 403 for non-admin callers.
+        """
+        return self._api.put(
+            f"/v1/config/declarations/{component_id}",
+            dict,
+            json_data={"settings": settings},
+            wrap_response=False,
+        )
+
+    def reset_setting(self, component_id: str) -> None:
+        """DELETE /v1/config/declarations/{component_id} — reset to YAML default.
+
+        Removes the dynamic-config override row; the component reverts to its
+        YAML default on the next config read.  Idempotent — 204 even when no
+        override row exists.  Audits the reset to the activity log.
+
+        Args:
+            component_id: Component identifier, e.g. ``"chatDisclaimer"``.
+
+        Raises:
+            requests.HTTPError: On non-2xx / non-204 response.
+        """
+        self._api.delete(
+            f"/v1/config/declarations/{component_id}",
+            dict,
+            wrap_response=False,
+        )