definite-sdk 0.1.8__tar.gz → 0.1.9__tar.gz

{definite_sdk-0.1.8 → definite_sdk-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: definite-sdk
-Version: 0.1.8
+Version: 0.1.9
 Summary: Definite SDK for Python
 License: MIT
 Author: Definite
@@ -21,7 +21,7 @@ Description-Content-Type: text/markdown
 
 # Definite SDK
 
-A Python client for interacting with the Definite API, providing a convenient interface for key-value store operations, SQL query execution, secrets management, and DLT (Data Load Tool) integration with state persistence.
+A Python client for interacting with the Definite API, providing a convenient interface for key-value store operations, SQL query execution, secrets management, messaging capabilities, and DLT (Data Load Tool) integration with state persistence.
 
 ## Installation
 
@@ -57,6 +57,7 @@ client = DefiniteClient("YOUR_API_KEY")
 - **Cube Query Execution**: Execute Cube queries for advanced analytics and data modeling
 - **Secret Management**: Secure storage and retrieval of application secrets
 - **Integration Store**: Read-only access to integration configurations
+- **Messaging**: Send messages through various channels (Slack, and more coming soon)
 - **dlt Integration**: Run dlt pipelines with automatic state persistence to Definite
 - **DuckDB Support**: Automatic discovery and connection to team's DuckDB integrations
 
@@ -167,6 +168,49 @@ integrations = list(integration_store.list_integrations())
 integration = integration_store.get_integration("my_integration")
 ```
 
+### 💬 Messaging
+
+Send messages through various channels using the messaging client.
+
+```python
+# Initialize the message client
+message_client = client.get_message_client()
+# Or use the alias method
+message_client = client.message_client()
+
+# Send a Slack message using the unified interface
+result = message_client.send_message(
+    channel="slack",
+    integration_id="your_slack_integration_id",
+    to="C0920MVPWFN",  # Slack channel ID
+    content="Hello from Definite SDK! 👋"
+)
+
+# Send a Slack message with blocks and threading
+result = message_client.send_message(
+    channel="slack",
+    integration_id="your_slack_integration_id",
+    to="C0920MVPWFN",
+    content="Fallback text",
+    blocks=[{
+        "type": "section",
+        "text": {"type": "mrkdwn", "text": "*Important Update*"}
+    }],
+    thread_ts="1234567890.123456"  # Reply in thread
+)
+
+# Or use the convenience method for Slack
+result = message_client.send_slack_message(
+    integration_id="your_slack_integration_id",
+    channel_id="C0920MVPWFN",
+    text="Quick message using the convenience method!",
+    blocks=[{
+        "type": "section",
+        "text": {"type": "mrkdwn", "text": "Message with *rich* _formatting_"}
+    }]
+)
+```
+
 ### dlt Integration
 
 ```python

{definite_sdk-0.1.8 → definite_sdk-0.1.9}/README.md

@@ -1,6 +1,6 @@
 # Definite SDK
 
-A Python client for interacting with the Definite API, providing a convenient interface for key-value store operations, SQL query execution, secrets management, and DLT (Data Load Tool) integration with state persistence.
+A Python client for interacting with the Definite API, providing a convenient interface for key-value store operations, SQL query execution, secrets management, messaging capabilities, and DLT (Data Load Tool) integration with state persistence.
 
 ## Installation
 
@@ -36,6 +36,7 @@ client = DefiniteClient("YOUR_API_KEY")
 - **Cube Query Execution**: Execute Cube queries for advanced analytics and data modeling
 - **Secret Management**: Secure storage and retrieval of application secrets
 - **Integration Store**: Read-only access to integration configurations
+- **Messaging**: Send messages through various channels (Slack, and more coming soon)
 - **dlt Integration**: Run dlt pipelines with automatic state persistence to Definite
 - **DuckDB Support**: Automatic discovery and connection to team's DuckDB integrations
 
@@ -146,6 +147,49 @@ integrations = list(integration_store.list_integrations())
 integration = integration_store.get_integration("my_integration")
 ```
 
+### 💬 Messaging
+
+Send messages through various channels using the messaging client.
+
+```python
+# Initialize the message client
+message_client = client.get_message_client()
+# Or use the alias method
+message_client = client.message_client()
+
+# Send a Slack message using the unified interface
+result = message_client.send_message(
+    channel="slack",
+    integration_id="your_slack_integration_id",
+    to="C0920MVPWFN",  # Slack channel ID
+    content="Hello from Definite SDK! 👋"
+)
+
+# Send a Slack message with blocks and threading
+result = message_client.send_message(
+    channel="slack",
+    integration_id="your_slack_integration_id",
+    to="C0920MVPWFN",
+    content="Fallback text",
+    blocks=[{
+        "type": "section",
+        "text": {"type": "mrkdwn", "text": "*Important Update*"}
+    }],
+    thread_ts="1234567890.123456"  # Reply in thread
+)
+
+# Or use the convenience method for Slack
+result = message_client.send_slack_message(
+    integration_id="your_slack_integration_id",
+    channel_id="C0920MVPWFN",
+    text="Quick message using the convenience method!",
+    blocks=[{
+        "type": "section",
+        "text": {"type": "mrkdwn", "text": "Message with *rich* _formatting_"}
+    }]
+)
+```
+
 ### dlt Integration
 
 ```python

{definite_sdk-0.1.8 → definite_sdk-0.1.9}/definite_sdk/__init__.py

@@ -6,14 +6,16 @@ A Python library for interacting with the Definite API and tools.
 
 from definite_sdk.client import DefiniteClient
 from definite_sdk.integration import DefiniteIntegrationStore
+from definite_sdk.message import DefiniteMessageClient
 from definite_sdk.secret import DefiniteSecretStore
 from definite_sdk.sql import DefiniteSqlClient
 from definite_sdk.store import DefiniteKVStore
 
-__version__ = "0.1.8"
+__version__ = "0.1.9"
 __all__ = [
     "DefiniteClient",
     "DefiniteIntegrationStore",
+    "DefiniteMessageClient",
     "DefiniteSecretStore",
     "DefiniteSqlClient",
     "DefiniteKVStore",

{definite_sdk-0.1.8 → definite_sdk-0.1.9}/definite_sdk/client.py

@@ -2,6 +2,7 @@ import os
 from typing import Optional
 
 from definite_sdk.integration import DefiniteIntegrationStore
+from definite_sdk.message import DefiniteMessageClient
 from definite_sdk.secret import DefiniteSecretStore
 from definite_sdk.sql import DefiniteSqlClient
 from definite_sdk.store import DefiniteKVStore
@@ -77,3 +78,15 @@ class DefiniteClient:
     def integration_store(self) -> DefiniteIntegrationStore:
         """Alias for get_integration_store."""
         return self.get_integration_store()
+
+    def get_message_client(self) -> DefiniteMessageClient:
+        """Initializes the message client for sending messages via various channels.
+
+        See DefiniteMessageClient for more how to send messages.
+        """
+
+        return DefiniteMessageClient(self.api_key, self.api_url)
+
+    def message_client(self) -> DefiniteMessageClient:
+        """Alias for get_message_client."""
+        return self.get_message_client()

definite_sdk-0.1.9/definite_sdk/message.py

@@ -0,0 +1,199 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+
+MESSAGE_ENDPOINT = "/v3"
+
+
+class DefiniteMessageClient:
+    """
+    A message client for sending messages via various channels through the Definite API.
+
+    Initialization:
+    >>> client = DefiniteClient("MY_API_KEY")
+    >>> message_client = client.get_message_client()
+
+    Sending messages:
+    >>> # Send a Slack message
+    >>> result = message_client.send_message(
+    ...     channel="slack",
+    ...     integration_id="slack_integration_id",
+    ...     to="C0920MVPWFN",  # channel_id
+    ...     content="Hello from Definite SDK!"
+    ... )
+    
+    >>> # Send a Slack message with blocks and thread
+    >>> result = message_client.send_message(
+    ...     channel="slack",
+    ...     integration_id="slack_integration_id",
+    ...     to="C0920MVPWFN",
+    ...     content="Hello!",
+    ...     blocks=[{"type": "section", "text": {"type": "mrkdwn", "text": "Hello!"}}],
+    ...     thread_ts="1234567890.123456"
+    ... )
+    """
+
+    def __init__(self, api_key: str, api_url: str):
+        """
+        Initializes the DefiniteMessageClient.
+
+        Args:
+            api_key (str): The API key for authorization.
+            api_url (str): The base URL for the Definite API.
+        """
+        self._api_key = api_key
+        self._message_url = api_url + MESSAGE_ENDPOINT
+
+    def send_message(
+        self,
+        channel: str,
+        integration_id: str,
+        to: str,
+        content: str,
+        subject: Optional[str] = None,
+        blocks: Optional[List[Dict[str, Any]]] = None,
+        thread_ts: Optional[str] = None,
+        **kwargs: Any
+    ) -> Dict[str, Any]:
+        """
+        Sends a message through the specified channel.
+
+        Args:
+            channel (str): The messaging channel to use (e.g., "slack", "email").
+            integration_id (str): The ID of the integration to use.
+            to (str): The recipient identifier (channel_id for Slack, email address for email).
+            content (str): The message content (text for Slack, body for email).
+            subject (Optional[str]): Subject line (used for email).
+            blocks (Optional[List[Dict[str, Any]]]): Slack Block Kit blocks for formatting.
+            thread_ts (Optional[str]): Slack thread timestamp to reply to.
+            **kwargs: Additional channel-specific parameters.
+
+        Returns:
+            Dict[str, Any]: The response from the API.
+
+        Raises:
+            requests.HTTPError: If the API request fails.
+            ValueError: If the channel is not supported.
+
+        Example:
+            >>> # Slack message
+            >>> result = message_client.send_message(
+            ...     channel="slack",
+            ...     integration_id="slack_123",
+            ...     to="C0920MVPWFN",
+            ...     content="Hello team!"
+            ... )
+            
+            >>> # Slack message with blocks
+            >>> result = message_client.send_message(
+            ...     channel="slack",
+            ...     integration_id="slack_123",
+            ...     to="C0920MVPWFN",
+            ...     content="Fallback text",
+            ...     blocks=[{
+            ...         "type": "section",
+            ...         "text": {"type": "mrkdwn", "text": "*Important Update*"}
+            ...     }]
+            ... )
+        """
+        channel_lower = channel.lower()
+        
+        if channel_lower == "slack":
+            return self._send_slack_message(
+                integration_id=integration_id,
+                channel_id=to,
+                text=content,
+                blocks=blocks,
+                thread_ts=thread_ts,
+                **kwargs
+            )
+        else:
+            raise ValueError(f"Unsupported channel: {channel}")
+
+    def _send_slack_message(
+        self,
+        integration_id: str,
+        channel_id: str,
+        text: str,
+        blocks: Optional[List[Dict[str, Any]]] = None,
+        thread_ts: Optional[str] = None,
+        **kwargs: Any
+    ) -> Dict[str, Any]:
+        """
+        Internal method to send a Slack message.
+
+        Args:
+            integration_id (str): The Slack integration ID.
+            channel_id (str): The Slack channel ID.
+            text (str): The message text.
+            blocks (Optional[List[Dict[str, Any]]]): Slack blocks for formatting.
+            thread_ts (Optional[str]): Thread timestamp for replies.
+            **kwargs: Additional Slack-specific parameters.
+
+        Returns:
+            Dict[str, Any]: The API response.
+        """
+        url = f"{self._message_url}/slack/message"
+        
+        payload = {
+            "integration_id": integration_id,
+            "channel_id": channel_id,
+            "text": text
+        }
+        
+        if blocks:
+            payload["blocks"] = blocks
+        if thread_ts:
+            payload["thread_ts"] = thread_ts
+            
+        # Add any additional kwargs to the payload
+        payload.update(kwargs)
+
+        response = requests.post(
+            url,
+            json=payload,
+            headers={"Authorization": "Bearer " + self._api_key},
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def send_slack_message(
+        self,
+        integration_id: str,
+        channel_id: str,
+        text: str,
+        blocks: Optional[List[Dict[str, Any]]] = None,
+        thread_ts: Optional[str] = None,
+        **kwargs: Any
+    ) -> Dict[str, Any]:
+        """
+        Convenience method to send a Slack message directly.
+
+        Args:
+            integration_id (str): The Slack integration ID.
+            channel_id (str): The Slack channel ID.
+            text (str): The message text.
+            blocks (Optional[List[Dict[str, Any]]]): Slack blocks for formatting.
+            thread_ts (Optional[str]): Thread timestamp for replies.
+            **kwargs: Additional Slack-specific parameters.
+
+        Returns:
+            Dict[str, Any]: The API response.
+
+        Example:
+            >>> result = message_client.send_slack_message(
+            ...     integration_id="slack_123",
+            ...     channel_id="C0920MVPWFN",
+            ...     text="Hello from Definite SDK! 👋"
+            ... )
+            >>> print(f"Message sent! Timestamp: {result['ts']}")
+        """
+        return self.send_message(
+            channel="slack",
+            integration_id=integration_id,
+            to=channel_id,
+            content=text,
+            blocks=blocks,
+            thread_ts=thread_ts,
+            **kwargs
+        )

{definite_sdk-0.1.8 → definite_sdk-0.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "definite-sdk"
-version = "0.1.8"
+version = "0.1.9"
 description = "Definite SDK for Python"
 authors = ["Definite <hello@definite.app>"]
 license = "MIT"