swipeflow-api 1.1.0__py3-none-any.whl

swipeflow_api/resources.py

@@ -0,0 +1,412 @@
+"""Resource classes for SwipeFlow API endpoints."""
+
+from typing import Any, Dict, List, Optional
+
+from .models import Project, Item, Webhook, ApiKey, User, ItemStatus
+
+
+class BaseResource:
+    """Base class for API resources."""
+
+    def __init__(self, client):
+        """Initialize resource with client reference.
+
+        Args:
+            client: SwipeFlowClient instance
+        """
+        self.client = client
+
+
+class ProjectsResource(BaseResource):
+    """Resource for project operations."""
+
+    def list(self, skip: int = 0, limit: int = 20) -> List[Dict[str, Any]]:
+        """List all projects.
+
+        Args:
+            skip: Number of projects to skip
+            limit: Maximum number of projects to return
+
+        Returns:
+            List of project dictionaries
+        """
+        response = self.client.request("GET", "/v1/projects", params={"skip": skip, "limit": limit})
+        return response.get("items", [])
+
+    def get(self, project_id: str) -> Dict[str, Any]:
+        """Get a specific project.
+
+        Args:
+            project_id: Project ID
+
+        Returns:
+            Project data
+        """
+        return self.client.request("GET", f"/v1/projects/{project_id}")
+
+    def create(self, name: str, description: Optional[str] = None) -> Dict[str, Any]:
+        """Create a new project.
+
+        Args:
+            name: Project name
+            description: Optional project description
+
+        Returns:
+            Created project data
+        """
+        data = {"name": name}
+        if description:
+            data["description"] = description
+        return self.client.request("POST", "/v1/projects", json_data=data)
+
+    def update(self, project_id: str, name: Optional[str] = None, description: Optional[str] = None) -> Dict[str, Any]:
+        """Update a project.
+
+        Args:
+            project_id: Project ID
+            name: New project name
+            description: New project description
+
+        Returns:
+            Updated project data
+        """
+        data = {}
+        if name:
+            data["name"] = name
+        if description is not None:
+            data["description"] = description
+        return self.client.request("PUT", f"/v1/projects/{project_id}", json_data=data)
+
+    def delete(self, project_id: str) -> None:
+        """Delete a project.
+
+        Args:
+            project_id: Project ID
+        """
+        self.client.request("DELETE", f"/v1/projects/{project_id}")
+
+    def add_member(self, project_id: str, user_id: str, role: str) -> Dict[str, Any]:
+        """Add a member to a project.
+
+        Args:
+            project_id: Project ID
+            user_id: User ID to add
+            role: Role (OWNER, ADMIN, EDITOR, VIEWER)
+
+        Returns:
+            Updated project data
+        """
+        data = {"user_id": user_id, "role": role}
+        return self.client.request("POST", f"/v1/projects/{project_id}/members", json_data=data)
+
+    def remove_member(self, project_id: str, user_id: str) -> Dict[str, Any]:
+        """Remove a member from a project.
+
+        Args:
+            project_id: Project ID
+            user_id: User ID to remove
+
+        Returns:
+            Updated project data
+        """
+        return self.client.request("DELETE", f"/v1/projects/{project_id}/members/{user_id}")
+
+
+class ItemsResource(BaseResource):
+    """Resource for item operations."""
+
+    def list(self, project_id: str, status: Optional[str] = None, skip: int = 0, limit: int = 20) -> List[Dict[str, Any]]:
+        """List items in a project.
+
+        Args:
+            project_id: Project ID
+            status: Optional status filter (PENDING, APPROVED, REJECTED, CHANGE_REQUESTED, PROCESSED)
+            skip: Number of items to skip
+            limit: Maximum number of items to return
+
+        Returns:
+            List of item dictionaries
+        """
+        params = {"skip": skip, "limit": limit}
+        if status:
+            params["status"] = status
+        response = self.client.request("GET", f"/v1/projects/{project_id}/items", params=params)
+        return response.get("items", [])
+
+    def get(self, project_id: str, item_id: str) -> Dict[str, Any]:
+        """Get a specific item.
+
+        Args:
+            project_id: Project ID
+            item_id: Item ID
+
+        Returns:
+            Item data
+        """
+        return self.client.request("GET", f"/v1/projects/{project_id}/items/{item_id}")
+
+    def create(self, project_id: str, title: str, content: Dict[str, Any]) -> Dict[str, Any]:
+        """Create a new item.
+
+        Args:
+            project_id: Project ID
+            title: Item title
+            content: Item content (type, data)
+
+        Returns:
+            Created item data
+        """
+        data = {"title": title, "content": content}
+        return self.client.request("POST", f"/v1/projects/{project_id}/items", json_data=data)
+
+    def update(
+        self, project_id: str, item_id: str, title: Optional[str] = None, content: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        """Update an item.
+
+        Args:
+            project_id: Project ID
+            item_id: Item ID
+            title: New title
+            content: New content
+
+        Returns:
+            Updated item data
+        """
+        data = {}
+        if title:
+            data["title"] = title
+        if content:
+            data["content"] = content
+        return self.client.request("PUT", f"/v1/projects/{project_id}/items/{item_id}", json_data=data)
+
+    def delete(self, project_id: str, item_id: str) -> None:
+        """Delete an item.
+
+        Args:
+            project_id: Project ID
+            item_id: Item ID
+        """
+        self.client.request("DELETE", f"/v1/projects/{project_id}/items/{item_id}")
+
+    def approve(self, project_id: str, item_id: str, comment: Optional[str] = None) -> Dict[str, Any]:
+        """Approve an item.
+
+        Args:
+            project_id: Project ID
+            item_id: Item ID
+            comment: Optional approval comment
+
+        Returns:
+            Updated item data
+        """
+        data = {"type": "APPROVED"}
+        if comment:
+            data["comment"] = comment
+        return self.client.request("POST", f"/v1/projects/{project_id}/items/{item_id}/approve", json_data=data)
+
+    def reject(self, project_id: str, item_id: str, comment: Optional[str] = None) -> Dict[str, Any]:
+        """Reject an item.
+
+        Args:
+            project_id: Project ID
+            item_id: Item ID
+            comment: Optional rejection comment
+
+        Returns:
+            Updated item data
+        """
+        data = {"type": "REJECTED"}
+        if comment:
+            data["comment"] = comment
+        return self.client.request("POST", f"/v1/projects/{project_id}/items/{item_id}/reject", json_data=data)
+
+    def request_changes(self, project_id: str, item_id: str, comment: Optional[str] = None) -> Dict[str, Any]:
+        """Request changes on an item.
+
+        Args:
+            project_id: Project ID
+            item_id: Item ID
+            comment: Optional request comment
+
+        Returns:
+            Updated item data
+        """
+        data = {"type": "CHANGE_REQUESTED"}
+        if comment:
+            data["comment"] = comment
+        return self.client.request("POST", f"/v1/projects/{project_id}/items/{item_id}/request-changes", json_data=data)
+
+    def get_versions(self, project_id: str, item_id: str) -> List[Dict[str, Any]]:
+        """Get version history of an item.
+
+        Args:
+            project_id: Project ID
+            item_id: Item ID
+
+        Returns:
+            List of version data
+        """
+        response = self.client.request("GET", f"/v1/projects/{project_id}/items/{item_id}/versions")
+        return response.get("items", [])
+
+
+class WebhooksResource(BaseResource):
+    """Resource for webhook operations."""
+
+    def list(self, project_id: str, skip: int = 0, limit: int = 20) -> List[Dict[str, Any]]:
+        """List webhooks for a project.
+
+        Args:
+            project_id: Project ID
+            skip: Number of webhooks to skip
+            limit: Maximum number of webhooks to return
+
+        Returns:
+            List of webhook dictionaries
+        """
+        params = {"skip": skip, "limit": limit}
+        response = self.client.request("GET", f"/v1/projects/{project_id}/webhooks", params=params)
+        return response.get("items", [])
+
+    def get(self, project_id: str, webhook_id: str) -> Dict[str, Any]:
+        """Get a specific webhook.
+
+        Args:
+            project_id: Project ID
+            webhook_id: Webhook ID
+
+        Returns:
+            Webhook data
+        """
+        return self.client.request("GET", f"/v1/projects/{project_id}/webhooks/{webhook_id}")
+
+    def create(self, project_id: str, name: str, url: str, events: List[str]) -> Dict[str, Any]:
+        """Create a new webhook.
+
+        Args:
+            project_id: Project ID
+            name: Webhook name
+            url: Webhook URL
+            events: List of events to subscribe to
+
+        Returns:
+            Created webhook data
+        """
+        data = {"name": name, "url": url, "events": events}
+        return self.client.request("POST", f"/v1/projects/{project_id}/webhooks", json_data=data)
+
+    def update(
+        self, project_id: str, webhook_id: str, name: Optional[str] = None, url: Optional[str] = None,
+        events: Optional[List[str]] = None, active: Optional[bool] = None
+    ) -> Dict[str, Any]:
+        """Update a webhook.
+
+        Args:
+            project_id: Project ID
+            webhook_id: Webhook ID
+            name: New webhook name
+            url: New webhook URL
+            events: New events list
+            active: Whether webhook is active
+
+        Returns:
+            Updated webhook data
+        """
+        data = {}
+        if name:
+            data["name"] = name
+        if url:
+            data["url"] = url
+        if events:
+            data["events"] = events
+        if active is not None:
+            data["active"] = active
+        return self.client.request("PUT", f"/v1/projects/{project_id}/webhooks/{webhook_id}", json_data=data)
+
+    def delete(self, project_id: str, webhook_id: str) -> None:
+        """Delete a webhook.
+
+        Args:
+            project_id: Project ID
+            webhook_id: Webhook ID
+        """
+        self.client.request("DELETE", f"/v1/projects/{project_id}/webhooks/{webhook_id}")
+
+    def test(self, project_id: str, webhook_id: str) -> Dict[str, Any]:
+        """Test a webhook by sending a test payload.
+
+        Args:
+            project_id: Project ID
+            webhook_id: Webhook ID
+
+        Returns:
+            Test result data
+        """
+        return self.client.request("POST", f"/v1/projects/{project_id}/webhooks/{webhook_id}/test")
+
+
+class ApiKeysResource(BaseResource):
+    """Resource for API key operations."""
+
+    def list(self, skip: int = 0, limit: int = 20) -> List[Dict[str, Any]]:
+        """List API keys.
+
+        Args:
+            skip: Number of keys to skip
+            limit: Maximum number of keys to return
+
+        Returns:
+            List of API key dictionaries
+        """
+        response = self.client.request("GET", "/v1/api-keys", params={"skip": skip, "limit": limit})
+        return response.get("items", [])
+
+    def create(self, name: str) -> Dict[str, Any]:
+        """Create a new API key.
+
+        Args:
+            name: Key name
+
+        Returns:
+            Created API key data (includes the actual key)
+        """
+        data = {"name": name}
+        return self.client.request("POST", "/v1/api-keys", json_data=data)
+
+    def delete(self, key_id: str) -> None:
+        """Delete an API key.
+
+        Args:
+            key_id: API key ID
+        """
+        self.client.request("DELETE", f"/v1/api-keys/{key_id}")
+
+
+class AuthResource(BaseResource):
+    """Resource for authentication operations."""
+
+    def get_profile(self) -> Dict[str, Any]:
+        """Get current user profile.
+
+        Returns:
+            User profile data
+        """
+        return self.client.request("GET", "/v1/auth/profile")
+
+    def update_profile(self, name: Optional[str] = None, avatar_url: Optional[str] = None) -> Dict[str, Any]:
+        """Update user profile.
+
+        Args:
+            name: New user name
+            avatar_url: New avatar URL
+
+        Returns:
+            Updated user data
+        """
+        data = {}
+        if name:
+            data["name"] = name
+        if avatar_url:
+            data["avatar_url"] = avatar_url
+        return self.client.request("PUT", "/v1/auth/profile", json_data=data)