solvapay-python 0.7.1__py3-none-any.whl → 0.7.2__py3-none-any.whl

solvapay/__init__.py

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

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.dist-info → solvapay_python-0.7.2.dist-info}/METADATA

@@ -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.dist-info → solvapay_python-0.7.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-solvapay/__init__.py,sha256=ga0mkJoi17QfBhG8_IuoBpNlweqSIGCFiTB7MT37_Do,1774
+solvapay/__init__.py,sha256=1GgHO6-iQViSW0vZGKghMV1NMHDtWEy-gM-SRr06Ch0,1774
 solvapay/_async_client.py,sha256=4RtP3K5NlkqOSfqDNS26Hzit4aUbh68HSvCDUVrmYoY,13509
 solvapay/_config.py,sha256=yPU_GM77pXwPfIzuncuLRNv4322q5bB9qaawN3izEB8,606
 solvapay/_http.py,sha256=ug396rug0EsKCgs_rgi8iYMkfm0hKOlQQ2sEjyUz22o,6709
@@ -9,11 +9,11 @@ solvapay/fastapi.py,sha256=vouWqbc_Yurdg8dIZ7zhO4-J_QxpYnyNgwyLHgDEoHs,2125
 solvapay/idempotency.py,sha256=LzsLw6TeaeLJbMVqZSEQ-038f6oIUomCmQDBqzlKMGE,514
 solvapay/langchain.py,sha256=VOrze5-7COE4--kn8JqbyrmwhWwv3XwN3Ol3YMpffgc,2353
 solvapay/models.py,sha256=SsmkSLH5xp-Hgf2GjhDcrqGt5FoWKtXJkDZUQE7wwWI,6810
-solvapay/paywall.py,sha256=jlMZ9LG6GNL010R8fV30cKQmSub3VRPW079Fm1wbsO8,5522
+solvapay/paywall.py,sha256=OQCX8XT73IWDaFyRHDz_19ZYOkXY891O_zDbpI73D7U,5771
 solvapay/paywall_state.py,sha256=pfP_-5B6LRcWrvItwgDwh-9f-DSowYaFDKXxGJvYPrg,7048
 solvapay/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 solvapay/webhooks.py,sha256=6EuoISjJzrKEUIoNpt__l2FnJvQR4T7XnT7fzOFHl5U,2738
-solvapay_python-0.7.1.dist-info/METADATA,sha256=yHcTAUI2DBKA8m9tjTuQoEwgtH3OSowAlCggLERRxxU,9194
-solvapay_python-0.7.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-solvapay_python-0.7.1.dist-info/licenses/LICENSE,sha256=wJURmEXLdSdApQdHG-RCwBoZVka1Oux8zNrLxGC30S8,1068
-solvapay_python-0.7.1.dist-info/RECORD,,
+solvapay_python-0.7.2.dist-info/METADATA,sha256=2Fbd-hzM9PsqJEEBiWXbYuIh6OWrq5CUlZieDfMueCg,12767
+solvapay_python-0.7.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+solvapay_python-0.7.2.dist-info/licenses/LICENSE,sha256=wJURmEXLdSdApQdHG-RCwBoZVka1Oux8zNrLxGC30S8,1068
+solvapay_python-0.7.2.dist-info/RECORD,,