konecty_sdk_python 2.1.1__tar.gz → 2.1.3__tar.gz

{konecty_sdk_python-2.1.1 → konecty_sdk_python-2.1.3}/KonectySdkPython/lib/client.py

@@ -31,12 +31,15 @@ logging.getLogger("urllib3.connectionpool").setLevel(logging.ERROR)
 
 logger = logging.getLogger(__name__)
 
+# `_updatedBy` is NOT stripped: the backend accepts it on update as an explicit
+# authorship override for admin callers (automations crediting a write to the user
+# it acted on behalf of). Non-admin callers have it ignored server-side, so letting
+# it through costs nothing. See "Autoria da escrita" in docs/pt-BR/api.md (konecty/Konecty).
 KONECTY_UPDATE_IGNORE_FIELDS = [
     "_id",
     "code",
     "_updatedAt",
     "_createdAt",
-    "_updatedBy",
     "_createdBy",
 ]
 KONECTY_CREATE_IGNORE_FIELDS = ["_updatedAt", "_createdAt", "_updatedBy", "_createdBy"]

konecty_sdk_python-2.1.3/KonectySdkPython/lib/exceptions.py

@@ -0,0 +1,42 @@
+"""Exceptions for the Konecty SDK."""
+
+
+class KonectyError(Exception):
+    """Base exception for Konecty errors."""
+
+    pass
+
+
+class KonectyAPIError(KonectyError):
+    """Raised when the API returns success=false or a non-2xx status."""
+
+    pass
+
+
+class KonectyGoogleSessionError(KonectyAPIError):
+    """
+    Raised by exchange_google_code. Carries the machine-readable ``code`` from
+    ``errors[0].code`` so callers can branch or translate without parsing the
+    message; ``failed`` covers unreadable or unrecognised bodies.
+
+    Subclasses KonectyAPIError so existing ``except KonectyAPIError`` keeps working.
+
+    Mirrors KonectyGoogleSessionError in the TypeScript SDK — keep both in sync.
+    """
+
+    def __init__(self, code: str, message: str) -> None:
+        super().__init__(message)
+        self.code = code
+
+
+class KonectyValidationError(KonectyError):
+    """Raised for validation errors."""
+
+    pass
+
+
+class KonectySerializationError(KonectyError):
+    """Raised when a value is not serializable."""
+
+    def __init__(self) -> None:
+        super().__init__("Tipo não serializável")

{konecty_sdk_python-2.1.1 → konecty_sdk_python-2.1.3}/KonectySdkPython/lib/services/auth.py

@@ -3,7 +3,7 @@
 from typing import Any, Dict, Optional, Union
 from urllib.parse import quote, urlencode
 
-from ..exceptions import KonectyAPIError
+from ..exceptions import KonectyAPIError, KonectyGoogleSessionError
 from .base import BaseService
 
 GOOGLE_START_PATH = "/api/auth/google/start"
@@ -15,6 +15,29 @@ GOOGLE_SESSION_PATH = "/api/auth/google/session"
 LOGIN_OPTIONS_PATH = "/api/auth/login-options"
 
 
+_GOOGLE_SESSION_ERROR_CODES = (
+    "invalid_code",
+    "expired_code",
+    "user_not_found",
+    "user_inactive",
+)
+
+
+def _first_error_code(error: KonectyAPIError) -> str:
+    """
+    Extract the first recognised ``errors[].code``; ``failed`` when there is none.
+
+    Same set and same fallback as the TypeScript SDK, so both raise the same code
+    for the same response.
+    """
+    errors = error.args[0] if error.args else None
+    if isinstance(errors, list):
+        for item in errors:
+            if isinstance(item, dict) and item.get("code") in _GOOGLE_SESSION_ERROR_CODES:
+                return str(item["code"])
+    return "failed"
+
+
 def _first_error_message(error: KonectyAPIError) -> str:
     """Extract errors[0].message from a KonectyAPIError raised by the HTTP layer."""
     errors = error.args[0] if error.args else None
@@ -74,8 +97,10 @@ class AuthService(BaseService):
         POST /api/auth/google/session. Exchanges the single-use code (TTL 60s) for a session.
 
         On success the returned authId is adopted by the client, so following requests
-        are authenticated. On error raises KonectyAPIError with errors[0].message and
-        leaves the client authentication state untouched.
+        are authenticated. On error raises KonectyGoogleSessionError — errors[0].message
+        as the message plus the machine-readable ``code`` — and leaves the client
+        authentication state untouched. The error subclasses KonectyAPIError, so callers
+        catching that keep working.
         """
         payload: Dict[str, Any] = {"code": code}
         if geolocation is not None:
@@ -90,11 +115,15 @@ class AuthService(BaseService):
         try:
             response = await self._post(GOOGLE_SESSION_PATH, json=payload)
         except KonectyAPIError as error:
-            raise KonectyAPIError(_first_error_message(error)) from error
+            raise KonectyGoogleSessionError(
+                _first_error_code(error), _first_error_message(error)
+            ) from error
 
         auth_id = response.get("authId") if isinstance(response, dict) else None
         if not isinstance(auth_id, str) or not auth_id:
-            raise KonectyAPIError("Google session response has no authId")
+            raise KonectyGoogleSessionError(
+                "failed", "Google session response has no authId"
+            )
 
         self._client.set_auth_id(auth_id)
         return response

{konecty_sdk_python-2.1.1 → konecty_sdk_python-2.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: konecty_sdk_python
-Version: 2.1.1
+Version: 2.1.3
 Summary: Konecty SDK Python
 Author-email: Leonardo Leal <leonardo.leal@konecty.com>, Derotino Silveira <derotino.silveira@konecty.com>
 License: MIT

{konecty_sdk_python-2.1.1 → konecty_sdk_python-2.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "konecty_sdk_python"
-version = "2.1.1"
+version = "2.1.3"
 description = "Konecty SDK Python"
 readme = "README.md"
 requires-python = ">=3.11"

konecty_sdk_python-2.1.1/KonectySdkPython/lib/exceptions.py

@@ -1,26 +0,0 @@
-"""Exceptions for the Konecty SDK."""
-
-
-class KonectyError(Exception):
-    """Base exception for Konecty errors."""
-
-    pass
-
-
-class KonectyAPIError(KonectyError):
-    """Raised when the API returns success=false or a non-2xx status."""
-
-    pass
-
-
-class KonectyValidationError(KonectyError):
-    """Raised for validation errors."""
-
-    pass
-
-
-class KonectySerializationError(KonectyError):
-    """Raised when a value is not serializable."""
-
-    def __init__(self) -> None:
-        super().__init__("Tipo não serializável")