chore(release): v1.0.0-beta

Author: ghl-karan-kaneria

.gitignore

@@ -47,3 +47,4 @@ Thumbs.db
 # Temporary files
 *.tmp
 *.temp
+

CHANGELOG.md

@@ -0,0 +1,3 @@
+## [1.0.0-beta] - 2025-11-18
+
+- Initial beta release of HighLevel SDK for Python

README.md

@@ -1,6 +1,5 @@
 # GoHighLevel Python SDK
 
-
 Official Python SDK for the GoHighLevel API. This library provides a convenient way to interact with GoHighLevel's APIs from applications written in Python.
 
 ## Installation
@@ -17,7 +16,7 @@ pip install gohighlevel-api-client
 ```python
 from highlevel import HighLevel
 
-# Or initialize with OAuth credentials
+# Initialize with OAuth credentials
 client = HighLevel(
     client_id="your_client_id",
     client_secret="your_client_secret"
@@ -80,6 +79,42 @@ client = HighLevel(
 )
 ```
 
+## Webhook Integration
+
+The SDK provides comprehensive webhook support for handling GoHighLevel webhook events, including automatic token management and session storage integration.
+
+### Features
+
+- **Automatic Token Management**: Handles `INSTALL` and `UNINSTALL` webhooks automatically
+- **Token Storage**: Generates and stores access tokens on `INSTALL`, removes them on `UNINSTALL`
+- **Session Management**: Integrates with your chosen session storage (Memory/MongoDB)
+- **Auto Token Refresh**: Automatically refreshes expired tokens during API calls if tokens are stored
+
+### Webhook Handler Setup
+
+```python
+from highlevel import HighLevel
+from highlevel.storage import MemorySessionStorage
+
+# Initialize the SDK client with session storage
+client = HighLevel(
+    client_id="your_client_id",
+    client_secret="your_client_secret",
+    session_storage=MemorySessionStorage()
+)
+
+# Get the webhook middleware
+webhook_middleware = client.webhooks.subscribe()
+
+@app.route('/api/webhooks/ghl', methods=['POST'])
+async def handle_ghl_webhook():
+    """Handle incoming GoHighLevel webhooks"""
+    # Process the webhook using the middleware
+    await webhook_middleware(request)
+    # Add your custom webhook logic here
+    return jsonify({"status": "success"}), 200
+```
+
 ## Documentation
 
 - [Official API Documentation](http://marketplace.gohighlevel.com/docs/)

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gohighlevel-api-client"
-version = "1.0.0"
+version = "1.0.0-beta"
 description = "GoHighLevel Python SDK - Official API client for GoHighLevel platform"
 readme = "README.md"
 license = {text = "MIT"}
@@ -61,8 +61,8 @@ Repository = "https://github.com/GoHighLevel/gohighlevel-python-sdk"
 Changelog = "https://github.com/GoHighLevel/gohighlevel-python-sdk/blob/main/CHANGELOG.md"
 
 [tool.setuptools]
-packages = ["highlevel"]
 package-dir = {"" = "src"}
+include-package-data = true
 
 [tool.setuptools.package-data]
 highlevel = ["py.typed"]