hookbridge 1.2.0__tar.gz → 1.3.0__tar.gz

hookbridge-1.3.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(mypy hookbridge:*)",
+      "Bash(ruff check:*)"
+    ]
+  }
+}

{hookbridge-1.2.0 → hookbridge-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hookbridge
-Version: 1.2.0
+Version: 1.3.0
 Summary: Official HookBridge SDK for Python
 Project-URL: Homepage, https://hookbridge.io
 Project-URL: Documentation, https://hookbridge.io/docs/sdks/python

{hookbridge-1.2.0 → hookbridge-1.3.0}/hookbridge/__init__.py

@@ -44,16 +44,14 @@ from hookbridge.types import (
     MessageSummary,
     Metrics,
     MetricsWindow,
-    NotificationPreferences,
     PauseState,
-    Personalization,
     PortalSession,
     Project,
+    ReplayableMessageStatus,
     ReplayAllMessagesResponse,
     ReplayBatchMessagesResponse,
     ReplayBatchResult,
     ReplayMessageResponse,
-    ReplayableMessageStatus,
     RotateSecretResponse,
     SendWebhookResponse,
     SigningKey,
@@ -67,7 +65,7 @@ from hookbridge.types import (
     UsageHistoryRow,
 )
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"
 
 __all__ = [
     "HookBridge",
@@ -101,9 +99,7 @@ __all__ = [
     "MessageSummary",
     "Metrics",
     "MetricsWindow",
-    "NotificationPreferences",
     "PauseState",
-    "Personalization",
     "PortalSession",
     "Project",
     "ReplayAllMessagesResponse",

{hookbridge-1.2.0 → hookbridge-1.3.0}/hookbridge/client.py

@@ -51,16 +51,14 @@ from hookbridge.types import (
     MessageSummary,
     Metrics,
     MetricsWindow,
-    NotificationPreferences,
     PauseState,
-    Personalization,
     PortalSession,
     Project,
+    ReplayableMessageStatus,
     ReplayAllMessagesResponse,
     ReplayBatchMessagesResponse,
     ReplayBatchResult,
     ReplayMessageResponse,
-    ReplayableMessageStatus,
     RotateSecretResponse,
     SendWebhookResponse,
     SigningKey,
@@ -95,9 +93,7 @@ def _query_string(params: dict[str, Any]) -> str:
     for key, value in params.items():
         if value is None:
             continue
-        if isinstance(value, datetime):
-            encoded[key] = value.isoformat()
-        elif isinstance(value, date):
+        if isinstance(value, (datetime, date)):
             encoded[key] = value.isoformat()
         else:
             encoded[key] = str(value)
@@ -111,6 +107,14 @@ def _with_query(path: str, params: dict[str, Any]) -> str:
     return f"{path}?{query}"
 
 
+def _json_value(value: Any) -> Any:
+    if isinstance(value, datetime):
+        return value.isoformat()
+    if isinstance(value, date):
+        return value.isoformat()
+    return value
+
+
 def _parse_message(data: dict[str, Any]) -> Message:
     return Message(
         id=data["id"],
@@ -294,31 +298,6 @@ def _parse_rotate_secret(data: dict[str, Any]) -> RotateSecretResponse:
     )
 
 
-def _parse_personalization(data: dict[str, Any]) -> Personalization:
-    return Personalization(
-        id=data["id"],
-        user_id=data["user_id"],
-        timezone=data["timezone"],
-        date_format=data["date_format"],
-        locale=data["locale"],
-        created_at=_parse_datetime(data["created_at"]),
-        updated_at=_parse_datetime(data["updated_at"]),
-    )
-
-
-def _parse_notification_preferences(data: dict[str, Any]) -> NotificationPreferences:
-    return NotificationPreferences(
-        id=data["id"],
-        user_id=data["user_id"],
-        enabled_alert_types=data["enabled_alert_types"],
-        delivery_channels=data["delivery_channels"],
-        failure_rate_threshold=data["failure_rate_threshold"],
-        pending_backlog_threshold=data["pending_backlog_threshold"],
-        created_at=_parse_datetime(data["created_at"]),
-        updated_at=_parse_datetime(data["updated_at"]),
-    )
-
-
 def _parse_usage_history_row(data: dict[str, Any]) -> UsageHistoryRow:
     return UsageHistoryRow(
         period_start=_parse_date(data["period_start"]),
@@ -558,7 +537,9 @@ class HookBridge:
         return _parse_replay_all_messages(self._request("POST", path)["data"])
 
     def replay_batch_messages(self, message_ids: list[str]) -> ReplayBatchMessagesResponse:
-        response = self._request("POST", "/v1/messages/replay-batch", json={"message_ids": message_ids})
+        response = self._request(
+            "POST", "/v1/messages/replay-batch", json={"message_ids": message_ids}
+        )
         return _parse_replay_batch_messages(response["data"])
 
     def get_logs(
@@ -605,7 +586,8 @@ class HookBridge:
     def get_dlq_messages(
         self, *, limit: Optional[int] = None, cursor: Optional[str] = None
     ) -> DLQMessagesResponse:
-        response = self._request("GET", _with_query("/v1/dlq/messages", {"limit": limit, "cursor": cursor}))
+        path = _with_query("/v1/dlq/messages", {"limit": limit, "cursor": cursor})
+        response = self._request("GET", path)
         data = response["data"]
         return DLQMessagesResponse(
             messages=[_parse_message_summary(item) for item in data.get("messages", [])],
@@ -650,7 +632,11 @@ class HookBridge:
         return _parse_project(self._request("GET", f"/v1/projects/{project_id}")["data"])
 
     def update_project(
-        self, project_id: str, *, name: Optional[str] = None, rate_limit_default: Optional[int] = None
+        self,
+        project_id: str,
+        *,
+        name: Optional[str] = None,
+        rate_limit_default: Optional[int] = None,
     ) -> Project:
         body: dict[str, Any] = {}
         if name is not None:
@@ -697,7 +683,8 @@ class HookBridge:
     def list_endpoints(
         self, *, limit: Optional[int] = None, cursor: Optional[str] = None
     ) -> ListEndpointsResponse:
-        response = self._request("GET", _with_query("/v1/endpoints", {"limit": limit, "cursor": cursor}))
+        path = _with_query("/v1/endpoints", {"limit": limit, "cursor": cursor})
+        response = self._request("GET", path)
         meta = response.get("meta", {})
         next_cursor = meta.get("next_cursor")
         return ListEndpointsResponse(
@@ -746,55 +733,6 @@ class HookBridge:
     def rotate_endpoint_secret(self, endpoint_id: str) -> RotateSecretResponse:
         return self.create_endpoint_signing_key(endpoint_id)
 
-    def get_personalization(self) -> Personalization:
-        return _parse_personalization(
-            self._request("GET", "/v1/settings/personalization")["data"]
-        )
-
-    def update_personalization(
-        self,
-        *,
-        timezone: Optional[str] = None,
-        date_format: Optional[str] = None,
-        locale: Optional[str] = None,
-    ) -> Personalization:
-        body: dict[str, Any] = {}
-        if timezone is not None:
-            body["timezone"] = timezone
-        if date_format is not None:
-            body["date_format"] = date_format
-        if locale is not None:
-            body["locale"] = locale
-        return _parse_personalization(
-            self._request("PUT", "/v1/settings/personalization", json=body)["data"]
-        )
-
-    def get_notification_preferences(self) -> NotificationPreferences:
-        return _parse_notification_preferences(
-            self._request("GET", "/v1/settings/notifications")["data"]
-        )
-
-    def update_notification_preferences(
-        self,
-        *,
-        enabled_alert_types: Optional[list[str]] = None,
-        delivery_channels: Optional[list[str]] = None,
-        failure_rate_threshold: Optional[int] = None,
-        pending_backlog_threshold: Optional[int] = None,
-    ) -> NotificationPreferences:
-        body: dict[str, Any] = {}
-        if enabled_alert_types is not None:
-            body["enabled_alert_types"] = enabled_alert_types
-        if delivery_channels is not None:
-            body["delivery_channels"] = delivery_channels
-        if failure_rate_threshold is not None:
-            body["failure_rate_threshold"] = failure_rate_threshold
-        if pending_backlog_threshold is not None:
-            body["pending_backlog_threshold"] = pending_backlog_threshold
-        return _parse_notification_preferences(
-            self._request("PUT", "/v1/settings/notifications", json=body)["data"]
-        )
-
     def create_checkout(self, *, plan: str, interval: str) -> CheckoutSession:
         data = self._request(
             "POST", "/v1/billing/checkout", json={"plan": plan, "interval": interval}
@@ -1038,7 +976,10 @@ class HookBridge:
         status: Optional[MessageStatus] = None,
         endpoint_id: Optional[str] = None,
     ) -> ExportRecord:
-        body: dict[str, Any] = {"start_time": start_time, "end_time": end_time}
+        body: dict[str, Any] = {
+            "start_time": _json_value(start_time),
+            "end_time": _json_value(end_time),
+        }
         if status is not None:
             body["status"] = status
         if endpoint_id is not None:
@@ -1243,7 +1184,8 @@ class AsyncHookBridge:
         await self._request("POST", f"/v1/dlq/replay/{message_id}")
 
     async def list_api_keys(self) -> list[APIKeyInfo]:
-        return [_parse_api_key_info(item) for item in (await self._request("GET", "/v1/api-keys"))["data"]]
+        response = await self._request("GET", "/v1/api-keys")
+        return [_parse_api_key_info(item) for item in response["data"]]
 
     async def create_api_key(
         self, mode: APIKeyMode, *, label: Optional[str] = None
@@ -1264,9 +1206,12 @@ class AsyncHookBridge:
         await self._request("DELETE", f"/v1/api-keys/{key_id}")
 
     async def list_projects(self) -> list[Project]:
-        return [_parse_project(item) for item in (await self._request("GET", "/v1/projects"))["data"]]
+        response = await self._request("GET", "/v1/projects")
+        return [_parse_project(item) for item in response["data"]]
 
-    async def create_project(self, name: str, *, rate_limit_default: Optional[int] = None) -> Project:
+    async def create_project(
+        self, name: str, *, rate_limit_default: Optional[int] = None
+    ) -> Project:
         body: dict[str, Any] = {"name": name}
         if rate_limit_default is not None:
             body["rate_limit_default"] = rate_limit_default
@@ -1276,14 +1221,19 @@ class AsyncHookBridge:
         return _parse_project((await self._request("GET", f"/v1/projects/{project_id}"))["data"])
 
     async def update_project(
-        self, project_id: str, *, name: Optional[str] = None, rate_limit_default: Optional[int] = None
+        self,
+        project_id: str,
+        *,
+        name: Optional[str] = None,
+        rate_limit_default: Optional[int] = None,
     ) -> Project:
         body: dict[str, Any] = {}
         if name is not None:
             body["name"] = name
         if rate_limit_default is not None:
             body["rate_limit_default"] = rate_limit_default
-        return _parse_project((await self._request("PUT", f"/v1/projects/{project_id}", json=body))["data"])
+        response = await self._request("PUT", f"/v1/projects/{project_id}", json=body)
+        return _parse_project(response["data"])
 
     async def delete_project(self, project_id: str) -> None:
         await self._request("DELETE", f"/v1/projects/{project_id}")
@@ -1374,55 +1324,6 @@ class AsyncHookBridge:
     async def rotate_endpoint_secret(self, endpoint_id: str) -> RotateSecretResponse:
         return await self.create_endpoint_signing_key(endpoint_id)
 
-    async def get_personalization(self) -> Personalization:
-        return _parse_personalization(
-            (await self._request("GET", "/v1/settings/personalization"))["data"]
-        )
-
-    async def update_personalization(
-        self,
-        *,
-        timezone: Optional[str] = None,
-        date_format: Optional[str] = None,
-        locale: Optional[str] = None,
-    ) -> Personalization:
-        body: dict[str, Any] = {}
-        if timezone is not None:
-            body["timezone"] = timezone
-        if date_format is not None:
-            body["date_format"] = date_format
-        if locale is not None:
-            body["locale"] = locale
-        return _parse_personalization(
-            (await self._request("PUT", "/v1/settings/personalization", json=body))["data"]
-        )
-
-    async def get_notification_preferences(self) -> NotificationPreferences:
-        return _parse_notification_preferences(
-            (await self._request("GET", "/v1/settings/notifications"))["data"]
-        )
-
-    async def update_notification_preferences(
-        self,
-        *,
-        enabled_alert_types: Optional[list[str]] = None,
-        delivery_channels: Optional[list[str]] = None,
-        failure_rate_threshold: Optional[int] = None,
-        pending_backlog_threshold: Optional[int] = None,
-    ) -> NotificationPreferences:
-        body: dict[str, Any] = {}
-        if enabled_alert_types is not None:
-            body["enabled_alert_types"] = enabled_alert_types
-        if delivery_channels is not None:
-            body["delivery_channels"] = delivery_channels
-        if failure_rate_threshold is not None:
-            body["failure_rate_threshold"] = failure_rate_threshold
-        if pending_backlog_threshold is not None:
-            body["pending_backlog_threshold"] = pending_backlog_threshold
-        return _parse_notification_preferences(
-            (await self._request("PUT", "/v1/settings/notifications", json=body))["data"]
-        )
-
     async def create_checkout(self, *, plan: str, interval: str) -> CheckoutSession:
         data = (
             await self._request(
@@ -1674,7 +1575,10 @@ class AsyncHookBridge:
         status: Optional[MessageStatus] = None,
         endpoint_id: Optional[str] = None,
     ) -> ExportRecord:
-        body: dict[str, Any] = {"start_time": start_time, "end_time": end_time}
+        body: dict[str, Any] = {
+            "start_time": _json_value(start_time),
+            "end_time": _json_value(end_time),
+        }
         if status is not None:
             body["status"] = status
         if endpoint_id is not None:
@@ -1682,10 +1586,12 @@ class AsyncHookBridge:
         return _parse_export_record((await self._request("POST", "/v1/exports", json=body))["data"])
 
     async def list_exports(self) -> list[ExportRecord]:
-        return [_parse_export_record(item) for item in (await self._request("GET", "/v1/exports"))["data"]]
+        response = await self._request("GET", "/v1/exports")
+        return [_parse_export_record(item) for item in response["data"]]
 
     async def get_export(self, export_id: str) -> ExportRecord:
-        return _parse_export_record((await self._request("GET", f"/v1/exports/{export_id}"))["data"])
+        response = await self._request("GET", f"/v1/exports/{export_id}")
+        return _parse_export_record(response["data"])
 
     async def download_export(self, export_id: str) -> str:
         response = await self._request(

{hookbridge-1.2.0 → hookbridge-1.3.0}/hookbridge/types.py

@@ -243,29 +243,6 @@ class Project:
     created_at: datetime
 
 
-@dataclass(frozen=True)
-class Personalization:
-    id: str
-    user_id: str
-    timezone: str
-    date_format: str
-    locale: str
-    created_at: datetime
-    updated_at: datetime
-
-
-@dataclass(frozen=True)
-class NotificationPreferences:
-    id: str
-    user_id: str
-    enabled_alert_types: list[str]
-    delivery_channels: list[str]
-    failure_rate_threshold: int
-    pending_backlog_threshold: int
-    created_at: datetime
-    updated_at: datetime
-
-
 @dataclass(frozen=True)
 class CheckoutSession:
     session_id: str

{hookbridge-1.2.0 → hookbridge-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hookbridge"
-version = "1.2.0"
+version = "1.3.0"
 description = "Official HookBridge SDK for Python"
 readme = "README.md"
 license = "MIT"

{hookbridge-1.2.0 → hookbridge-1.3.0}/tests/test_async_client.py

@@ -2,6 +2,9 @@
 Tests for the asynchronous HookBridge client.
 """
 
+import json
+from datetime import UTC, datetime
+
 import pytest
 from pytest_httpx import HTTPXMock
 
@@ -305,6 +308,42 @@ class TestAsyncEndpoints:
         assert result.id == endpoint_id
         assert result.rate_limit_rps == 10
 
+
+class TestAsyncExports:
+    """Tests for async export operations."""
+
+    @pytest.mark.skipif(LIVE_MODE, reason="Mock test only")
+    async def test_create_export_serializes_datetimes(
+        self, async_client: AsyncHookBridge, httpx_mock: HTTPXMock
+    ) -> None:
+        httpx_mock.add_response(
+            method="POST",
+            url=f"{async_client._base_url}/v1/exports",
+            json={
+                "data": {
+                    "id": "01935abc-def0-7123-4567-890abcdef077",
+                    "project_id": "proj_abc123",
+                    "status": "pending",
+                    "filter_start_time": "2025-12-01T00:00:00+00:00",
+                    "filter_end_time": "2025-12-06T23:59:59+00:00",
+                    "created_at": "2025-12-06T12:00:00Z",
+                },
+                "meta": {"request_id": "req-12345"},
+            },
+        )
+
+        start = datetime(2025, 12, 1, 0, 0, 0, tzinfo=UTC)
+        end = datetime(2025, 12, 6, 23, 59, 59, tzinfo=UTC)
+        await async_client.create_export(start_time=start, end_time=end, endpoint_id="ep_123")
+
+        request = httpx_mock.get_request()
+        assert request is not None
+        assert json.loads(request.content) == {
+            "start_time": "2025-12-01T00:00:00+00:00",
+            "end_time": "2025-12-06T23:59:59+00:00",
+            "endpoint_id": "ep_123",
+        }
+
     @pytest.mark.skipif(LIVE_MODE, reason="Mock test only")
     async def test_list_endpoints(
         self, async_client: AsyncHookBridge, httpx_mock: HTTPXMock

{hookbridge-1.2.0 → hookbridge-1.3.0}/tests/test_client_spec_parity.py

@@ -3,6 +3,7 @@ Spec parity tests for the synchronous HookBridge client.
 """
 
 import json
+from datetime import UTC, datetime
 
 import pytest
 from pytest_httpx import HTTPXMock
@@ -11,7 +12,6 @@ from hookbridge import HookBridge
 
 from .conftest import LIVE_MODE
 
-
 PROJECT_ID = "01935abc-def0-7123-4567-890abcdef012"
 INBOUND_ENDPOINT_ID = "01935abc-def0-7123-4567-890abcdef099"
 MESSAGE_ID = "01935abc-def0-7123-4567-890abcdef013"
@@ -236,71 +236,6 @@ class TestSigningKeyParity:
         client.delete_endpoint_signing_key(ENDPOINT_ID, SIGNING_KEY_ID)
 
 
-class TestSettingsParity:
-    @pytest.mark.skipif(LIVE_MODE, reason="Mock test only")
-    def test_personalization_settings(self, client: HookBridge, httpx_mock: HTTPXMock) -> None:
-        payload = {
-            "data": {
-                "id": "550e8400-e29b-41d4-a716-446655440000",
-                "user_id": "user_abc123",
-                "timezone": "America/New_York",
-                "date_format": "MM/DD/YYYY",
-                "locale": "en-US",
-                "created_at": "2025-12-01T10:00:00Z",
-                "updated_at": "2025-12-06T12:00:00Z",
-            },
-            "meta": {"request_id": "req-12345"},
-        }
-        httpx_mock.add_response(
-            method="GET",
-            url=f"{client._base_url}/v1/settings/personalization",
-            json=payload,
-        )
-        httpx_mock.add_response(
-            method="PUT",
-            url=f"{client._base_url}/v1/settings/personalization",
-            json=payload,
-        )
-
-        current = client.get_personalization()
-        updated = client.update_personalization(timezone="America/New_York")
-
-        assert current.locale == "en-US"
-        assert updated.timezone == "America/New_York"
-
-    @pytest.mark.skipif(LIVE_MODE, reason="Mock test only")
-    def test_notification_settings(self, client: HookBridge, httpx_mock: HTTPXMock) -> None:
-        payload = {
-            "data": {
-                "id": "550e8400-e29b-41d4-a716-446655440001",
-                "user_id": "user_abc123",
-                "enabled_alert_types": ["high_failure_rate"],
-                "delivery_channels": ["email"],
-                "failure_rate_threshold": 10,
-                "pending_backlog_threshold": 100,
-                "created_at": "2025-12-01T10:00:00Z",
-                "updated_at": "2025-12-06T12:00:00Z",
-            },
-            "meta": {"request_id": "req-12345"},
-        }
-        httpx_mock.add_response(
-            method="GET",
-            url=f"{client._base_url}/v1/settings/notifications",
-            json=payload,
-        )
-        httpx_mock.add_response(
-            method="PUT",
-            url=f"{client._base_url}/v1/settings/notifications",
-            json=payload,
-        )
-
-        current = client.get_notification_preferences()
-        updated = client.update_notification_preferences(delivery_channels=["email"])
-
-        assert current.enabled_alert_types == ["high_failure_rate"]
-        assert updated.pending_backlog_threshold == 100
-
-
 class TestBillingParity:
     @pytest.mark.skipif(LIVE_MODE, reason="Mock test only")
     def test_checkout_and_portal(self, client: HookBridge, httpx_mock: HTTPXMock) -> None:
@@ -700,3 +635,35 @@ class TestExportParity:
         assert listed[0].row_count == 5000
         assert fetched.status == "completed"
         assert download_url == "https://downloads.example.com/export.csv"
+
+    @pytest.mark.skipif(LIVE_MODE, reason="Mock test only")
+    def test_create_export_serializes_datetimes(
+        self, client: HookBridge, httpx_mock: HTTPXMock
+    ) -> None:
+        httpx_mock.add_response(
+            method="POST",
+            url=f"{client._base_url}/v1/exports",
+            json={
+                "data": {
+                    "id": EXPORT_ID,
+                    "project_id": "proj_abc123",
+                    "status": "pending",
+                    "filter_start_time": "2025-12-01T00:00:00+00:00",
+                    "filter_end_time": "2025-12-06T23:59:59+00:00",
+                    "created_at": "2025-12-06T12:00:00Z",
+                },
+                "meta": {"request_id": "req-12345"},
+            },
+        )
+
+        start = datetime(2025, 12, 1, 0, 0, 0, tzinfo=UTC)
+        end = datetime(2025, 12, 6, 23, 59, 59, tzinfo=UTC)
+        client.create_export(start_time=start, end_time=end, endpoint_id=ENDPOINT_ID)
+
+        request = httpx_mock.get_request()
+        assert request is not None
+        assert json.loads(request.content) == {
+            "start_time": "2025-12-01T00:00:00+00:00",
+            "end_time": "2025-12-06T23:59:59+00:00",
+            "endpoint_id": ENDPOINT_ID,
+        }

hookbridge-1.2.0/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(mypy hookbridge:*)"
-    ]
-  }
-}