webhook-platform 1.1.0__tar.gz → 2.0.0__tar.gz

{webhook_platform-1.1.0 → webhook_platform-2.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: webhook-platform
-Version: 1.1.0
-Summary: Official Python SDK for Webhook Platform
+Version: 2.0.0
+Summary: Official Python SDK for Hookflow — reliable webhook infrastructure
 Author-email: Vadym Kykalo <vadymkykalo@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/vadymkykalo/webhook-platform
@@ -29,7 +29,7 @@ Requires-Dist: types-requests>=2.28.0; extra == "dev"
 
 # webhook-platform
 
-Official Python SDK for [Webhook Platform](https://github.com/vadymkykalo/webhook-platform).
+Official Python SDK for [Hookflow](https://github.com/vadymkykalo/webhook-platform).
 
 ## Installation
 
@@ -40,9 +40,9 @@ pip install webhook-platform
 ## Quick Start
 
 ```python
-from webhook_platform import WebhookPlatform, Event
+from hookflow import Hookflow, Event
 
-client = WebhookPlatform(
+client = Hookflow(
     api_key="wh_live_your_api_key",
     base_url="http://localhost:8080",  # optional
 )
@@ -68,7 +68,7 @@ print(f"Deliveries created: {event.deliveries_created}")
 ### Events
 
 ```python
-from webhook_platform import Event
+from hookflow import Event
 
 # Send event with idempotency key
 event = client.events.send(
@@ -80,7 +80,7 @@ event = client.events.send(
 ### Endpoints
 
 ```python
-from webhook_platform import EndpointCreateParams, EndpointUpdateParams
+from hookflow import EndpointCreateParams, EndpointUpdateParams
 
 # Create endpoint
 endpoint = client.endpoints.create(
@@ -117,7 +117,7 @@ print(f"Test {'passed' if result.success else 'failed'}: {result.latency_ms}ms")
 ### Subscriptions
 
 ```python
-from webhook_platform import SubscriptionCreateParams
+from hookflow import SubscriptionCreateParams
 
 # Subscribe endpoint to an event type
 subscription = client.subscriptions.create(
@@ -146,7 +146,7 @@ client.subscriptions.delete(project_id, subscription_id)
 ### Deliveries
 
 ```python
-from webhook_platform import DeliveryListParams, DeliveryStatus
+from hookflow import DeliveryListParams, DeliveryStatus
 
 # List deliveries with filters
 deliveries = client.deliveries.list(
@@ -165,12 +165,96 @@ for attempt in attempts:
 client.deliveries.replay(delivery_id)
 ```
 
+## Incoming Webhooks
+
+Receive, validate, and forward webhooks from third-party providers (Stripe, GitHub, Twilio, etc.).
+
+### Incoming Sources
+
+```python
+from hookflow import IncomingSourceCreateParams, IncomingSourceUpdateParams
+
+# Create an incoming source with HMAC verification
+source = client.incoming_sources.create(
+    project_id,
+    IncomingSourceCreateParams(
+        name="Stripe Webhooks",
+        slug="stripe",
+        provider_type="STRIPE",
+        verification_mode="HMAC_GENERIC",
+        hmac_secret="whsec_...",
+        hmac_header_name="Stripe-Signature",
+    ),
+)
+
+print(f"Ingress URL: {source.ingress_url}")
+
+# List sources
+sources = client.incoming_sources.list(project_id)
+
+# Update source
+client.incoming_sources.update(
+    project_id,
+    source_id,
+    IncomingSourceUpdateParams(name="Stripe Production", rate_limit_per_second=100),
+)
+
+# Delete source
+client.incoming_sources.delete(project_id, source_id)
+```
+
+### Incoming Destinations
+
+```python
+from hookflow import IncomingDestinationCreateParams
+
+# Add a forwarding destination
+dest = client.incoming_sources.create_destination(
+    project_id,
+    source_id,
+    IncomingDestinationCreateParams(
+        url="https://your-api.com/webhooks/stripe",
+        enabled=True,
+        max_attempts=5,
+        timeout_seconds=30,
+    ),
+)
+
+# List destinations
+dests = client.incoming_sources.list_destinations(project_id, source_id)
+
+# Delete destination
+client.incoming_sources.delete_destination(project_id, source_id, dest_id)
+```
+
+### Incoming Events
+
+```python
+from hookflow import IncomingEventListParams
+
+# List incoming events (with optional source filter)
+events = client.incoming_events.list(
+    project_id,
+    IncomingEventListParams(source_id=source.id, page=0, size=20),
+)
+
+# Get event details
+event = client.incoming_events.get(project_id, event_id)
+
+# Get forward attempts
+attempts = client.incoming_events.get_attempts(project_id, event_id)
+
+# Replay event to all destinations
+result = client.incoming_events.replay(project_id, event_id)
+print(f"Replayed to {result.destinations_count} destinations")
+```
+
 ## Webhook Signature Verification
 
 Verify incoming webhooks in your endpoint:
 
 ```python
-from webhook_platform import verify_signature, construct_event, WebhookPlatformError
+from hookflow import verify_signature, construct_event, HookflowError
 
 # Flask example
 from flask import Flask, request
@@ -198,7 +282,7 @@ def handle_webhook():
 
         return "OK", 200
 
-    except WebhookPlatformError as e:
+    except HookflowError as e:
         print(f"Webhook verification failed: {e.message}")
         return "Invalid signature", 400
 ```
@@ -207,7 +291,7 @@ def handle_webhook():
 
 ```python
 from fastapi import FastAPI, Request, HTTPException
-from webhook_platform import construct_event, WebhookPlatformError
+from hookflow import construct_event, HookflowError
 
 app = FastAPI()
 
@@ -226,15 +310,15 @@ async def handle_webhook(request: Request):
         # Process event...
         return {"status": "ok"}
 
-    except WebhookPlatformError as e:
+    except HookflowError as e:
         raise HTTPException(status_code=400, detail=e.message)
 ```
 
 ## Error Handling
 
 ```python
-from webhook_platform import (
-    WebhookPlatformError,
+from hookflow import (
+    HookflowError,
     RateLimitError,
     AuthenticationError,
     ValidationError,
@@ -250,14 +334,14 @@ except AuthenticationError:
     print("Invalid API key")
 except ValidationError as e:
     print(f"Validation failed: {e.field_errors}")
-except WebhookPlatformError as e:
+except HookflowError as e:
     print(f"Error {e.status}: {e.message}")
 ```
 
 ## Configuration
 
 ```python
-client = WebhookPlatform(
+client = Hookflow(
     api_key="wh_live_xxx",          # Required: Your API key
     base_url="https://api.example.com",  # Optional: API base URL
     timeout=30,                     # Optional: Request timeout in seconds (default: 30)
@@ -269,7 +353,7 @@ client = WebhookPlatform(
 This SDK includes full type hints for better IDE support:
 
 ```python
-from webhook_platform import (
+from hookflow import (
     Event,
     EventResponse,
     Endpoint,

{webhook_platform-1.1.0 → webhook_platform-2.0.0}/README.md

@@ -1,6 +1,6 @@
 # webhook-platform
 
-Official Python SDK for [Webhook Platform](https://github.com/vadymkykalo/webhook-platform).
+Official Python SDK for [Hookflow](https://github.com/vadymkykalo/webhook-platform).
 
 ## Installation
 
@@ -11,9 +11,9 @@ pip install webhook-platform
 ## Quick Start
 
 ```python
-from webhook_platform import WebhookPlatform, Event
+from hookflow import Hookflow, Event
 
-client = WebhookPlatform(
+client = Hookflow(
     api_key="wh_live_your_api_key",
     base_url="http://localhost:8080",  # optional
 )
@@ -39,7 +39,7 @@ print(f"Deliveries created: {event.deliveries_created}")
 ### Events
 
 ```python
-from webhook_platform import Event
+from hookflow import Event
 
 # Send event with idempotency key
 event = client.events.send(
@@ -51,7 +51,7 @@ event = client.events.send(
 ### Endpoints
 
 ```python
-from webhook_platform import EndpointCreateParams, EndpointUpdateParams
+from hookflow import EndpointCreateParams, EndpointUpdateParams
 
 # Create endpoint
 endpoint = client.endpoints.create(
@@ -88,7 +88,7 @@ print(f"Test {'passed' if result.success else 'failed'}: {result.latency_ms}ms")
 ### Subscriptions
 
 ```python
-from webhook_platform import SubscriptionCreateParams
+from hookflow import SubscriptionCreateParams
 
 # Subscribe endpoint to an event type
 subscription = client.subscriptions.create(
@@ -117,7 +117,7 @@ client.subscriptions.delete(project_id, subscription_id)
 ### Deliveries
 
 ```python
-from webhook_platform import DeliveryListParams, DeliveryStatus
+from hookflow import DeliveryListParams, DeliveryStatus
 
 # List deliveries with filters
 deliveries = client.deliveries.list(
@@ -136,12 +136,96 @@ for attempt in attempts:
 client.deliveries.replay(delivery_id)
 ```
 
+## Incoming Webhooks
+
+Receive, validate, and forward webhooks from third-party providers (Stripe, GitHub, Twilio, etc.).
+
+### Incoming Sources
+
+```python
+from hookflow import IncomingSourceCreateParams, IncomingSourceUpdateParams
+
+# Create an incoming source with HMAC verification
+source = client.incoming_sources.create(
+    project_id,
+    IncomingSourceCreateParams(
+        name="Stripe Webhooks",
+        slug="stripe",
+        provider_type="STRIPE",
+        verification_mode="HMAC_GENERIC",
+        hmac_secret="whsec_...",
+        hmac_header_name="Stripe-Signature",
+    ),
+)
+
+print(f"Ingress URL: {source.ingress_url}")
+
+# List sources
+sources = client.incoming_sources.list(project_id)
+
+# Update source
+client.incoming_sources.update(
+    project_id,
+    source_id,
+    IncomingSourceUpdateParams(name="Stripe Production", rate_limit_per_second=100),
+)
+
+# Delete source
+client.incoming_sources.delete(project_id, source_id)
+```
+
+### Incoming Destinations
+
+```python
+from hookflow import IncomingDestinationCreateParams
+
+# Add a forwarding destination
+dest = client.incoming_sources.create_destination(
+    project_id,
+    source_id,
+    IncomingDestinationCreateParams(
+        url="https://your-api.com/webhooks/stripe",
+        enabled=True,
+        max_attempts=5,
+        timeout_seconds=30,
+    ),
+)
+
+# List destinations
+dests = client.incoming_sources.list_destinations(project_id, source_id)
+
+# Delete destination
+client.incoming_sources.delete_destination(project_id, source_id, dest_id)
+```
+
+### Incoming Events
+
+```python
+from hookflow import IncomingEventListParams
+
+# List incoming events (with optional source filter)
+events = client.incoming_events.list(
+    project_id,
+    IncomingEventListParams(source_id=source.id, page=0, size=20),
+)
+
+# Get event details
+event = client.incoming_events.get(project_id, event_id)
+
+# Get forward attempts
+attempts = client.incoming_events.get_attempts(project_id, event_id)
+
+# Replay event to all destinations
+result = client.incoming_events.replay(project_id, event_id)
+print(f"Replayed to {result.destinations_count} destinations")
+```
+
 ## Webhook Signature Verification
 
 Verify incoming webhooks in your endpoint:
 
 ```python
-from webhook_platform import verify_signature, construct_event, WebhookPlatformError
+from hookflow import verify_signature, construct_event, HookflowError
 
 # Flask example
 from flask import Flask, request
@@ -169,7 +253,7 @@ def handle_webhook():
 
         return "OK", 200
 
-    except WebhookPlatformError as e:
+    except HookflowError as e:
         print(f"Webhook verification failed: {e.message}")
         return "Invalid signature", 400
 ```
@@ -178,7 +262,7 @@ def handle_webhook():
 
 ```python
 from fastapi import FastAPI, Request, HTTPException
-from webhook_platform import construct_event, WebhookPlatformError
+from hookflow import construct_event, HookflowError
 
 app = FastAPI()
 
@@ -197,15 +281,15 @@ async def handle_webhook(request: Request):
         # Process event...
         return {"status": "ok"}
 
-    except WebhookPlatformError as e:
+    except HookflowError as e:
         raise HTTPException(status_code=400, detail=e.message)
 ```
 
 ## Error Handling
 
 ```python
-from webhook_platform import (
-    WebhookPlatformError,
+from hookflow import (
+    HookflowError,
     RateLimitError,
     AuthenticationError,
     ValidationError,
@@ -221,14 +305,14 @@ except AuthenticationError:
     print("Invalid API key")
 except ValidationError as e:
     print(f"Validation failed: {e.field_errors}")
-except WebhookPlatformError as e:
+except HookflowError as e:
     print(f"Error {e.status}: {e.message}")
 ```
 
 ## Configuration
 
 ```python
-client = WebhookPlatform(
+client = Hookflow(
     api_key="wh_live_xxx",          # Required: Your API key
     base_url="https://api.example.com",  # Optional: API base URL
     timeout=30,                     # Optional: Request timeout in seconds (default: 30)
@@ -240,7 +324,7 @@ client = WebhookPlatform(
 This SDK includes full type hints for better IDE support:
 
 ```python
-from webhook_platform import (
+from hookflow import (
     Event,
     EventResponse,
     Endpoint,

{webhook_platform-1.1.0/webhook_platform → webhook_platform-2.0.0/hookflow}/__init__.py

@@ -1,8 +1,8 @@
-"""Official Python SDK for Webhook Platform."""
+"""Official Python SDK for Hookflow."""
 
-from .client import WebhookPlatform
+from .client import Hookflow
 from .errors import (
-    WebhookPlatformError,
+    HookflowError,
     AuthenticationError,
     RateLimitError,
     ValidationError,
@@ -25,10 +25,26 @@ from .types import (
     EndpointTestResult,
     RateLimitInfo,
     WebhookEvent,
+    IncomingSource,
+    IncomingSourceCreateParams,
+    IncomingSourceUpdateParams,
+    IncomingDestination,
+    IncomingDestinationCreateParams,
+    IncomingEvent,
+    IncomingEventListParams,
+    IncomingForwardAttempt,
+    ReplayEventResponse,
 )
 
-__version__ = "1.1.0"
+__version__ = "2.0.0"
+
+# Backward-compatible aliases
+WebhookPlatform = Hookflow
+WebhookPlatformError = HookflowError
+
 __all__ = [
+    "Hookflow",
+    "HookflowError",
     "WebhookPlatform",
     "WebhookPlatformError",
     "AuthenticationError",
@@ -53,4 +69,13 @@ __all__ = [
     "EndpointTestResult",
     "RateLimitInfo",
     "WebhookEvent",
+    "IncomingSource",
+    "IncomingSourceCreateParams",
+    "IncomingSourceUpdateParams",
+    "IncomingDestination",
+    "IncomingDestinationCreateParams",
+    "IncomingEvent",
+    "IncomingEventListParams",
+    "IncomingForwardAttempt",
+    "ReplayEventResponse",
 ]