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

marqetive/platforms/tiktok/client.py

@@ -166,6 +166,32 @@ class TikTokClient(SocialMediaPlatform):
         except PlatformError:
             return False
 
+    # ==================== Validation ====================
+
+    def _validate_create_post_request(self, request: PostCreateRequest) -> None:
+        """Validate TikTok post creation request.
+
+        TikTok Requirements:
+            - Video URL is ALWAYS required (TikTok is a video-only platform)
+            - Video duration: 3 seconds to 10 minutes
+            - open_id must be in credentials.additional_data
+
+        Args:
+            request: Post creation request to validate.
+
+        Raises:
+            ValidationError: If validation fails.
+        """
+        if not request.media_urls:
+            raise ValidationError(
+                "A video URL is required to create a TikTok post. "
+                "TikTok is a video platform - image-only or text-only posts are not supported.",
+                platform=self.platform_name,
+                field="media_urls",
+            )
+
+    # ==================== TikTok-specific Methods ====================
+
     async def query_creator_info(self) -> CreatorInfo:
         """Query creator info before posting.
 
@@ -203,11 +229,8 @@ class TikTokClient(SocialMediaPlatform):
         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,
-            )
+        # Validate request
+        self._validate_create_post_request(request)
 
         # 1. Query creator info (required before posting)
         if not self._creator_info:
@@ -232,12 +255,21 @@ class TikTokClient(SocialMediaPlatform):
         )
 
         # 4. Return minimal Post object without fetching details
+        video_id = upload_result.video_id or upload_result.publish_id
+        url = (
+            HttpUrl(f"https://www.tiktok.com/@{self.credentials.username}/video/{video_id}")
+            if self.credentials.username and video_id
+            else None
+        )
+
         return Post(
-            post_id=upload_result.video_id or upload_result.publish_id,
+            post_id=video_id,
             platform=self.platform_name,
             content=request.content,
             status=PostStatus.PUBLISHED,
             created_at=datetime.now(),
+            author_id=self.credentials.additional_data.get("open_id"),
+            url=url,
             raw_data={
                 "publish_id": upload_result.publish_id,
                 "video_id": upload_result.video_id,
@@ -458,16 +490,25 @@ class TikTokClient(SocialMediaPlatform):
         # TikTok uses 'id' field for video ID
         video_id = video_data.get("id", video_data.get("video_id", ""))
 
-        # Handle share_url - use placeholder if empty
+        # Handle share_url - construct URL from username if share_url not available
         share_url = video_data.get("share_url", "")
-        media_url = (
-            HttpUrl(share_url) if share_url else HttpUrl("https://www.tiktok.com/")
-        )
+        if share_url:
+            post_url: HttpUrl | None = HttpUrl(share_url)
+        elif self.credentials.username and video_id:
+            post_url = HttpUrl(
+                f"https://www.tiktok.com/@{self.credentials.username}/video/{video_id}"
+            )
+        else:
+            post_url = None
+
+        # MediaAttachment.url requires a non-null HttpUrl, use placeholder if needed
+        media_url = post_url if post_url else HttpUrl("https://www.tiktok.com/")
 
         return Post(
             post_id=video_id,
             platform=self.platform_name,
             content=video_data.get("title", video_data.get("video_description", "")),
+            url=post_url,
             media=[
                 MediaAttachment(
                     media_id=video_id,

marqetive/platforms/twitter/client.py

@@ -185,29 +185,68 @@ class TwitterClient(SocialMediaPlatform):
         except tweepy.TweepyException:
             return False
 
+    # ==================== Validation ====================
+
+    def _validate_create_post_request(self, request: PostCreateRequest) -> None:
+        """Validate Twitter post creation request.
+
+        Twitter Requirements:
+            - Must have content OR media (at least one)
+            - Content max 280 characters (enforced by Twitter API)
+            - Max 4 images or 1 video per tweet
+
+        Args:
+            request: Post creation request to validate.
+
+        Raises:
+            ValidationError: If validation fails.
+        """
+        if not request.content and not request.media_urls and not request.media_ids:
+            raise ValidationError(
+                "Tweet must contain content or media",
+                platform=self.platform_name,
+                field="content",
+            )
+
     # ==================== Post CRUD Methods ====================
 
     async def create_post(self, request: PostCreateRequest) -> Post:
         """Create and publish a tweet.
 
+        Twitter Requirements:
+            - Must have content OR media (at least one)
+            - Content max 280 characters (enforced by Twitter API)
+            - Max 4 images or 1 video per tweet
+
         Args:
-            request: Post creation request.
+            request: Post creation request. Supports:
+                - content: Tweet text (max 280 chars)
+                - media_urls: URLs of media to attach
+                - reply_to_post_id: Tweet ID to reply to (for threads)
+                - quote_post_id: Tweet ID to quote
 
         Returns:
-            Created Post object.
+            Post object with:
+                - post_id: Twitter tweet ID
+                - platform: "twitter"
+                - content: Tweet text
+                - status: PostStatus.PUBLISHED
+                - created_at: Creation timestamp
+                - author_id: None (not available without extra API call)
+                - url: None (not returned in create response)
+                - raw_data: {"tweet_id": ...}
 
         Raises:
             ValidationError: If request is invalid.
             MediaUploadError: If media upload fails.
+            RateLimitError: If Twitter rate limit is exceeded.
+            PlatformError: For other Twitter API errors.
         """
         if not self._tweepy_client:
             raise RuntimeError("Client must be used as async context manager")
 
-        if not request.content and not request.media_urls:
-            raise ValidationError(
-                "Tweet must contain content or media",
-                platform=self.platform_name,
-            )
+        # Validate request
+        self._validate_create_post_request(request)
 
         try:
             media_ids = []
@@ -241,6 +280,13 @@ class TwitterClient(SocialMediaPlatform):
             response = self._tweepy_client.create_tweet(**tweet_params, user_auth=False)
             tweet_id = response.data["id"]  # type: ignore[index]
 
+            # Construct Twitter URL if username is available
+            url = (
+                HttpUrl(f"https://x.com/{self.credentials.username}/status/{tweet_id}")
+                if self.credentials.username
+                else HttpUrl(f"https://x.com/web/status/{tweet_id}")
+            )
+
             # Return minimal Post object without fetching details
             return Post(
                 post_id=tweet_id,
@@ -248,6 +294,9 @@ class TwitterClient(SocialMediaPlatform):
                 content=request.content or "",
                 status=PostStatus.PUBLISHED,
                 created_at=datetime.now(),
+                author_id=None,  # Not available without extra API call
+                url=url,
+                raw_data={"tweet_id": tweet_id},
             )
 
         except tweepy.TweepyException as e:
@@ -741,10 +790,19 @@ class TwitterClient(SocialMediaPlatform):
 
         metrics = tweet.public_metrics or {}
 
+        # Construct Twitter URL if username is available
+        tweet_id = str(tweet.id)
+        url = (
+            HttpUrl(f"https://x.com/{self.credentials.username}/status/{tweet_id}")
+            if self.credentials.username
+            else HttpUrl(f"https://x.com/web/status/{tweet_id}")
+        )
+
         return Post(
-            post_id=str(tweet.id),
+            post_id=tweet_id,
             platform=self.platform_name,
             content=tweet.text,
+            url=url,
             media=media,
             status=PostStatus.PUBLISHED,
             created_at=tweet.created_at or datetime.now(),

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

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

{marqetive_lib-0.1.17.dist-info → marqetive_lib-0.1.20.dist-info}/RECORD

@@ -1,28 +1,28 @@
 marqetive/__init__.py,sha256=pW77CUnzOQ0X1pb-GTcRgrrvsSaJBdVhGZLnvCD_4q4,3032
 marqetive/core/__init__.py,sha256=0_0vzxJ619YIJkz1yzSvhnGDJRkrErs_QSg2q3Bloss,1172
-marqetive/core/base.py,sha256=EJBW2HMc611SqYvSq7sXCIooENmwOGDGGiNVk_Xo2rg,16160
+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/models.py,sha256=L2gA4FhW0feAXQFsz2ce1ttd0vScMRhatoTclhDGCU0,14727
+marqetive/core/models.py,sha256=HmUSKZgJFw4o6Orjn4SGaCwLN6s8_FCsFkK1ptvnad8,14819
 marqetive/factory.py,sha256=irZ5oN8a__kXZH70UN2uI7TzqTXu66d4QZ1FoxSoiK8,14092
 marqetive/platforms/__init__.py,sha256=RBxlQSGyELsulSnwf5uaE1ohxFc7jC61OO9CrKaZp48,1312
 marqetive/platforms/instagram/__init__.py,sha256=c1Gs0ozG6D7Z-Uz_UQ7S3joL0qUTT9eUZPWcePyESk8,229
-marqetive/platforms/instagram/client.py,sha256=6jnoIt4CbdIQdVoVuZ_2DI2tQKj6dKBF_-RbFUljVps,33744
+marqetive/platforms/instagram/client.py,sha256=fyVDAcee28rbINa0jPB9W9GF745UHQ8BbKeOj3UXRoo,35239
 marqetive/platforms/instagram/exceptions.py,sha256=TcD_pX4eSx_k4yW8DgfA6SGPiAz3VW7cMqM8DmiXIhg,8978
 marqetive/platforms/instagram/media.py,sha256=0ZbUbpwJ025_hccL9X8qced_-LJGoL_-NdS84Op97VE,23228
 marqetive/platforms/instagram/models.py,sha256=20v3m1037y3b_WlsKF8zAOgV23nFu63tfmmUN1CefOI,2769
 marqetive/platforms/linkedin/__init__.py,sha256=_FrdZpqcXjcUW6C-25zGV7poGih9yzs6y1AFnuizTUQ,1384
-marqetive/platforms/linkedin/client.py,sha256=8M34VJXFe_34QQZzhR7SVK8ee3iE6UOGsSVTv5Hf31U,58712
+marqetive/platforms/linkedin/client.py,sha256=lMHvb5dpDozHDKu6g27tSZPDHgZuQzrNCWZhZIzWmpc,74249
 marqetive/platforms/linkedin/exceptions.py,sha256=i5fARUkZik46bS3htZBwUInVzetsZx1APpKEXLrCKf0,9762
-marqetive/platforms/linkedin/media.py,sha256=iWXUfqDYGsrTqeM6CGZ7a8xjpbdJ5qESolQL8Fv2PIg,20341
+marqetive/platforms/linkedin/media.py,sha256=-kpkL5brYhx8cZlFS5ueDgY4eSZWqHoB6xp8jZU2cyI,25931
 marqetive/platforms/linkedin/models.py,sha256=n7DqwVxYSbGYBmeEJ1woCZ6XhUIHcLx8Gpm8uCBACzI,12620
 marqetive/platforms/tiktok/__init__.py,sha256=BqjkXTZDyBlcY3lvREy13yP9h3RcDga8E6Rl6f5KPp8,238
-marqetive/platforms/tiktok/client.py,sha256=c-XYV3XsLU04jv61mBEYivP-oO-aZhuEq6g7J55OEY8,17387
+marqetive/platforms/tiktok/client.py,sha256=IhLCphzu_qxTSP6CDFqLBQqM3zJ7bLy7uHDSErc-qA8,18968
 marqetive/platforms/tiktok/exceptions.py,sha256=vxwyAKujMGZJh0LetG1QsLF95QfUs_kR6ujsWSHGqL0,10124
 marqetive/platforms/tiktok/media.py,sha256=NmvzvzfaZMmzIx88wkXI5tWLd4vYN1VJXN-IkaEAO2c,28638
 marqetive/platforms/tiktok/models.py,sha256=WWdjuFqhTIR8SnHkz-8UaNc5Mm2PrGomwQ3W7pJcQFg,2962
 marqetive/platforms/twitter/__init__.py,sha256=dvcgVT-v-JOtjSz-OUvxGrn_43OI6w_ep42Wx_nHTSM,217
-marqetive/platforms/twitter/client.py,sha256=FzCfkduM2haeQ8--9U3O0cJ-wzZqazrwkU2hkOmTi9I,26629
+marqetive/platforms/twitter/client.py,sha256=x4czyl1TnP-JmxRKl19fEE0gcYCppqK2Xdwpyf7G2E8,29035
 marqetive/platforms/twitter/exceptions.py,sha256=eZ-dJKOXH_-bAMg29zWKbEqMFud29piEJ5IWfC9wFts,8926
 marqetive/platforms/twitter/media.py,sha256=KpPxnLCas8NhnsEvaXSJZ7To4wW4FY0YqQvUkJIIr7g,28010
 marqetive/platforms/twitter/models.py,sha256=yPQlx40SlNmz7YGasXUqdx7rEDEgrQ64aYovlPKo6oc,2126
@@ -33,6 +33,6 @@ marqetive/utils/helpers.py,sha256=Sh5HZD6AOJig_6T84n6JsKLosIkKIkpkiYTl69rnOOw,13
 marqetive/utils/media.py,sha256=reVousdueG-h5jeI6uLGqVCfjYxlsMiWhx6XZwg-iHY,14664
 marqetive/utils/oauth.py,sha256=x30XAW5VlND6TAPBsw9kZShko_Jsmn_NE-KOZjnBxGo,14359
 marqetive/utils/retry.py,sha256=UcgrmVBVG5zd30_11mZnRnTaSFrbUYXBO1DrXPR0f8E,7627
-marqetive_lib-0.1.17.dist-info/METADATA,sha256=mXa8m82FUduoiT9f6hCpeoNe-ygPA8TCqI7EOon__a8,7876
-marqetive_lib-0.1.17.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-marqetive_lib-0.1.17.dist-info/RECORD,,
+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,,