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

marqetive/core/base.py

@@ -119,7 +119,10 @@ class SocialMediaPlatform(ABC):
         return self
 
     async def __aexit__(
-        self, exc_type: type[Exception] | None, exc_val: Exception | None, exc_tb: TracebackType | None
+        self,
+        exc_type: type[Exception] | None,
+        exc_val: Exception | None,
+        exc_tb: TracebackType | None,
     ) -> None:
         """Async context manager exit."""
         if self.api_client:
@@ -228,6 +231,35 @@ class SocialMediaPlatform(ABC):
         if inspect.iscoroutine(result):
             await result
 
+    # ==================== Validation Helpers ====================
+
+    @abstractmethod
+    def _validate_create_post_request(self, request: PostCreateRequest) -> None:
+        """Validate a post creation request.
+
+        This base implementation performs no validation. Subclasses should
+        override this method to implement platform-specific validation rules.
+
+        The validation method should raise ValidationError with descriptive
+        messages including platform name and field name for consistency.
+
+        Args:
+            request: The post creation request to validate.
+
+        Raises:
+            ValidationError: If validation fails.
+
+        Example:
+            >>> def _validate_create_post_request(self, request):
+            ...     if not request.content:
+            ...         raise ValidationError(
+            ...             "Content is required",
+            ...             platform=self.platform_name,
+            ...             field="content",
+            ...         )
+        """
+        pass
+
     # ==================== Abstract Authentication Methods ====================
 
     @abstractmethod

marqetive/core/models.py

@@ -217,6 +217,7 @@ class AuthCredentials(BaseModel):
         expires_at: Timestamp when access token expires
         scope: List of permission scopes granted
         user_id: ID of the authenticated user
+        username: Username/handle of the authenticated user
         status: Current status of the account credentials
         additional_data: Platform-specific auth data
 
@@ -237,6 +238,7 @@ class AuthCredentials(BaseModel):
     expires_at: datetime | None = None
     scope: list[str] = Field(default_factory=list)
     user_id: str | None = None
+    username: str | None = None
     status: AccountStatus = AccountStatus.VALID
     additional_data: dict[str, Any] = Field(default_factory=dict)
 

marqetive/platforms/instagram/client.py

@@ -211,6 +211,39 @@ class InstagramClient(SocialMediaPlatform):
         except httpx.HTTPError:
             return False
 
+    # ==================== Validation ====================
+
+    def _validate_create_post_request(self, request: PostCreateRequest) -> None:
+        """Validate Instagram post creation request.
+
+        Instagram Requirements:
+            - Media is ALWAYS required (Instagram is a visual platform)
+            - For carousels: 2-10 images
+            - For reels: 1 video (3 sec - 15 min)
+            - Caption max 2200 characters
+            - Media must be publicly accessible URLs
+
+        Args:
+            request: Post creation request to validate.
+
+        Raises:
+            ValidationError: If validation fails.
+        """
+        if not request.media_urls and not request.media_ids:
+            raise ValidationError(
+                "Instagram posts require at least one media attachment. "
+                "Instagram is a visual platform - text-only posts are not supported.",
+                platform=self.platform_name,
+                field="media",
+            )
+
+        if request.content and len(request.content) > 2200:
+            raise ValidationError(
+                f"Caption exceeds 2200 characters ({len(request.content)} characters)",
+                platform=self.platform_name,
+                field="content",
+            )
+
     # ==================== Post CRUD Methods ====================
 
     async def create_post(self, request: PostCreateRequest) -> Post:
@@ -256,12 +289,8 @@ class InstagramClient(SocialMediaPlatform):
         if not self.api_client:
             raise RuntimeError("Client must be used as async context manager")
 
-        if not request.media_urls and not request.media_ids:
-            raise ValidationError(
-                "Instagram posts require at least one media attachment",
-                platform=self.platform_name,
-                field="media",
-            )
+        # Validate request
+        self._validate_create_post_request(request)
 
         # Determine content type from request
         media_type = self._get_media_type(request)
@@ -375,7 +404,9 @@ class InstagramClient(SocialMediaPlatform):
             content=request.content,
             status=PostStatus.PUBLISHED,
             created_at=datetime.now(),
+            author_id=self.instagram_account_id,
             url=cast(HttpUrl, result.permalink) if result.permalink else None,
+            raw_data={"container_id": container_ids[0]},
         )
 
     async def _create_carousel_post(self, request: PostCreateRequest) -> Post:
@@ -826,7 +857,9 @@ class InstagramClient(SocialMediaPlatform):
             content=caption,
             status=PostStatus.PUBLISHED,
             created_at=datetime.now(),
+            author_id=self.instagram_account_id,
             url=cast(HttpUrl, result.permalink) if result.permalink else None,
+            raw_data={"container_id": container_ids[0]},
         )
 
     async def create_reel(
@@ -890,7 +923,9 @@ class InstagramClient(SocialMediaPlatform):
             content=caption,
             status=PostStatus.PUBLISHED,
             created_at=datetime.now(),
+            author_id=self.instagram_account_id,
             url=cast(HttpUrl, result.permalink) if result.permalink else None,
+            raw_data={"container_id": container_id},
         )
 
     async def create_story(
@@ -941,7 +976,9 @@ class InstagramClient(SocialMediaPlatform):
             content=None,  # Stories don't have captions
             status=PostStatus.PUBLISHED,
             created_at=datetime.now(),
+            author_id=self.instagram_account_id,
             url=cast(HttpUrl, result.permalink) if result.permalink else None,
+            raw_data={"container_id": container_id},
         )
 
     # ==================== Helper Methods ====================