Metadata-Version: 2.4
Name: scroller-customer-interactions-db-client
Version: 0.2.0
Summary: Client for the scroller customer interactions database API.
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic>=2.11.7
Requires-Dist: python-dotenv>=1.1.1

# scroller-customer-image-interactions-db-client

Python client for authenticated customer interactions API access.

## Installation

```bash
pip install scroller-customer-image-interactions-db-client
```

## Environment variables

- `SCROLLER_CUSTOMER_INTERACTIONS_DB_BASE_URL` (default: `http://localhost:8400`)
- `SCROLLER_CUSTOMER_INTERACTIONS_DB_API_KEY` (falls back to `API_KEY`)

## Usage

```python
from scroller_customer_interactions_db_client import (
    CustomerImageInteractionCreate,
    CustomerImageInteractionsDBAPIClient,
)

client = CustomerImageInteractionsDBAPIClient()
rows = client.get_customer_image_interactions(customer_id=123, limit=100)
stack_rank_cards = client.get_stack_rank_images(customer_id=123)
created = client.create_customer_image_interaction(
    CustomerImageInteractionCreate(customer_id=123, image_id=456, action=1, view_duration_ms=900)
)
```
