flowtask-sdk 0.2.0__tar.gz → 0.5.0__tar.gz

{flowtask_sdk-0.2.0 → flowtask_sdk-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowtask-sdk
-Version: 0.2.0
+Version: 0.5.0
 Summary: Python SDK for the FlowTask visual task manager API
 License: MIT
 Requires-Python: >=3.9

{flowtask_sdk-0.2.0 → flowtask_sdk-0.5.0}/flowtask/__init__.py

@@ -1,8 +1,8 @@
 from .client import FlowTask
-from .models import Workspace, Project, Task, Dependency, Tag, Section, MyDayItem, SmartViewCounts
+from .models import Workspace, Project, Task, Dependency, Tag, Section, MyDayItem, SmartViewCounts, WorkspaceMember, Note, NoteFolder
 from .exceptions import FlowTaskError, AuthenticationError, ValidationError, NotFoundError, CycleDetectedError
 
-__version__ = "0.2.0"
+__version__ = "0.5.0"
 __all__ = [
     "FlowTask",
     "Workspace",
@@ -13,6 +13,9 @@ __all__ = [
     "Section",
     "MyDayItem",
     "SmartViewCounts",
+    "WorkspaceMember",
+    "Note",
+    "NoteFolder",
     "FlowTaskError",
     "AuthenticationError",
     "ValidationError",

{flowtask_sdk-0.2.0 → flowtask_sdk-0.5.0}/flowtask/client.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 from typing import Optional
 import requests as _requests
 
-from .models import Workspace, Project, Task, Dependency, Tag, Section, MyDayItem, SmartViewCounts
+from .models import Workspace, Project, Task, Dependency, Tag, Section, MyDayItem, SmartViewCounts, WorkspaceMember, Note, NoteFolder
 from .exceptions import (
     FlowTaskError,
     AuthenticationError,
@@ -345,6 +345,33 @@ class FlowTask:
         """Reorder sections by providing IDs in desired order."""
         self._request("PATCH", "/sections/reorder", json={"sectionIds": section_ids})
 
+    # ─── Sharing ───────────────────────────────────────
+
+    def invite_to_workspace(self, workspace_id: str, email: str, role: str = "editor") -> WorkspaceMember:
+        """Invite a user to a workspace by email. Returns the member or creates a pending invitation."""
+        data = self._request("POST", f"/workspaces/{workspace_id}/members", json={"email": email, "role": role})
+        if data.get("type") == "member" and data.get("member"):
+            return WorkspaceMember.from_dict(data["member"])
+        return WorkspaceMember(id="pending", user_id="", role=role, user_email=email)
+
+    def list_workspace_members(self, workspace_id: str) -> list[WorkspaceMember]:
+        """List all members of a workspace."""
+        data = self._request("GET", f"/workspaces/{workspace_id}/members")
+        return [WorkspaceMember.from_dict(m) for m in data.get("members", [])]
+
+    def update_workspace_member(self, workspace_id: str, member_id: str, role: str) -> WorkspaceMember:
+        """Change a member's role (owner only)."""
+        data = self._request("PUT", f"/workspaces/{workspace_id}/members/{member_id}", json={"role": role})
+        return WorkspaceMember.from_dict(data)
+
+    def remove_workspace_member(self, workspace_id: str, member_id: str) -> None:
+        """Remove a member from a workspace (owner only)."""
+        self._request("DELETE", f"/workspaces/{workspace_id}/members/{member_id}")
+
+    def leave_workspace(self, workspace_id: str) -> None:
+        """Leave a workspace (non-owners only)."""
+        self._request("DELETE", f"/workspaces/{workspace_id}/members/me")
+
     # ─── My Day ────────────────────────────────────────
 
     def get_my_day(self, date: Optional[str] = None) -> list[MyDayItem]:
@@ -406,6 +433,57 @@ class FlowTask:
         data = self._request("GET", "/actual-tasks")
         return [Task.from_dict(t, client=self) for t in data]
 
+    # ─── Notes ─────────────────────────────────────────
+
+    def list_notes(self, workspace_id: str) -> dict:
+        """List all notes and folders in a workspace."""
+        data = self._request("GET", f"/workspaces/{workspace_id}/notes")
+        folders = [NoteFolder.from_dict(f, client=self) for f in data.get("folders", [])]
+        unfoldered = [Note.from_dict(n, client=self) for n in data.get("unfolderedNotes", [])]
+        return {"folders": folders, "unfolderedNotes": unfoldered}
+
+    def create_note(
+        self,
+        workspace_id: str,
+        title: str,
+        content: str = "",
+        folder_id: Optional[str] = None,
+    ) -> Note:
+        """Create a note in a workspace. Content is markdown."""
+        body: dict = {"title": title, "content": content}
+        if folder_id:
+            body["folderId"] = folder_id
+        data = self._request("POST", f"/workspaces/{workspace_id}/notes", json=body)
+        return Note.from_dict(data, client=self)
+
+    def update_note(self, note_id: str, **kwargs) -> Note:
+        """Update a note. Accepts: title, content, folder_id."""
+        key_map = {"folder_id": "folderId"}
+        body = {}
+        for key, value in kwargs.items():
+            api_key = key_map.get(key, key)
+            body[api_key] = value
+        data = self._request("PUT", f"/notes/{note_id}", json=body)
+        return Note.from_dict(data, client=self)
+
+    def delete_note(self, note_id: str) -> None:
+        """Delete a note."""
+        self._request("DELETE", f"/notes/{note_id}")
+
+    def create_note_folder(self, workspace_id: str, name: str) -> NoteFolder:
+        """Create a note folder in a workspace."""
+        data = self._request("POST", f"/workspaces/{workspace_id}/folders", json={"name": name})
+        return NoteFolder.from_dict(data, client=self)
+
+    def update_note_folder(self, folder_id: str, name: str) -> NoteFolder:
+        """Rename a note folder."""
+        data = self._request("PUT", f"/folders/{folder_id}", json={"name": name})
+        return NoteFolder.from_dict(data, client=self)
+
+    def delete_note_folder(self, folder_id: str) -> None:
+        """Delete a note folder. Notes become unfoldered."""
+        self._request("DELETE", f"/folders/{folder_id}")
+
     # ─── Search ────────────────────────────────────────
 
     def search(self, query: str) -> list[Task]:

{flowtask_sdk-0.2.0 → flowtask_sdk-0.5.0}/flowtask/models.py

@@ -145,6 +145,26 @@ class Section:
         )
 
 
+@dataclass
+class WorkspaceMember:
+    id: str
+    user_id: str
+    role: str
+    user_email: str = ""
+    user_name: Optional[str] = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> WorkspaceMember:
+        user = data.get("user", {})
+        return cls(
+            id=data["id"],
+            user_id=data.get("userId", ""),
+            role=data.get("role", "editor"),
+            user_email=user.get("email", ""),
+            user_name=user.get("name"),
+        )
+
+
 @dataclass
 class Workspace:
     id: str
@@ -153,6 +173,8 @@ class Workspace:
     sort_order: int = 0
     project_count: int = 0
     task_count: int = 0
+    is_shared: bool = False
+    current_user_role: str = "owner"
     created_at: str = ""
     updated_at: str = ""
     _client: Optional[FlowTask] = field(default=None, repr=False)
@@ -167,6 +189,8 @@ class Workspace:
             sort_order=data.get("sortOrder", 0),
             project_count=count.get("projects", 0) if isinstance(count, dict) else 0,
             task_count=count.get("tasks", 0) if isinstance(count, dict) else 0,
+            is_shared=data.get("isShared", False),
+            current_user_role=data.get("currentUserRole", "owner"),
             created_at=data.get("createdAt", ""),
             updated_at=data.get("updatedAt", ""),
             _client=client,
@@ -220,6 +244,48 @@ class Workspace:
             raise RuntimeError("Workspace not bound to a client")
         self._client.delete_workspace(self.id)
 
+    def share(self, email: str, role: str = "editor") -> WorkspaceMember:
+        """Invite a user to this workspace by email."""
+        if not self._client:
+            raise RuntimeError("Workspace not bound to a client")
+        return self._client.invite_to_workspace(self.id, email, role)
+
+    def list_members(self) -> list[WorkspaceMember]:
+        """List all members of this workspace."""
+        if not self._client:
+            raise RuntimeError("Workspace not bound to a client")
+        return self._client.list_workspace_members(self.id)
+
+    def remove_member(self, member_id: str) -> None:
+        """Remove a member from this workspace."""
+        if not self._client:
+            raise RuntimeError("Workspace not bound to a client")
+        self._client.remove_workspace_member(self.id, member_id)
+
+    def leave(self) -> None:
+        """Leave this workspace (non-owners only)."""
+        if not self._client:
+            raise RuntimeError("Workspace not bound to a client")
+        self._client.leave_workspace(self.id)
+
+    def list_notes(self) -> dict:
+        """List all notes and folders in this workspace."""
+        if not self._client:
+            raise RuntimeError("Workspace not bound to a client")
+        return self._client.list_notes(self.id)
+
+    def create_note(self, title: str, content: str = "", folder_id: Optional[str] = None) -> Note:
+        """Create a note in this workspace."""
+        if not self._client:
+            raise RuntimeError("Workspace not bound to a client")
+        return self._client.create_note(self.id, title, content, folder_id)
+
+    def create_note_folder(self, name: str) -> NoteFolder:
+        """Create a note folder in this workspace."""
+        if not self._client:
+            raise RuntimeError("Workspace not bound to a client")
+        return self._client.create_note_folder(self.id, name)
+
 
 @dataclass
 class Project:
@@ -335,3 +401,63 @@ class SmartViewCounts:
             delegated=data.get("delegated", 0),
             completed=data.get("completed", 0),
         )
+
+
+@dataclass
+class NoteFolder:
+    id: str
+    name: str
+    sort_order: int = 0
+    workspace_id: str = ""
+    notes: list[Note] = field(default_factory=list)
+
+    @classmethod
+    def from_dict(cls, data: dict, client: Optional[FlowTask] = None) -> NoteFolder:
+        return cls(
+            id=data["id"],
+            name=data["name"],
+            sort_order=data.get("sortOrder", 0),
+            workspace_id=data.get("workspaceId", ""),
+            notes=[Note.from_dict(n, client=client) for n in data.get("notes", [])],
+        )
+
+
+@dataclass
+class Note:
+    id: str
+    title: str
+    content: str = ""
+    sort_order: int = 0
+    folder_id: Optional[str] = None
+    author_id: str = ""
+    workspace_id: str = ""
+    created_at: str = ""
+    updated_at: str = ""
+    _client: Optional[FlowTask] = field(default=None, repr=False)
+
+    @classmethod
+    def from_dict(cls, data: dict, client: Optional[FlowTask] = None) -> Note:
+        return cls(
+            id=data["id"],
+            title=data["title"],
+            content=data.get("content", ""),
+            sort_order=data.get("sortOrder", 0),
+            folder_id=data.get("folderId"),
+            author_id=data.get("authorId", ""),
+            workspace_id=data.get("workspaceId", ""),
+            created_at=data.get("createdAt", ""),
+            updated_at=data.get("updatedAt", ""),
+            _client=client,
+        )
+
+    def update(self, **kwargs) -> Note:
+        """Update this note. Accepts: title, content, folder_id."""
+        if not self._client:
+            raise RuntimeError("Note not bound to a client")
+        return self._client.update_note(self.id, **kwargs)
+
+    def delete(self) -> None:
+        """Delete this note."""
+        if not self._client:
+            raise RuntimeError("Note not bound to a client")
+        self._client.delete_note(self.id)

{flowtask_sdk-0.2.0 → flowtask_sdk-0.5.0}/flowtask_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowtask-sdk
-Version: 0.2.0
+Version: 0.5.0
 Summary: Python SDK for the FlowTask visual task manager API
 License: MIT
 Requires-Python: >=3.9

{flowtask_sdk-0.2.0 → flowtask_sdk-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flowtask-sdk"
-version = "0.2.0"
+version = "0.5.0"
 description = "Python SDK for the FlowTask visual task manager API"
 readme = "README.md"
 requires-python = ">=3.9"