marqetive-lib 0.1.20__tar.gz → 0.1.21__tar.gz

{marqetive_lib-0.1.20 → marqetive_lib-0.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: marqetive-lib
-Version: 0.1.20
+Version: 0.1.21
 Summary: Modern Python utilities for web APIs
 Keywords: api,utilities,web,http,marqetive
 Requires-Python: >=3.12

{marqetive_lib-0.1.20 → marqetive_lib-0.1.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "marqetive-lib"
-version = "0.1.20"
+version = "0.1.21"
 description = "Modern Python utilities for web APIs"
 readme = "README.md"
 requires-python = ">=3.12"

{marqetive_lib-0.1.20 → marqetive_lib-0.1.21}/src/marqetive/core/exceptions.py

@@ -47,15 +47,44 @@ class PlatformAuthError(PlatformError):
     - OAuth flow encounters errors
     - Insufficient permissions for requested operation
 
+    Args:
+        message: Human-readable error message
+        platform: Name of the platform where error occurred
+        status_code: HTTP status code if applicable
+        requires_reconnection: If True, user must re-authenticate (token permanently invalid)
+
     Example:
         >>> raise PlatformAuthError(
         ...     "Access token expired",
         ...     platform="twitter",
         ...     status_code=401
         ... )
+        >>> # For invalid refresh token requiring user re-auth:
+        >>> raise PlatformAuthError(
+        ...     "Refresh token invalid",
+        ...     platform="twitter",
+        ...     status_code=400,
+        ...     requires_reconnection=True
+        ... )
     """
 
-    pass
+    def __init__(
+        self,
+        message: str,
+        platform: str | None = None,
+        status_code: int | None = None,
+        *,
+        requires_reconnection: bool = False,
+    ) -> None:
+        self.requires_reconnection = requires_reconnection
+        super().__init__(message, platform, status_code)
+
+    def _format_message(self) -> str:
+        """Format the error message with reconnection info."""
+        base_message = super()._format_message()
+        if self.requires_reconnection:
+            return f"{base_message} | Reconnection required"
+        return base_message
 
 
 class RateLimitError(PlatformError):

{marqetive_lib-0.1.20 → marqetive_lib-0.1.21}/src/marqetive/factory.py

@@ -25,6 +25,24 @@ logger = logging.getLogger(__name__)
 # Supported platforms
 SUPPORTED_PLATFORMS = frozenset({"twitter", "linkedin", "instagram", "tiktok"})
 
+# Platform aliases (alternative names that map to canonical names)
+PLATFORM_ALIASES: dict[str, str] = {
+    "x": "twitter",
+}
+
+
+def normalize_platform(platform: str) -> str:
+    """Normalize platform name to canonical form.
+
+    Args:
+        platform: Platform name (may be an alias like 'x').
+
+    Returns:
+        Canonical platform name (e.g., 'twitter').
+    """
+    platform = platform.lower()
+    return PLATFORM_ALIASES.get(platform, platform)
+
 
 def _create_client(
     platform: str, credentials: "AuthCredentials"
@@ -172,7 +190,12 @@ class PlatformFactory:
             >>> async with client:
             ...     post = await client.create_post(request)
         """
-        platform = credentials.platform.lower()
+        # Normalize platform name (handle aliases like 'x' -> 'twitter')
+        platform = normalize_platform(credentials.platform)
+
+        # Update credentials with normalized platform name
+        if platform != credentials.platform.lower():
+            credentials.platform = platform
 
         # Validate platform-specific requirements
         self._validate_credentials(credentials)
@@ -180,8 +203,17 @@ class PlatformFactory:
         # Refresh token if needed
         if auto_refresh and credentials.needs_refresh():
             logger.info(f"Refreshing expired token for {platform}")
-            credentials = await self._refresh_token(credentials)
-            credentials.mark_valid()
+            try:
+                credentials = await self._refresh_token(credentials)
+                credentials.mark_valid()
+            except PlatformAuthError as e:
+                # If refresh failed and requires reconnection, update credentials status
+                if e.requires_reconnection:
+                    credentials.mark_reconnection_required()
+                    logger.warning(
+                        f"Token refresh for {platform} requires user reconnection"
+                    )
+                raise
 
         # Enrich credentials with API keys for Twitter (needed for media operations)
         if platform == "twitter":
@@ -337,9 +369,9 @@ class PlatformFactory:
         """Get the set of supported platform names.
 
         Returns:
-            Frozenset of supported platform names.
+            Frozenset of supported platform names (includes aliases).
         """
-        return SUPPORTED_PLATFORMS
+        return SUPPORTED_PLATFORMS | frozenset(PLATFORM_ALIASES.keys())
 
 
 async def get_client(

{marqetive_lib-0.1.20 → marqetive_lib-0.1.21}/src/marqetive/utils/oauth.py

@@ -180,10 +180,32 @@ async def refresh_twitter_token(
 
     except httpx.HTTPStatusError as e:
         logger.error(f"HTTP error refreshing Twitter token: {e.response.status_code}")
+
+        # Determine if this is a permanent failure requiring user re-authentication
+        # Twitter returns 400 with "invalid_request" or "invalid_grant" when:
+        # - Refresh token was already used (single-use tokens)
+        # - Refresh token expired
+        # - User revoked access
+        requires_reconnection = False
+        if e.response.status_code == 400:
+            try:
+                error_data = e.response.json()
+                error_code = error_data.get("error", "")
+                if error_code in ("invalid_request", "invalid_grant"):
+                    requires_reconnection = True
+                    logger.warning(
+                        f"Twitter refresh token is invalid ({error_code}), "
+                        "user needs to reconnect their account"
+                    )
+            except Exception:
+                # If we can't parse the response, assume reconnection is needed for 400
+                requires_reconnection = True
+
         raise PlatformAuthError(
             f"Failed to refresh token: {_sanitize_response_text(e.response.text)}",
             platform="twitter",
             status_code=e.response.status_code,
+            requires_reconnection=requires_reconnection,
         ) from e
 
     except httpx.HTTPError as e: