Metadata-Version: 2.4
Name: console-vylth
Version: 0.1.0
Summary: VYLTH Console SDK — Entitlements & billing enforcement
Author-email: VYLTH <console@vylth.com>
License: MIT
Project-URL: Homepage, https://github.com/VYLTH/console
Keywords: console,vylth,entitlements,billing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.25.0
Provides-Extra: fastapi
Requires-Dist: fastapi>=0.100.0; extra == "fastapi"

# console-vylth

VYLTH Console SDK for Python — entitlements and billing enforcement for FastAPI services.

## Install

```bash
pip install console-vylth

# With FastAPI support
pip install "console-vylth[fastapi]"
```

## Usage

```python
from console_vylth import ConsoleClient

console = ConsoleClient()

# Fetch entitlements
ent = await console.get_entitlements(user_id, access_token)

# Check ecosystem access
if not ent.has_ecosystem("alpha"):
    raise HTTPException(status_code=403, detail="No access")

# Record usage (fire and forget)
await console.record_usage(user_id, product="alpha", strategy="sol-arb", call_count=1)
```

## FastAPI dependency

```python
from console_vylth import ConsoleClient

console = ConsoleClient()

@app.get("/strategies")
async def list_strategies(
    ent = Depends(console.fastapi_dependency(ecosystem="alpha"))
):
    ...
```
