marqetive-lib 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

marqetive/__init__.py

@@ -28,20 +28,20 @@ Usage:
 
 # Core API client
 # Account management
-from marqetive.core.account_factory import BaseAccountFactory
+from src.marqetive.core.account_factory import BaseAccountFactory
 
 # Registry and managers
-from marqetive.core.base_manager import BasePostManager
-from marqetive.core.client import APIClient
+from src.marqetive.core.base_manager import BasePostManager
+from src.marqetive.core.client import APIClient
 
 # Progress tracking
-from marqetive.core.progress import (
+from src.marqetive.core.progress import (
     ProgressCallback,
     ProgressEvent,
     ProgressStatus,
     ProgressTracker,
 )
-from marqetive.core.registry import (
+from src.marqetive.core.registry import (
     PlatformRegistry,
     get_available_platforms,
     get_manager_for_platform,
@@ -50,7 +50,7 @@ from marqetive.core.registry import (
 )
 
 # Models
-from marqetive.platforms.models import (
+from src.marqetive.platforms.models import (
     AccountStatus,
     AuthCredentials,
     Comment,
@@ -62,16 +62,16 @@ from marqetive.platforms.models import (
     PostStatus,
     PostUpdateRequest,
 )
-from marqetive.registry_init import (
+from src.marqetive.registry_init import (
     initialize_platform_registry,
     is_registry_initialized,
 )
 
 # Utilities
-from marqetive.utils.helpers import format_response
+from src.marqetive.utils.helpers import format_response
 
 # Retry utilities
-from marqetive.utils.retry import STANDARD_BACKOFF, BackoffConfig, retry_async
+from src.marqetive.utils.retry import STANDARD_BACKOFF, BackoffConfig, retry_async
 
 __version__ = "0.1.0"
 

marqetive/core/__init__.py

@@ -1,5 +1,5 @@
 """Core functionality for MarqetiveLib."""
 
-from marqetive.core.client import APIClient
+from src.marqetive.core.client import APIClient
 
 __all__ = ["APIClient"]

marqetive/core/account_factory.py

@@ -9,8 +9,8 @@ from abc import ABC, abstractmethod
 from collections.abc import Callable
 from typing import Any
 
-from marqetive.platforms.exceptions import PlatformAuthError
-from marqetive.platforms.models import AccountStatus, AuthCredentials
+from src.marqetive.platforms.exceptions import PlatformAuthError
+from src.marqetive.platforms.models import AccountStatus, AuthCredentials
 
 logger = logging.getLogger(__name__)
 

marqetive/core/base_manager.py

@@ -10,10 +10,10 @@ import logging
 from abc import ABC, abstractmethod
 from typing import Any
 
-from marqetive.core.account_factory import BaseAccountFactory
-from marqetive.core.progress import ProgressCallback, ProgressTracker
-from marqetive.platforms.exceptions import PlatformError
-from marqetive.platforms.models import AuthCredentials, Post, PostCreateRequest
+from src.marqetive.core.account_factory import BaseAccountFactory
+from src.marqetive.core.progress import ProgressCallback, ProgressTracker
+from src.marqetive.platforms.exceptions import PlatformError
+from src.marqetive.platforms.models import AuthCredentials, Post, PostCreateRequest
 
 logger = logging.getLogger(__name__)
 

marqetive/core/client.py

@@ -73,7 +73,7 @@ class APIClient:
         if not self._client:
             raise RuntimeError("Client not initialized. Use async context manager.")
 
-        response: httpx.Response = await self._client.get(path, params=params)
+        response = await self._client.get(path, params=params)
         response.raise_for_status()
 
         return APIResponse(

marqetive/core/registry.py

@@ -7,7 +7,7 @@ platform managers across the application.
 import threading
 from typing import Any, TypeVar
 
-from marqetive.platforms.models import AuthCredentials
+from src.marqetive.platforms.models import AuthCredentials
 
 # Type variable for manager classes
 ManagerType = TypeVar("ManagerType")

marqetive/platforms/__init__.py

@@ -9,8 +9,8 @@ Platform clients are available via their respective subpackages:
     - from marqetive_lib.platforms.instagram import InstagramClient
 """
 
-from marqetive.platforms.base import SocialMediaPlatform
-from marqetive.platforms.exceptions import (
+from src.marqetive.platforms.base import SocialMediaPlatform
+from src.marqetive.platforms.exceptions import (
     MediaUploadError,
     PlatformAuthError,
     PlatformError,
@@ -18,7 +18,7 @@ from marqetive.platforms.exceptions import (
     RateLimitError,
     ValidationError,
 )
-from marqetive.platforms.models import (
+from src.marqetive.platforms.models import (
     AuthCredentials,
     Comment,
     CommentStatus,

marqetive/platforms/base.py

@@ -10,12 +10,12 @@ from datetime import datetime
 from traceback import TracebackException
 from typing import Any
 
-from marqetive.core.client import APIClient
-from marqetive.platforms.exceptions import (
+from src.marqetive.core.client import APIClient
+from src.marqetive.platforms.exceptions import (
     PlatformAuthError,
     RateLimitError,
 )
-from marqetive.platforms.models import (
+from src.marqetive.platforms.models import (
     AuthCredentials,
     Comment,
     MediaAttachment,

marqetive/platforms/exceptions.py

@@ -115,9 +115,10 @@ class PostNotFoundError(PlatformError):
         post_id: str,
         platform: str | None = None,
         status_code: int | None = None,
+        message: str | None = None,
     ) -> None:
         self.post_id = post_id
-        message = f"Post not found: {post_id}"
+        message = message or f"Post not found: {post_id}"
         super().__init__(message, platform, status_code)
 
 

marqetive/platforms/instagram/__init__.py

@@ -1,7 +1,7 @@
 """Instagram platform integration."""
 
-from marqetive.platforms.instagram.client import InstagramClient
-from marqetive.platforms.instagram.factory import InstagramAccountFactory
-from marqetive.platforms.instagram.manager import InstagramPostManager
+from src.marqetive.platforms.instagram.client import InstagramClient
+from src.marqetive.platforms.instagram.factory import InstagramAccountFactory
+from src.marqetive.platforms.instagram.manager import InstagramPostManager
 
 __all__ = ["InstagramClient", "InstagramAccountFactory", "InstagramPostManager"]

marqetive/platforms/instagram/client.py

@@ -12,19 +12,19 @@ from typing import Any, Literal, cast
 import httpx
 from pydantic import HttpUrl
 
-from marqetive.platforms.base import SocialMediaPlatform
-from marqetive.platforms.exceptions import (
+from src.marqetive.platforms.base import SocialMediaPlatform
+from src.marqetive.platforms.exceptions import (
     MediaUploadError,
     PlatformAuthError,
     PlatformError,
     PostNotFoundError,
     ValidationError,
 )
-from marqetive.platforms.instagram.media import (
+from src.marqetive.platforms.instagram.media import (
     InstagramMediaManager,
     MediaItem,
 )
-from marqetive.platforms.models import (
+from src.marqetive.platforms.models import (
     AuthCredentials,
     Comment,
     CommentStatus,

marqetive/platforms/instagram/exceptions.py

@@ -5,7 +5,7 @@ This module provides comprehensive error handling for Instagram Graph API errors
 
 from typing import Any
 
-from marqetive.platforms.exceptions import (
+from src.marqetive.platforms.exceptions import (
     MediaUploadError,
     PlatformAuthError,
     PlatformError,

marqetive/platforms/instagram/factory.py

@@ -3,11 +3,11 @@
 import logging
 from collections.abc import Callable
 
-from marqetive.core.account_factory import BaseAccountFactory
-from marqetive.platforms.exceptions import PlatformAuthError
-from marqetive.platforms.instagram.client import InstagramClient
-from marqetive.platforms.models import AccountStatus, AuthCredentials
-from marqetive.utils.oauth import refresh_instagram_token
+from src.marqetive.core.account_factory import BaseAccountFactory
+from src.marqetive.platforms.exceptions import PlatformAuthError
+from src.marqetive.platforms.instagram.client import InstagramClient
+from src.marqetive.platforms.models import AccountStatus, AuthCredentials
+from src.marqetive.utils.oauth import refresh_instagram_token
 
 logger = logging.getLogger(__name__)
 

marqetive/platforms/instagram/manager.py

@@ -3,10 +3,10 @@
 import logging
 from typing import Any
 
-from marqetive.core.base_manager import BasePostManager
-from marqetive.platforms.instagram.client import InstagramClient
-from marqetive.platforms.instagram.factory import InstagramAccountFactory
-from marqetive.platforms.models import AuthCredentials, Post, PostCreateRequest
+from src.marqetive.core.base_manager import BasePostManager
+from src.marqetive.platforms.instagram.client import InstagramClient
+from src.marqetive.platforms.instagram.factory import InstagramAccountFactory
+from src.marqetive.platforms.models import AuthCredentials, Post, PostCreateRequest
 
 logger = logging.getLogger(__name__)
 

marqetive/platforms/instagram/media.py

@@ -19,11 +19,11 @@ from typing import Any, Literal
 
 import httpx
 
-from marqetive.platforms.exceptions import (
+from src.marqetive.platforms.exceptions import (
     MediaUploadError,
     ValidationError,
 )
-from marqetive.utils.retry import STANDARD_BACKOFF, retry_async
+from src.marqetive.utils.retry import STANDARD_BACKOFF, retry_async
 
 logger = logging.getLogger(__name__)
 

marqetive/platforms/linkedin/__init__.py

@@ -1,7 +1,7 @@
 """LinkedIn platform integration."""
 
-from marqetive.platforms.linkedin.client import LinkedInClient
-from marqetive.platforms.linkedin.factory import LinkedInAccountFactory
-from marqetive.platforms.linkedin.manager import LinkedInPostManager
+from src.marqetive.platforms.linkedin.client import LinkedInClient
+from src.marqetive.platforms.linkedin.factory import LinkedInAccountFactory
+from src.marqetive.platforms.linkedin.manager import LinkedInPostManager
 
 __all__ = ["LinkedInClient", "LinkedInAccountFactory", "LinkedInPostManager"]

marqetive/platforms/linkedin/client.py

@@ -12,16 +12,16 @@ from typing import Any, cast
 import httpx
 from pydantic import HttpUrl
 
-from marqetive.platforms.base import SocialMediaPlatform
-from marqetive.platforms.exceptions import (
+from src.marqetive.platforms.base import SocialMediaPlatform
+from src.marqetive.platforms.exceptions import (
     MediaUploadError,
     PlatformAuthError,
     PlatformError,
     PostNotFoundError,
     ValidationError,
 )
-from marqetive.platforms.linkedin.media import LinkedInMediaManager, MediaAsset
-from marqetive.platforms.models import (
+from src.marqetive.platforms.linkedin.media import LinkedInMediaManager, MediaAsset
+from src.marqetive.platforms.models import (
     AuthCredentials,
     Comment,
     CommentStatus,

marqetive/platforms/linkedin/exceptions.py

@@ -9,7 +9,7 @@ This module provides comprehensive error handling for LinkedIn API errors includ
 
 from typing import Any
 
-from marqetive.platforms.exceptions import (
+from src.marqetive.platforms.exceptions import (
     MediaUploadError,
     PlatformAuthError,
     PlatformError,

marqetive/platforms/linkedin/factory.py

@@ -4,11 +4,11 @@ import logging
 import os
 from collections.abc import Callable
 
-from marqetive.core.account_factory import BaseAccountFactory
-from marqetive.platforms.exceptions import PlatformAuthError
-from marqetive.platforms.linkedin.client import LinkedInClient
-from marqetive.platforms.models import AccountStatus, AuthCredentials
-from marqetive.utils.oauth import refresh_linkedin_token
+from src.marqetive.core.account_factory import BaseAccountFactory
+from src.marqetive.platforms.exceptions import PlatformAuthError
+from src.marqetive.platforms.linkedin.client import LinkedInClient
+from src.marqetive.platforms.models import AccountStatus, AuthCredentials
+from src.marqetive.utils.oauth import refresh_linkedin_token
 
 logger = logging.getLogger(__name__)
 

marqetive/platforms/linkedin/manager.py

@@ -3,10 +3,10 @@
 import logging
 from typing import Any
 
-from marqetive.core.base_manager import BasePostManager
-from marqetive.platforms.linkedin.client import LinkedInClient
-from marqetive.platforms.linkedin.factory import LinkedInAccountFactory
-from marqetive.platforms.models import AuthCredentials, Post, PostCreateRequest
+from src.marqetive.core.base_manager import BasePostManager
+from src.marqetive.platforms.linkedin.client import LinkedInClient
+from src.marqetive.platforms.linkedin.factory import LinkedInAccountFactory
+from src.marqetive.platforms.models import AuthCredentials, Post, PostCreateRequest
 
 logger = logging.getLogger(__name__)
 

marqetive/platforms/linkedin/media.py

@@ -20,13 +20,13 @@ from typing import Any, Literal
 
 import httpx
 
-from marqetive.platforms.exceptions import (
+from src.marqetive.platforms.exceptions import (
     MediaUploadError,
     ValidationError,
 )
-from marqetive.utils.file_handlers import download_file, read_file_bytes
-from marqetive.utils.media import detect_mime_type, format_file_size
-from marqetive.utils.retry import STANDARD_BACKOFF, retry_async
+from src.marqetive.utils.file_handlers import download_file, read_file_bytes
+from src.marqetive.utils.media import detect_mime_type, format_file_size
+from src.marqetive.utils.retry import STANDARD_BACKOFF, retry_async
 
 logger = logging.getLogger(__name__)
 

marqetive/platforms/models.py

@@ -305,6 +305,7 @@ class PostCreateRequest(BaseModel):
         link: URL to include in the post
         tags: List of hashtags or user tags
         location: Location/place tag for the post
+        additional_data: Platform-specific data
 
     Example:
         >>> request = PostCreateRequest(
@@ -321,6 +322,7 @@ class PostCreateRequest(BaseModel):
     link: str | None = None
     tags: list[str] = Field(default_factory=list)
     location: str | None = None
+    additional_data: dict[str, Any] = Field(default_factory=dict)
 
 
 class PostUpdateRequest(BaseModel):

marqetive/platforms/tiktok/__init__.py

@@ -0,0 +1,7 @@
+"""TikTok platform integration."""
+
+from src.marqetive.platforms.tiktok.client import TikTokClient
+from src.marqetive.platforms.tiktok.factory import TikTokAccountFactory
+from src.marqetive.platforms.tiktok.manager import TikTokPostManager
+
+__all__ = ["TikTokClient", "TikTokAccountFactory", "TikTokPostManager"]

marqetive/platforms/tiktok/client.py

@@ -0,0 +1,277 @@
+"""TikTok API client implementation.
+
+This module provides a concrete implementation of the SocialMediaPlatform
+ABC for TikTok, using the TikTok for Business API (hypothetical).
+
+API Documentation: https://developers.tiktok.com/doc/overview
+"""
+
+from datetime import datetime
+from typing import Any
+
+from pydantic import HttpUrl
+
+from src.marqetive.platforms.base import SocialMediaPlatform
+from src.marqetive.platforms.exceptions import (
+    PlatformAuthError,
+    PlatformError,
+    PostNotFoundError,
+    ValidationError,
+)
+from src.marqetive.platforms.models import (
+    AuthCredentials,
+    Comment,
+    CommentStatus,
+    MediaAttachment,
+    MediaType,
+    Post,
+    PostCreateRequest,
+    PostStatus,
+    PostUpdateRequest,
+)
+from src.marqetive.platforms.tiktok.media import TikTokMediaManager
+
+
+class TikTokClient(SocialMediaPlatform):
+    """TikTok API client.
+
+    This client implements the SocialMediaPlatform interface for TikTok,
+    focusing on video uploads and management.
+    """
+
+    def __init__(
+        self,
+        credentials: AuthCredentials,
+        timeout: float = 300.0,
+    ) -> None:
+        """Initialize TikTok client."""
+        base_url = "https://open.tiktokapis.com/v2/"
+        super().__init__(
+            platform_name="tiktok",
+            credentials=credentials,
+            base_url=base_url,
+            timeout=timeout,
+        )
+        self._media_manager: TikTokMediaManager | None = None
+
+    async def _setup_managers(self) -> None:
+        """Setup media manager."""
+        if not self.credentials.access_token or not self.credentials.additional_data:
+            raise PlatformAuthError("Access token and open_id are required", "tiktok")
+
+        self._media_manager = TikTokMediaManager(
+            access_token=self.credentials.access_token,
+            open_id=self.credentials.additional_data["open_id"],
+            timeout=self.timeout,
+        )
+
+    async def _cleanup_managers(self) -> None:
+        """Cleanup media manager."""
+        if self._media_manager:
+            await self._media_manager.__aexit__(None, None, None)
+            self._media_manager = None
+
+    async def __aenter__(self) -> "TikTokClient":
+        await super().__aenter__()
+        await self._setup_managers()
+        return self
+
+    async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
+        await self._cleanup_managers()
+        await super().__aexit__(exc_type, exc_val, exc_tb)
+
+    async def authenticate(self) -> AuthCredentials:
+        """Perform TikTok authentication."""
+        if await self.is_authenticated():
+            return self.credentials
+        raise PlatformAuthError(
+            "Invalid or expired credentials. Please re-authenticate via TikTok OAuth.",
+            platform=self.platform_name,
+        )
+
+    async def refresh_token(self) -> AuthCredentials:
+        """Refresh TikTok access token."""
+        # The refresh logic should be handled by the AccountFactory
+        # For now, we assume it's done and we just return the creds
+        return self.credentials
+
+    async def is_authenticated(self) -> bool:
+        """Check if TikTok credentials are valid."""
+        if not self.api_client or not self.credentials.additional_data:
+            return False
+        try:
+            # Verify credentials by fetching authenticated user info
+            params = {
+                "fields": "open_id,union_id,avatar_url,display_name",
+                "open_id": self.credentials.additional_data["open_id"],
+            }
+            response = await self.api_client.get("user/info/", params=params)
+            return response.data.get("data", {}).get("user") is not None
+        except PlatformError:
+            return False
+
+    async def create_post(self, request: PostCreateRequest) -> Post:
+        """Create and publish a TikTok video.
+
+        Args:
+            request: The post creation request, must contain a video URL.
+
+        Returns:
+            The created Post object.
+
+        Raises:
+            ValidationError: If the request is invalid (e.g., no media).
+            MediaUploadError: If the video upload fails.
+        """
+        if not self._media_manager or not self.api_client:
+            raise RuntimeError("Client must be used as async context manager")
+
+        if not request.media_urls:
+            raise ValidationError(
+                "A video URL is required to create a TikTok post.",
+                platform=self.platform_name,
+            )
+
+        # 1. Upload the video
+        video_url = request.media_urls[0]
+        upload_result = await self._media_manager.upload_media(video_url)
+
+        if not upload_result.media_id:
+            raise PlatformError("Media upload succeeded but did not yield a media ID.")
+
+        # 2. Create the post with the uploaded video
+        payload = {
+            "post_info": {
+                "title": request.content or "",
+                "description": request.additional_data.get("description", ""),
+                "privacy_level": request.additional_data.get(
+                    "privacy_level", "PUBLIC_TO_EVERYONE"
+                ),
+            },
+            "source_info": {
+                "source": "FILE_UPLOAD",
+                "video_id": upload_result.media_id,
+            },
+        }
+        response = await self.api_client.post("video/publish/", data=payload)
+        post_id = response.data.get("data", {}).get("publish_id")
+
+        if not post_id:
+            raise PlatformError("Post creation succeeded but no publish_id returned.")
+
+        # 3. Fetch the created post to return a full Post object
+        return await self.get_post(post_id)
+
+    async def get_post(self, post_id: str) -> Post:
+        """Retrieve a TikTok video by its ID."""
+        if not self.api_client or not self.credentials.additional_data:
+            raise RuntimeError("Client must be used as async context manager")
+        try:
+            params = {
+                "open_id": self.credentials.additional_data["open_id"],
+                "video_ids": [post_id],
+            }
+            response = await self.api_client.post("video/query/", data=params)
+            video_data = response.data.get("data", {}).get("videos", [])
+            if not video_data:
+                raise PostNotFoundError(post_id, self.platform_name)
+            return self._parse_video_post(video_data[0])
+        except PlatformError as e:
+            raise PostNotFoundError(
+                post_id, self.platform_name, status_code=e.status_code
+            ) from e
+
+    async def update_post(self, post_id: str, request: PostUpdateRequest) -> Post:
+        """Update a TikTok video. This is not supported by TikTok API."""
+        raise PlatformError(
+            "TikTok API does not support updating videos.", self.platform_name
+        )
+
+    async def delete_post(self, post_id: str) -> bool:
+        """Delete a TikTok video. This is not supported by TikTok API."""
+        raise PlatformError(
+            "TikTok API does not support deleting videos.", self.platform_name
+        )
+
+    async def get_comments(
+        self, post_id: str, limit: int = 20, offset: int = 0
+    ) -> list[Comment]:
+        """Retrieve comments for a TikTok video."""
+        if not self.api_client or not self.credentials.additional_data:
+            raise RuntimeError("Client must be used as async context manager")
+        # This is a hypothetical endpoint
+        params = {
+            "open_id": self.credentials.additional_data["open_id"],
+            "video_id": post_id,
+            "count": limit,
+            "cursor": offset,
+        }
+        response = await self.api_client.get("video/comment/list/", params=params)
+        comments_data = response.data.get("data", {}).get("comments", [])
+        return [self._parse_comment(c, post_id) for c in comments_data]
+
+    async def create_comment(self, post_id: str, content: str) -> Comment:
+        """Create a comment on a TikTok video."""
+        raise PlatformError("Commenting via API is not supported.", self.platform_name)
+
+    async def delete_comment(self, comment_id: str) -> bool:
+        """Delete a comment on a TikTok video."""
+        raise PlatformError(
+            "Deleting comments via API is not supported.", self.platform_name
+        )
+
+    async def upload_media(
+        self, media_url: str, media_type: str, alt_text: str | None = None
+    ) -> MediaAttachment:
+        """Upload a video to TikTok."""
+        if not self._media_manager:
+            raise RuntimeError("Client not initialized. Use as async context manager.")
+        if media_type != "video":
+            raise ValidationError("Only video media type is supported for TikTok.")
+
+        result = await self._media_manager.upload_media(media_url)
+        return MediaAttachment(
+            media_id=result.media_id or result.upload_id,
+            media_type=MediaType.VIDEO,
+            url=HttpUrl(media_url),
+        )
+
+    def _parse_video_post(self, video_data: dict[str, Any]) -> Post:
+        """Parse a TikTok API video object into a Post model."""
+        return Post(
+            post_id=video_data["video_id"],
+            platform=self.platform_name,
+            content=video_data.get("title", ""),
+            media=[
+                MediaAttachment(
+                    media_id=video_data["video_id"],
+                    media_type=MediaType.VIDEO,
+                    url=HttpUrl(video_data.get("share_url", "")),
+                    width=video_data.get("width"),
+                    height=video_data.get("height"),
+                )
+            ],
+            status=PostStatus.PUBLISHED,
+            created_at=datetime.fromtimestamp(video_data.get("create_time", 0)),
+            author_id=str(video_data.get("open_id")),
+            likes_count=video_data.get("like_count", 0),
+            comments_count=video_data.get("comment_count", 0),
+            shares_count=video_data.get("share_count", 0),
+            views_count=video_data.get("view_count", 0),
+            raw_data=video_data,
+        )
+
+    def _parse_comment(self, comment_data: dict[str, Any], post_id: str) -> Comment:
+        """Parse a TikTok API comment object into a Comment model."""
+        return Comment(
+            comment_id=comment_data["comment_id"],
+            post_id=post_id,
+            platform=self.platform_name,
+            content=comment_data.get("text", ""),
+            author_id=comment_data.get("open_id", ""),
+            created_at=datetime.fromtimestamp(comment_data.get("create_time", 0)),
+            likes_count=comment_data.get("like_count", 0),
+            replies_count=0,
+            status=CommentStatus.VISIBLE,
+            raw_data=comment_data,
+        )