midbound-cloud 0.0.0.dev0__tar.gz

midbound_cloud-0.0.0.dev0/.gitignore

@@ -0,0 +1,28 @@
+# Fetched from live API
+openapi.json
+
+# Generated code
+typescript/src/generated/
+python/src/midbound_cloud/generated/
+go/generated/
+java/src/main/java/
+php/src/
+rust/src/
+
+# Build artifacts
+typescript/dist/
+python/dist/
+java/target/
+rust/target/
+
+# Dependencies
+node_modules/
+__pycache__/
+*.egg-info/
+.venv/
+venv/
+
+# IDE
+.idea/
+*.iml
+.vscode/

midbound_cloud-0.0.0.dev0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: midbound-cloud
+Version: 0.0.0.dev0
+Summary: Official Midbound Cloud SDK for Python
+Project-URL: Homepage, https://midbound.cloud
+Project-URL: Documentation, https://midbound.cloud/docs
+Project-URL: Repository, https://github.com/midbound/midbound-monorepo
+Project-URL: Issues, https://github.com/midbound/midbound-monorepo/issues
+Author-email: Midbound <support@midbound.com>
+License-Expression: MIT
+Keywords: api,b2b,enrichment,midbound,sdk,visitor-identification
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# midbound-cloud
+
+Official Midbound Cloud SDK for Python.
+
+## Installation
+
+```bash
+pip install midbound-cloud
+```
+
+## Usage
+
+```python
+from midbound_cloud import Midbound
+
+client = Midbound(api_key="your-api-key")
+
+# Enrich a person by LinkedIn URL
+result = client.enrich.person(linkedin_url="https://linkedin.com/in/example")
+print(result)
+```
+
+## Webhook Verification
+
+```python
+from midbound_cloud import webhooks
+
+# Verify a webhook signature
+is_valid = webhooks.verify_signature(
+    payload=request.body,
+    signature=request.headers["x-midbound-signature"],
+    secret=os.environ["WEBHOOK_SECRET"]
+)
+
+# Or construct a typed event
+event = webhooks.construct_event(
+    payload=request.body,
+    signature=request.headers["x-midbound-signature"],
+    secret=os.environ["WEBHOOK_SECRET"]
+)
+print(event["type"])  # e.g., "identity.resolved"
+```
+
+## Documentation
+
+Full documentation available at [midbound.cloud/docs](https://midbound.cloud/docs).

midbound_cloud-0.0.0.dev0/README.md

@@ -0,0 +1,46 @@
+# midbound-cloud
+
+Official Midbound Cloud SDK for Python.
+
+## Installation
+
+```bash
+pip install midbound-cloud
+```
+
+## Usage
+
+```python
+from midbound_cloud import Midbound
+
+client = Midbound(api_key="your-api-key")
+
+# Enrich a person by LinkedIn URL
+result = client.enrich.person(linkedin_url="https://linkedin.com/in/example")
+print(result)
+```
+
+## Webhook Verification
+
+```python
+from midbound_cloud import webhooks
+
+# Verify a webhook signature
+is_valid = webhooks.verify_signature(
+    payload=request.body,
+    signature=request.headers["x-midbound-signature"],
+    secret=os.environ["WEBHOOK_SECRET"]
+)
+
+# Or construct a typed event
+event = webhooks.construct_event(
+    payload=request.body,
+    signature=request.headers["x-midbound-signature"],
+    secret=os.environ["WEBHOOK_SECRET"]
+)
+print(event["type"])  # e.g., "identity.resolved"
+```
+
+## Documentation
+
+Full documentation available at [midbound.cloud/docs](https://midbound.cloud/docs).

midbound_cloud-0.0.0.dev0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "midbound-cloud"
+version = "0.0.0.dev0"
+description = "Official Midbound Cloud SDK for Python"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Midbound", email = "support@midbound.com" }
+]
+keywords = [
+    "midbound",
+    "api",
+    "sdk",
+    "enrichment",
+    "b2b",
+    "visitor-identification"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed"
+]
+dependencies = [
+    "httpx>=0.25.0",
+    "pydantic>=2.0.0"
+]
+
+[project.urls]
+Homepage = "https://midbound.cloud"
+Documentation = "https://midbound.cloud/docs"
+Repository = "https://github.com/midbound/midbound-monorepo"
+Issues = "https://github.com/midbound/midbound-monorepo/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/midbound_cloud"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src"
+]

midbound_cloud-0.0.0.dev0/src/midbound_cloud/__init__.py

@@ -0,0 +1,11 @@
+"""
+Midbound Cloud SDK for Python.
+
+Official SDK for interacting with the Midbound Cloud API.
+"""
+
+from .client import Midbound
+from . import webhooks
+
+__all__ = ["Midbound", "webhooks"]
+__version__ = "0.0.0.dev0"

midbound_cloud-0.0.0.dev0/src/midbound_cloud/client.py

@@ -0,0 +1,91 @@
+"""
+Midbound Cloud SDK client.
+"""
+
+from typing import Optional
+import httpx
+
+
+class EnrichAPI:
+    """Enrichment API for person and company data."""
+
+    def __init__(self, client: httpx.Client):
+        self._client = client
+
+    def person(
+        self,
+        linkedin_url: Optional[str] = None,
+        email: Optional[str] = None,
+        webhook_url: Optional[str] = None,
+        webhook_secret: Optional[str] = None,
+    ) -> dict:
+        """
+        Enrich a person by LinkedIn URL or email.
+
+        Args:
+            linkedin_url: LinkedIn profile URL
+            email: Email address
+            webhook_url: Optional webhook URL for async results
+            webhook_secret: Optional webhook signing secret
+
+        Returns:
+            Enrichment result dictionary
+        """
+        payload = {}
+        if linkedin_url:
+            payload["linkedinUrl"] = linkedin_url
+        if email:
+            payload["email"] = email
+        if webhook_url:
+            payload["webhookUrl"] = webhook_url
+        if webhook_secret:
+            payload["webhookSecret"] = webhook_secret
+
+        response = self._client.post("/v1/enrich/person", json=payload)
+        response.raise_for_status()
+        return response.json()
+
+
+class Midbound:
+    """
+    Midbound Cloud SDK client.
+
+    Example:
+        >>> from midbound_cloud import Midbound
+        >>> client = Midbound(api_key="your-api-key")
+        >>> result = client.enrich.person(linkedin_url="https://linkedin.com/in/example")
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.midbound.cloud",
+        timeout: float = 30.0,
+    ):
+        """
+        Initialize the Midbound client.
+
+        Args:
+            api_key: Your Midbound API key
+            base_url: Base URL for the API (default: production)
+            timeout: Request timeout in seconds
+        """
+        self._client = httpx.Client(
+            base_url=base_url,
+            headers={
+                "x-api-key": api_key,
+                "Content-Type": "application/json",
+            },
+            timeout=timeout,
+        )
+        self.enrich = EnrichAPI(self._client)
+
+    def close(self) -> None:
+        """Close the HTTP client."""
+        self._client.close()
+
+    def __enter__(self) -> "Midbound":
+        return self
+
+    def __exit__(self, *args) -> None:
+        self.close()

midbound_cloud-0.0.0.dev0/src/midbound_cloud/webhooks.py

@@ -0,0 +1,125 @@
+"""
+Webhook signature verification utilities.
+
+Verify webhook payloads from Midbound to ensure they are authentic
+and haven't been tampered with.
+"""
+
+import hmac
+import hashlib
+import json
+import re
+import time
+from typing import Any, Dict, TypeVar, Type, Union
+
+T = TypeVar("T")
+
+
+def verify_signature(
+    payload: str,
+    signature: str,
+    secret: str,
+    max_age_seconds: int = 300,
+) -> bool:
+    """
+    Verify a webhook signature.
+
+    Validates that the webhook payload was signed by Midbound using your
+    webhook signing secret. Also checks that the signature hasn't expired.
+
+    Args:
+        payload: The raw JSON payload string from the request body
+        signature: The signature header value (x-midbound-signature)
+        secret: Your webhook signing secret
+        max_age_seconds: Maximum age of signature in seconds (default: 300 = 5 minutes)
+
+    Returns:
+        True if signature is valid and not expired
+
+    Example:
+        >>> from midbound_cloud import webhooks
+        >>>
+        >>> is_valid = webhooks.verify_signature(
+        ...     payload=request.body,
+        ...     signature=request.headers["x-midbound-signature"],
+        ...     secret=os.environ["WEBHOOK_SECRET"]
+        ... )
+    """
+    match = re.match(r"t=(\d+),v1=([a-f0-9]+)", signature)
+    if not match:
+        return False
+
+    timestamp_str, received_sig = match.groups()
+    timestamp = int(timestamp_str)
+
+    # Check expiry
+    if time.time() - timestamp > max_age_seconds:
+        return False
+
+    # Verify signature
+    signed_payload = f"{timestamp}.{payload}"
+    expected_sig = hmac.new(
+        secret.encode(),
+        signed_payload.encode(),
+        hashlib.sha256,
+    ).hexdigest()
+
+    # Use timing-safe comparison to prevent timing attacks
+    return hmac.compare_digest(expected_sig, received_sig)
+
+
+def construct_event(
+    payload: str,
+    signature: str,
+    secret: str,
+    event_class: Type[T] = dict,  # type: ignore
+) -> Union[T, Dict[str, Any]]:
+    """
+    Verify signature and construct a webhook event.
+
+    Combines signature verification with JSON parsing. Raises ValueError
+    if the signature is invalid.
+
+    Args:
+        payload: The raw JSON payload string from the request body
+        signature: The signature header value (x-midbound-signature)
+        secret: Your webhook signing secret
+        event_class: Optional class to instantiate with event data
+
+    Returns:
+        The parsed webhook event (dict or event_class instance)
+
+    Raises:
+        ValueError: If signature is invalid
+
+    Example:
+        >>> from midbound_cloud import webhooks
+        >>>
+        >>> try:
+        ...     event = webhooks.construct_event(
+        ...         payload=request.body,
+        ...         signature=request.headers["x-midbound-signature"],
+        ...         secret=os.environ["WEBHOOK_SECRET"]
+        ...     )
+        ...     print(event["type"])  # e.g., "identity.resolved"
+        ... except ValueError:
+        ...     print("Invalid webhook signature")
+    """
+    if not verify_signature(payload, signature, secret):
+        raise ValueError("Invalid webhook signature")
+
+    data = json.loads(payload)
+
+    if event_class is dict:
+        return data
+    return event_class(**data)
+
+
+# Event type constants
+EVENT_TYPES = (
+    "identity.resolved",
+    "identity.qualified",
+    "identity.enriched",
+    "identity.validated",
+    "identity.session.finalized",
+)