marqetive-lib 0.1.20__py3-none-any.whl → 0.1.21__py3-none-any.whl

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/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/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:

{marqetive_lib-0.1.20.dist-info → marqetive_lib-0.1.21.dist-info}/METADATA

@@ -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.dist-info → marqetive_lib-0.1.21.dist-info}/RECORD

@@ -2,9 +2,9 @@ marqetive/__init__.py,sha256=pW77CUnzOQ0X1pb-GTcRgrrvsSaJBdVhGZLnvCD_4q4,3032
 marqetive/core/__init__.py,sha256=0_0vzxJ619YIJkz1yzSvhnGDJRkrErs_QSg2q3Bloss,1172
 marqetive/core/base.py,sha256=A1RgZZLX5aMkFVmjNdJak9O0WFWOl1PPMIU8-ngEjxA,17225
 marqetive/core/client.py,sha256=eCtvL100dkxYQHC_TJzHbs3dGjgsa_me9VTHo-CUN2M,3900
-marqetive/core/exceptions.py,sha256=Xyj0bzNiZm5VTErmzXgVW8T6IQnOpF92-HJiKPKjIio,7076
+marqetive/core/exceptions.py,sha256=CQXGPjzWJU2NZ0a7E007PxrG_orOOJNmvcsZ0L4HTiQ,8195
 marqetive/core/models.py,sha256=HmUSKZgJFw4o6Orjn4SGaCwLN6s8_FCsFkK1ptvnad8,14819
-marqetive/factory.py,sha256=irZ5oN8a__kXZH70UN2uI7TzqTXu66d4QZ1FoxSoiK8,14092
+marqetive/factory.py,sha256=SfHsp6mdIZpDBtryUvHSwljBRkCyAHhtwV7qDfgL9k4,15268
 marqetive/platforms/__init__.py,sha256=RBxlQSGyELsulSnwf5uaE1ohxFc7jC61OO9CrKaZp48,1312
 marqetive/platforms/instagram/__init__.py,sha256=c1Gs0ozG6D7Z-Uz_UQ7S3joL0qUTT9eUZPWcePyESk8,229
 marqetive/platforms/instagram/client.py,sha256=fyVDAcee28rbINa0jPB9W9GF745UHQ8BbKeOj3UXRoo,35239
@@ -31,8 +31,8 @@ marqetive/utils/__init__.py,sha256=bSrNajbxYBSKQayrPviLz8JeGjplnyK8y_NGDtgb7yQ,9
 marqetive/utils/file_handlers.py,sha256=mDBGLQpCBYD-AN3W_qysZn0JmXxQE017_lnURdkkucA,17224
 marqetive/utils/helpers.py,sha256=Sh5HZD6AOJig_6T84n6JsKLosIkKIkpkiYTl69rnOOw,1321
 marqetive/utils/media.py,sha256=reVousdueG-h5jeI6uLGqVCfjYxlsMiWhx6XZwg-iHY,14664
-marqetive/utils/oauth.py,sha256=x30XAW5VlND6TAPBsw9kZShko_Jsmn_NE-KOZjnBxGo,14359
+marqetive/utils/oauth.py,sha256=3TtbUCVuGxtOBxIUvVJH_DUMIHrP76XDpabPYaLXhTU,15392
 marqetive/utils/retry.py,sha256=UcgrmVBVG5zd30_11mZnRnTaSFrbUYXBO1DrXPR0f8E,7627
-marqetive_lib-0.1.20.dist-info/METADATA,sha256=p-ktKzsiPP2g2pP4nQtFEeqRJv3e7UCV0vfk2aSfUCY,7876
-marqetive_lib-0.1.20.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-marqetive_lib-0.1.20.dist-info/RECORD,,
+marqetive_lib-0.1.21.dist-info/METADATA,sha256=bYGdoaoexmFhLH4yVmG5CxkTKyP0fnztXVGa-msRi7M,7876
+marqetive_lib-0.1.21.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+marqetive_lib-0.1.21.dist-info/RECORD,,