scheme-sdk 0.3.7__tar.gz → 0.3.8__tar.gz

{scheme_sdk-0.3.7 → scheme_sdk-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: scheme_sdk
-Version: 0.3.7
+Version: 0.3.8
 Summary: The Scheme SDK provides connectors for ingesting conversations, messages, and files across communication platforms.
 License:                                  Apache License
                                     Version 2.0, January 2004

{scheme_sdk-0.3.7 → scheme_sdk-0.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "scheme_sdk"
-version = "0.3.7"
+version = "0.3.8"
 description = "The Scheme SDK provides connectors for ingesting conversations, messages, and files across communication platforms."
 readme = "README.md"
 license = { file = "LICENSE" }

{scheme_sdk-0.3.7 → scheme_sdk-0.3.8}/src/scheme_sdk/connectors/base/__init__.py

@@ -13,12 +13,17 @@ from .errors import (
     ConnectorRateLimitError,
 )
 from .message import MessageConnector
+from .storage import FileContent, FileMetadata, FolderMetadata, StorageConnector
 
 __all__ = [
     # Base classes
     "BaseConnector",
     "MessageConnector",
+    "StorageConnector",
     "ConnectorContext",
+    "FileMetadata",
+    "FolderMetadata",
+    "FileContent",
     # Exceptions
     "ConnectorError",
     "ConnectorAuthError",

{scheme_sdk-0.3.7 → scheme_sdk-0.3.8}/src/scheme_sdk/connectors/base/message.py

@@ -12,10 +12,37 @@ class MessageConnector(BaseConnector, ABC):
     Abstract base class for all message connectors.
     """
 
+    _sanitizer_settings = {
+        "tags": {
+            "a",
+            "strong",
+            "em",
+            "p",
+            "ul",
+            "ol",
+            "li",
+            "br",
+            "blockquote",
+            "code",
+            "pre",
+            "span",
+            "sub",
+            "sup",
+            "hr",
+        },
+        "attributes": {"a": {"href", "title", "rel", "target"}},
+        "empty": {"hr", "a", "br"},
+        "separate": {"a", "p", "li", "blockquote", "pre"},
+        "whitespace": {"br"},
+        "add_nofollow": False,
+        "autolink": False,
+        "keep_typographic_whitespace": False,
+    }
+
     _sanitizer: Sanitizer
 
     def __init__(self):
-        self._sanitizer = Sanitizer()
+        self._sanitizer = Sanitizer(settings=self._sanitizer_settings)
 
     @abstractmethod
     def fetch_conversations(self) -> Iterable[Dict[str, Any]]:

scheme_sdk-0.3.8/src/scheme_sdk/connectors/base/storage.py

@@ -0,0 +1,159 @@
+"""
+SeedVault Connector SDK - Storage Connector Interfaces
+
+This module defines the base interface for storage connectors (e.g. Drive,
+OneDrive, Dropbox). Storage connectors provide file and folder metadata,
+search capabilities, and content export.
+"""
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Any, Dict, Iterable, Optional
+
+from .base import BaseConnector
+
+
+class StorageConnector(BaseConnector, ABC):
+    """
+    Abstract base class for all storage connectors.
+    """
+
+    @abstractmethod
+    def list_root_items(self) -> Iterable[Dict[str, Any]]:
+        """
+        List items at the storage root.
+
+        Yields:
+            Dict: Raw file or folder objects from the platform API.
+        """
+        ...
+
+    @abstractmethod
+    def list_children(self, folder_id: str) -> Iterable[Dict[str, Any]]:
+        """
+        List child items within a folder.
+
+        Args:
+            folder_id: Unique identifier of the parent folder.
+
+        Yields:
+            Dict: Raw file or folder objects from the platform API.
+        """
+        ...
+
+    @abstractmethod
+    def get_item(self, item_id: str) -> Dict[str, Any]:
+        """
+        Fetch a single file or folder by ID.
+
+        Args:
+            item_id: Unique identifier of the item.
+
+        Returns:
+            Dict: Raw file or folder object from the platform API.
+        """
+        ...
+
+    @abstractmethod
+    def search_items(
+        self, query: str, folder_id: Optional[str] = None, limit: int = 100
+    ) -> Iterable[Dict[str, Any]]:
+        """
+        Search for files or folders by query string.
+
+        Args:
+            query: Search query (platform-specific syntax).
+            folder_id: Optional folder scope for the search.
+            limit: Maximum number of results.
+
+        Yields:
+            Dict: Raw file or folder objects from the platform API.
+        """
+        ...
+
+    @abstractmethod
+    def fetch_content(self, file_id: str) -> Dict[str, Any]:
+        """
+        Fetch file content by file ID.
+
+        Args:
+            file_id: Unique identifier of the file.
+
+        Returns:
+            Dict: Raw content payload from the platform API.
+            Expected keys may include:
+            - content_bytes: bytes
+            - content_text: str
+            - mime_type: str
+            - size: int
+            - checksum: str
+            - encoding: str
+        """
+        ...
+
+    @abstractmethod
+    def normalize_file(self, raw_file: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Transform a platform-specific file into canonical format.
+
+        Args:
+            raw_file: Raw file object from the platform API.
+
+        Returns:
+            Normalized file dictionary in canonical format.
+        """
+        ...
+
+    @abstractmethod
+    def normalize_folder(self, raw_folder: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Transform a platform-specific folder into canonical format.
+
+        Args:
+            raw_folder: Raw folder object from the platform API.
+
+        Returns:
+            Normalized folder dictionary in canonical format.
+        """
+        ...
+
+
+@dataclass
+class FileMetadata:
+    id: str
+    name: str
+    path: Optional[str] = None
+    mime_type: Optional[str] = None
+    size: Optional[int] = None
+    modified_at: Optional[datetime] = None
+    created_at: Optional[datetime] = None
+    checksum: Optional[str] = None
+    direct_link: Optional[str] = None
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class FolderMetadata:
+    id: str
+    name: str
+    path: Optional[str] = None
+    parent_id: Optional[str] = None
+    created_at: Optional[datetime] = None
+    modified_at: Optional[datetime] = None
+    item_count: Optional[int] = None
+    direct_link: Optional[str] = None
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class FileContent:
+    file_id: str
+    name: Optional[str] = None
+    mime_type: Optional[str] = None
+    size: Optional[int] = None
+    content_bytes: Optional[bytes] = None
+    content_text: Optional[str] = None
+    checksum: Optional[str] = None
+    encoding: Optional[str] = None
+    metadata: Dict[str, Any] = field(default_factory=dict)