solvapay-python 0.7.1__tar.gz → 0.7.2__tar.gz

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.7.2 — 2026-05-18
+
+Bug fixes and documentation update.
+
+### Fixed
+- **`paywall.require_async`**: `AsyncSolvaPay()` instantiated without a caller-supplied `client=` was not closed after the decorated function returned, leaking the underlying `httpx.AsyncClient` connection pool. Wrapped in `try/finally`; `await sv.aclose()` called when the decorator owns the client.
+- **`examples/fastmcp-paywall/pyproject.toml`**: dependency used wrong PyPI dist name (`solvapay`) and a stale `@v0.3.0` pin. Updated to `solvapay-python>=0.7.2`.
+- **`examples/langchain-paywall/pyproject.toml`**: same wrong dist name and stale `@v0.5.0` pin. Updated to `solvapay-python[langchain]>=0.7.2`.
+
+### Docs
+- **README** updated to v0.7.1 surface: `paywall_state.gate()`, error hierarchy, idempotency keys, admin ops table, marketplace example, roadmap entries for v0.7.0 and v0.7.1.
+
+### Internal
+- `tests/test_lifecycle.py` reformatted (ruff format compliance)
+
 ## 0.7.1 — 2026-05-17
 
 Payments-grade hardening: structured errors, idempotency keys, py.typed, structured logging.

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solvapay-python
-Version: 0.7.1
+Version: 0.7.2
 Summary: Community Python SDK for SolvaPay (agent-native payment rails)
 Project-URL: Homepage, https://github.com/dhruv-sanan/solvapay-python
 Project-URL: Issues, https://github.com/dhruv-sanan/solvapay-python/issues
@@ -35,12 +35,15 @@ Description-Content-Type: text/markdown
 
 Community Python SDK for [SolvaPay](https://solvapay.com) — payment rails for the agentic economy.
 
-> **Status:** v0.6, community-maintained. Available on PyPI. Pending official adoption.
+> **Status:** v0.7.2, community-maintained. Available on PyPI. Pending official adoption.
 > Mirrors the most-used surface of [@solvapay/core](https://github.com/solvapay/solvapay-sdk).
 
 Python is the dominant language for agent frameworks (LangChain, FastMCP, CrewAI, AutoGen). SolvaPay's official SDK is TypeScript-only. This SDK brings first-class Python support so agent developers can gate tools behind paywalls without switching ecosystems.
 
-> **New in v0.6:** Admin endpoints (products, plans, merchant, platform config). Published to PyPI.
+> **New in v0.7.2:** Async resource leak fix in `@paywall.require_async` — `AsyncSolvaPay` now properly closed when owned by the decorator. Example dep fixes.
+> **v0.7.1:** Full error hierarchy (`AuthenticationError`, `NotFoundError`, `RateLimitError`, `APIConnectionError`, `APITimeoutError`), idempotency keys on all mutating ops, `py.typed` PEP 561 marker, structured HTTP logging.
+> **New in v0.7.0:** Real-API alignment (wire-format fixes), `paywall_state.gate()` enrichment helper, marketplace Streamlit demo.
+> **v0.6:** Admin endpoints (products, plans, merchant, platform config). Published to PyPI.
 > **v0.5:** Paywall state classifier (`paywall_state` module) and LangChain `monetize_tool` decorator — gate any LangChain tool behind a SolvaPay paywall with one line.
 > **v0.4:** Async client (`AsyncSolvaPay`), lifecycle ops, typed webhook events.
 
@@ -150,12 +153,69 @@ if not limits.within_limits:
     print(d.checkout_url)   # "https://solvapay.com/c/..."
 ```
 
+For real-API calls use `gate()` instead — it enriches the bare `/v1/sdk/limits` response (which has no `plan` or `checkout_url`) in one call:
+
+```python
+from solvapay.paywall_state import gate
+
+decision = gate(sv, customer_ref="cus_x", product_ref="prd_y")
+# decision.state        — PaywallState.UPGRADE_REQUIRED (etc)
+# decision.checkout_url — minted via create_checkout_session if needed
+# decision.message      — TS-style copy with URL inlined
+```
+
+## Error handling
+
+v0.7.1 ships a structured exception hierarchy under `SolvaPayError`:
+
+```python
+import time
+from solvapay import (
+    SolvaPayError,        # catch-all
+    APIError,             # base for all HTTP errors — has .status_code, .request_id
+    AuthenticationError,  # 401
+    NotFoundError,        # 404
+    RateLimitError,       # 429 — adds .retry_after
+    APIConnectionError,   # network failure
+    APITimeoutError,      # request timeout
+)
+
+try:
+    sv.get_customer("cus_missing")
+except NotFoundError as e:
+    print(e.status_code, e.request_id)
+except RateLimitError as e:
+    time.sleep(float(e.retry_after or 1))
+except SolvaPayError:
+    raise
+```
+
+Use `except SolvaPayError` as the catch-all. Prefer specific subclasses over checking `.status_code`.
+
+## Idempotency keys
+
+All mutating ops accept an optional `idempotency_key` to make retries safe:
+
+```python
+from solvapay.idempotency import from_payload
+
+key = from_payload("checkout", customer_ref, product_ref)
+session = sv.create_checkout_session(
+    customer_ref=customer_ref,
+    product_ref="prd_xyz",
+    idempotency_key=key,
+)
+```
+
+`from_payload(*parts)` hashes its args to a 32-hex-char deterministic key. Pass the same key on retry — SolvaPay deduplicates server-side.
+
 ## Examples
 
 | Path | What it shows |
 |---|---|
 | [`examples/fastmcp-paywall/`](examples/fastmcp-paywall/) | FastMCP server with two paywalled tools. Demo for `@paywall.require` + MCP. |
 | [`examples/langchain-paywall/`](examples/langchain-paywall/) | LangChain agent with `monetize_tool`. Shows paywall response in agent trace. |
+| [`examples/marketplace/`](examples/marketplace/) | Streamlit demo — paywalled AI-agent marketplace. Real sandbox, real Gemini LLM, two demo customers (one subscribed, one free tier). Shows `paywall_state.gate()` in action. |
 
 ## TS ↔ Python parity
 
@@ -199,6 +259,22 @@ session = sv.create_checkout_session(
 | `cancel_purchase` | `POST /v1/sdk/purchases/{ref}/cancel` | Cancel a subscription |
 | `reactivate_purchase` | `POST /v1/sdk/purchases/{ref}/reactivate` | Reactivate cancelled purchase |
 
+**Admin (new in v0.6):**
+
+| Python | Verb + path | Description |
+|---|---|---|
+| `list_products` | `GET /v1/sdk/products` | List all products |
+| `get_product` | `GET /v1/sdk/products/{ref}` | Fetch product |
+| `create_product` | `POST /v1/sdk/products` | Create product |
+| `delete_product` | `DELETE /v1/sdk/products/{ref}` | Delete product |
+| `clone_product` | `POST /v1/sdk/products/{ref}/clone` | Clone product |
+| `list_plans` | `GET /v1/sdk/products/{ref}/plans` | List plans |
+| `create_plan` | `POST /v1/sdk/products/{ref}/plans` | Create plan |
+| `update_plan` | `PUT /v1/sdk/products/{ref}/plans/{ref}` | Update plan |
+| `delete_plan` | `DELETE /v1/sdk/products/{ref}/plans/{ref}` | Delete plan |
+| `get_merchant` | `GET /v1/sdk/merchant` | Merchant info |
+| `get_platform_config` | `GET /v1/sdk/platform-config` | Platform config |
+
 All methods available on both `SolvaPay` (sync) and `AsyncSolvaPay` (async).
 
 ## Webhook handler (FastAPI)
@@ -261,6 +337,9 @@ async def handle_webhook(request: Request) -> dict:
 - v0.4 — async client (`AsyncSolvaPay`), lifecycle ops, typed webhook events ✅
 - v0.5 — paywall state classifier, LangChain `monetize_tool` decorator ✅
 - v0.6 — admin endpoints (products, plans, merchant, platform config), PyPI publish ✅
+- v0.7.0 — real-API wire-format fixes, `paywall_state.gate()`, marketplace demo ✅
+- v0.7.1 — structured error hierarchy, idempotency keys, `py.typed`, structured logging ✅
+- v0.7.2 — async resource leak fix (`require_async`), example dep fixes ✅
 
 ## Contributing
 

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/README.md

@@ -4,12 +4,15 @@
 
 Community Python SDK for [SolvaPay](https://solvapay.com) — payment rails for the agentic economy.
 
-> **Status:** v0.6, community-maintained. Available on PyPI. Pending official adoption.
+> **Status:** v0.7.2, community-maintained. Available on PyPI. Pending official adoption.
 > Mirrors the most-used surface of [@solvapay/core](https://github.com/solvapay/solvapay-sdk).
 
 Python is the dominant language for agent frameworks (LangChain, FastMCP, CrewAI, AutoGen). SolvaPay's official SDK is TypeScript-only. This SDK brings first-class Python support so agent developers can gate tools behind paywalls without switching ecosystems.
 
-> **New in v0.6:** Admin endpoints (products, plans, merchant, platform config). Published to PyPI.
+> **New in v0.7.2:** Async resource leak fix in `@paywall.require_async` — `AsyncSolvaPay` now properly closed when owned by the decorator. Example dep fixes.
+> **v0.7.1:** Full error hierarchy (`AuthenticationError`, `NotFoundError`, `RateLimitError`, `APIConnectionError`, `APITimeoutError`), idempotency keys on all mutating ops, `py.typed` PEP 561 marker, structured HTTP logging.
+> **New in v0.7.0:** Real-API alignment (wire-format fixes), `paywall_state.gate()` enrichment helper, marketplace Streamlit demo.
+> **v0.6:** Admin endpoints (products, plans, merchant, platform config). Published to PyPI.
 > **v0.5:** Paywall state classifier (`paywall_state` module) and LangChain `monetize_tool` decorator — gate any LangChain tool behind a SolvaPay paywall with one line.
 > **v0.4:** Async client (`AsyncSolvaPay`), lifecycle ops, typed webhook events.
 
@@ -119,12 +122,69 @@ if not limits.within_limits:
     print(d.checkout_url)   # "https://solvapay.com/c/..."
 ```
 
+For real-API calls use `gate()` instead — it enriches the bare `/v1/sdk/limits` response (which has no `plan` or `checkout_url`) in one call:
+
+```python
+from solvapay.paywall_state import gate
+
+decision = gate(sv, customer_ref="cus_x", product_ref="prd_y")
+# decision.state        — PaywallState.UPGRADE_REQUIRED (etc)
+# decision.checkout_url — minted via create_checkout_session if needed
+# decision.message      — TS-style copy with URL inlined
+```
+
+## Error handling
+
+v0.7.1 ships a structured exception hierarchy under `SolvaPayError`:
+
+```python
+import time
+from solvapay import (
+    SolvaPayError,        # catch-all
+    APIError,             # base for all HTTP errors — has .status_code, .request_id
+    AuthenticationError,  # 401
+    NotFoundError,        # 404
+    RateLimitError,       # 429 — adds .retry_after
+    APIConnectionError,   # network failure
+    APITimeoutError,      # request timeout
+)
+
+try:
+    sv.get_customer("cus_missing")
+except NotFoundError as e:
+    print(e.status_code, e.request_id)
+except RateLimitError as e:
+    time.sleep(float(e.retry_after or 1))
+except SolvaPayError:
+    raise
+```
+
+Use `except SolvaPayError` as the catch-all. Prefer specific subclasses over checking `.status_code`.
+
+## Idempotency keys
+
+All mutating ops accept an optional `idempotency_key` to make retries safe:
+
+```python
+from solvapay.idempotency import from_payload
+
+key = from_payload("checkout", customer_ref, product_ref)
+session = sv.create_checkout_session(
+    customer_ref=customer_ref,
+    product_ref="prd_xyz",
+    idempotency_key=key,
+)
+```
+
+`from_payload(*parts)` hashes its args to a 32-hex-char deterministic key. Pass the same key on retry — SolvaPay deduplicates server-side.
+
 ## Examples
 
 | Path | What it shows |
 |---|---|
 | [`examples/fastmcp-paywall/`](examples/fastmcp-paywall/) | FastMCP server with two paywalled tools. Demo for `@paywall.require` + MCP. |
 | [`examples/langchain-paywall/`](examples/langchain-paywall/) | LangChain agent with `monetize_tool`. Shows paywall response in agent trace. |
+| [`examples/marketplace/`](examples/marketplace/) | Streamlit demo — paywalled AI-agent marketplace. Real sandbox, real Gemini LLM, two demo customers (one subscribed, one free tier). Shows `paywall_state.gate()` in action. |
 
 ## TS ↔ Python parity
 
@@ -168,6 +228,22 @@ session = sv.create_checkout_session(
 | `cancel_purchase` | `POST /v1/sdk/purchases/{ref}/cancel` | Cancel a subscription |
 | `reactivate_purchase` | `POST /v1/sdk/purchases/{ref}/reactivate` | Reactivate cancelled purchase |
 
+**Admin (new in v0.6):**
+
+| Python | Verb + path | Description |
+|---|---|---|
+| `list_products` | `GET /v1/sdk/products` | List all products |
+| `get_product` | `GET /v1/sdk/products/{ref}` | Fetch product |
+| `create_product` | `POST /v1/sdk/products` | Create product |
+| `delete_product` | `DELETE /v1/sdk/products/{ref}` | Delete product |
+| `clone_product` | `POST /v1/sdk/products/{ref}/clone` | Clone product |
+| `list_plans` | `GET /v1/sdk/products/{ref}/plans` | List plans |
+| `create_plan` | `POST /v1/sdk/products/{ref}/plans` | Create plan |
+| `update_plan` | `PUT /v1/sdk/products/{ref}/plans/{ref}` | Update plan |
+| `delete_plan` | `DELETE /v1/sdk/products/{ref}/plans/{ref}` | Delete plan |
+| `get_merchant` | `GET /v1/sdk/merchant` | Merchant info |
+| `get_platform_config` | `GET /v1/sdk/platform-config` | Platform config |
+
 All methods available on both `SolvaPay` (sync) and `AsyncSolvaPay` (async).
 
 ## Webhook handler (FastAPI)
@@ -230,6 +306,9 @@ async def handle_webhook(request: Request) -> dict:
 - v0.4 — async client (`AsyncSolvaPay`), lifecycle ops, typed webhook events ✅
 - v0.5 — paywall state classifier, LangChain `monetize_tool` decorator ✅
 - v0.6 — admin endpoints (products, plans, merchant, platform config), PyPI publish ✅
+- v0.7.0 — real-API wire-format fixes, `paywall_state.gate()`, marketplace demo ✅
+- v0.7.1 — structured error hierarchy, idempotency keys, `py.typed`, structured logging ✅
+- v0.7.2 — async resource leak fix (`require_async`), example dep fixes ✅
 
 ## Contributing
 

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/examples/fastmcp-paywall/pyproject.toml

@@ -4,7 +4,7 @@ version = "0.1.0"
 description = "FastMCP server gated by SolvaPay paywall — demo for solvapay-python"
 requires-python = ">=3.10"
 dependencies = [
-    "solvapay @ git+https://github.com/dhruv-sanan/solvapay-python@v0.3.0",
+    "solvapay-python>=0.7.1",
     "fastmcp>=0.4",
     "httpx>=0.27",
     "python-dotenv>=1.0",

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/examples/langchain-paywall/pyproject.toml

@@ -3,7 +3,7 @@ name = "langchain-paywall-example"
 version = "0.1.0"
 requires-python = ">=3.10"
 dependencies = [
-    "solvapay[langchain] @ git+https://github.com/dhruv-sanan/solvapay-python@v0.5.0",
+    "solvapay-python[langchain]>=0.7.1",
     "langchain>=0.3",
     "langchain-openai>=0.2",
     "python-dotenv>=1.0",

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "solvapay-python"
-version = "0.7.1"
+version = "0.7.2"
 description = "Community Python SDK for SolvaPay (agent-native payment rails)"
 readme = "README.md"
 license = { text = "MIT" }

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/src/solvapay/__init__.py

@@ -75,4 +75,4 @@ __all__ = [
     "paywall",
     "verify_webhook",
 ]
-__version__ = "0.7.1"
+__version__ = "0.7.2"

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/src/solvapay/paywall.py

@@ -124,24 +124,29 @@ def require_async(
                     f"@paywall.require_async expected str kwarg '{customer_ref_arg}', "
                     f"got {type(customer_ref).__name__}"
                 )
-            sv: AsyncSolvaPay = client if isinstance(client, AsyncSolvaPay) else AsyncSolvaPay()
-            limits = await sv.check_limits(
-                customer_ref=customer_ref,
-                product_ref=product,
-                plan_ref=plan,
-            )
-            if not limits.within_limits:
-                checkout_url = limits.checkout_url
-                if checkout_url is None:
-                    try:
-                        session = await sv.create_checkout_session(
-                            customer_ref=customer_ref, product_ref=product, plan_ref=plan
-                        )
-                        checkout_url = session.checkout_url
-                    except SolvaPayError:
-                        pass
-                raise PaywallRequired(checkout_url=checkout_url)
-            return await fn(*args, **kwargs)
+            _owns_client = not isinstance(client, AsyncSolvaPay)
+            sv: AsyncSolvaPay = AsyncSolvaPay() if _owns_client else client  # type: ignore[assignment]
+            try:
+                limits = await sv.check_limits(
+                    customer_ref=customer_ref,
+                    product_ref=product,
+                    plan_ref=plan,
+                )
+                if not limits.within_limits:
+                    checkout_url = limits.checkout_url
+                    if checkout_url is None:
+                        try:
+                            session = await sv.create_checkout_session(
+                                customer_ref=customer_ref, product_ref=product, plan_ref=plan
+                            )
+                            checkout_url = session.checkout_url
+                        except SolvaPayError:
+                            pass
+                    raise PaywallRequired(checkout_url=checkout_url)
+                return await fn(*args, **kwargs)
+            finally:
+                if _owns_client:
+                    await sv.aclose()
 
         return wrapper
 

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/tests/test_lifecycle.py

@@ -109,7 +109,9 @@ def test_get_customer_balance_returns_balance(client: SolvaPay) -> None:
     assert balance.customer_ref == "cus_1"
     assert balance.credits == 4250
     assert balance.credits_per_minor_unit == 100
-    assert balance.balance == 0.425  # derived: credits / credits_per_minor_unit / 100 (minor→major unit)
+    assert (
+        balance.balance == 0.425
+    )  # derived: credits / credits_per_minor_unit / 100 (minor→major unit)
     assert balance.currency == "USD"
 
 

{solvapay_python-0.7.1 → solvapay_python-0.7.2}/uv.lock

@@ -1046,7 +1046,7 @@ wheels = [
 
 [[package]]
 name = "solvapay-python"
-version = "0.7.1"
+version = "0.7.2"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },