qurl-python 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

layerv_qurl/_utils.py

@@ -989,8 +989,10 @@ def _parse_rate_limits(data: dict[str, Any] | None) -> RateLimits | None:
         create_per_hour=data.get("create_per_hour", 0),
         list_per_minute=data.get("list_per_minute", 0),
         resolve_per_minute=data.get("resolve_per_minute", 0),
-        max_active_qurls=data.get("max_active_qurls", 0),
+        max_active_qurls=data.get("max_active_qurls"),
         max_expiry_seconds=data.get("max_expiry_seconds", 0),
+        max_active_resources=data.get("max_active_resources"),
+        max_data_transfer_bytes=data.get("max_data_transfer_bytes"),
     )
 
 
@@ -999,11 +1001,14 @@ def _parse_usage_block(data: dict[str, Any] | None) -> Usage | None:
         return None
     return Usage(
         qurls_created=data.get("qurls_created", 0),
-        active_qurls=data.get("active_qurls", 0),
+        active_qurls=data.get("active_qurls"),
         # Nullable per the API spec — the field is null when
         # max_active_qurls is unlimited.
         active_qurls_percent=data.get("active_qurls_percent"),
         total_accesses=data.get("total_accesses", 0),
+        active_resources=data.get("active_resources"),
+        active_resources_percent=data.get("active_resources_percent"),
+        data_transfer_bytes=data.get("data_transfer_bytes"),
     )
 
 
@@ -1289,8 +1294,10 @@ def parse_current_period_usage(data: dict[str, Any]) -> CurrentPeriodUsage:
         period_start=_parse_dt(data.get("period_start")),
         period_end=_parse_dt(data.get("period_end")),
         qurls_created=data.get("qurls_created", 0),
-        active_qurls=data.get("active_qurls", 0),
+        active_qurls=data.get("active_qurls"),
         cost_estimate=_parse_usage_cost(data.get("cost_estimate")),
+        active_resources=data.get("active_resources"),
+        data_transfer_bytes=data.get("data_transfer_bytes"),
     )
 
 

layerv_qurl/types.py

@@ -211,14 +211,18 @@ class ListOutput:
 
 @dataclass
 class RateLimits:
-    """Rate limit configuration."""
+    """Rate limits and plan allowances."""
 
     create_per_minute: int = 0
     create_per_hour: int = 0
     list_per_minute: int = 0
     resolve_per_minute: int = 0
-    max_active_qurls: int = 0
+    # Deprecated alias for max_active_resources, not a qURL-count cap.
+    max_active_qurls: int | None = None
     max_expiry_seconds: int = 0
+    # Missing/null limits remain unknown; -1 is the unlimited sentinel.
+    max_active_resources: int | None = None
+    max_data_transfer_bytes: int | None = None
 
 
 @dataclass
@@ -226,10 +230,15 @@ class Usage:
     """Usage statistics."""
 
     qurls_created: int = 0
-    active_qurls: int = 0
+    # Deprecated alias for active_resources, not a count of qURLs.
+    active_qurls: int | None = None
     # Changed from float=0.0 — callers must None-check before arithmetic.
     active_qurls_percent: float | None = None
     total_accesses: int = 0
+    active_resources: int | None = None
+    active_resources_percent: float | None = None
+    # Measured bytes this UTC calendar month; None is distinct from zero.
+    data_transfer_bytes: int | None = None
 
 
 @dataclass
@@ -549,8 +558,12 @@ class CurrentPeriodUsage:
     period_start: datetime | None
     period_end: datetime | None
     qurls_created: int
-    active_qurls: int
+    # Deprecated alias for active_resources, not a count of qURLs.
+    active_qurls: int | None
     cost_estimate: UsageCostEstimate | None = None
+    active_resources: int | None = None
+    # Measured bytes this UTC calendar month, independent of the billing period.
+    data_transfer_bytes: int | None = None
 
 
 @dataclass

{qurl_python-0.3.0.dist-info → qurl_python-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qurl-python
-Version: 0.3.0
+Version: 0.4.0
 Summary: Python SDK for the qURL™ API — secure, time-limited access links. Quantum URL is how you enter the hidden layer of the internet.
 Project-URL: Homepage, https://github.com/layervai/qurl-python
 Project-URL: Repository, https://github.com/layervai/qurl-python
@@ -332,10 +332,31 @@ All error classes inherit from `QURLError`, so `except QURLError` catches everyt
 ```python
 quota = client.get_quota()
 print(f"Plan: {quota.plan}")
-print(f"Active qURLs: {quota.usage.active_qurls}")
-print(f"Rate limit: {quota.rate_limits.create_per_minute}/min")
+usage = quota.usage
+active = usage.active_resources if usage is not None else None
+if active is None and usage is not None:
+    active = usage.active_qurls
+print("Active protected resources:", active if active is not None else "unavailable")
+if quota.rate_limits is not None:
+    print(f"Rate limit: {quota.rate_limits.create_per_minute}/min")
 ```
 
+Use `max_active_resources`, `active_resources`, and `active_resources_percent`
+for resource quotas. `max_data_transfer_bytes` is the monthly byte allowance;
+`data_transfer_bytes` is measured usage, available on both quota usage and
+current-period responses. This usage always covers the current UTC calendar
+month, independently of a paid account's billing period. Missing or null values
+remain `None`, distinct from a reported zero. The [service OpenAPI spec](https://github.com/layervai/qurl-service/blob/01d7c47361b5f72f890428f1a53bd04e8d7f67cc/api/openapi.yaml#L5796)
+defines `-1` as unlimited for `max_active_resources` and its legacy alias
+`max_active_qurls`, as well as `max_data_transfer_bytes`.
+
+**Migration:** the deprecated `max_active_qurls` and `active_qurls` fields still
+represent protected resources. Missing values now return `None` instead of
+`0`; check `is not None` before arithmetic or displaying a count. Canonical
+and legacy fields preserve their own wire values, so an older response that
+omits canonical fields leaves those fields `None`. Prefer the canonical fields
+when available.
+
 JWT-authenticated dashboard endpoints are also available for usage, customer
 settings, billing sessions, invoices, and API-key management. API-key auth
 continues to work for normal qURL, resource, domain, webhook, connector, and

{qurl_python-0.3.0.dist-info → qurl_python-0.4.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 layerv_qurl/__init__.py,sha256=1PMfphJ3oAJm0VygtRg3lH2uH0NP1ruzkpJeErJJZkk,3795
-layerv_qurl/_utils.py,sha256=kuVqz6F64s9sclIreg2hd7OVZet6VytiYXgxnBtrPhY,65316
+layerv_qurl/_utils.py,sha256=UUhH4jsxv6KxDA_iSl3r-JETDl5Bqic0d2OOtM7gLkM,65742
 layerv_qurl/async_client.py,sha256=2ap4aPZ0FfThnqjA2-P5bkyWpTYYqXC0yyu2D09QRFs,64703
 layerv_qurl/client.py,sha256=w43jvXKUOyOS_Uta2ve7VfLz8VcM8ESMlwfO-QvFEFE,70582
 layerv_qurl/errors.py,sha256=7vyBEsJnN-e7804hil9KRwEgmUv5QW-DUGTf6FdSaV0,4932
 layerv_qurl/langchain.py,sha256=MJdow63lc6DXfL-riyu-rYC3cMiEKIOY9UZUvY4hEUQ,4695
 layerv_qurl/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-layerv_qurl/types.py,sha256=ynn6LLoZcX9cQ_erMl5bJv_h6YHdeA1KDUHMaAVNQuE,18099
-qurl_python-0.3.0.dist-info/METADATA,sha256=VHWfPZKV_qBzUkwzhP4xZQ5yZEHk5iG-2ayJh5gkGrM,13222
-qurl_python-0.3.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
-qurl_python-0.3.0.dist-info/licenses/LICENSE,sha256=cg6W6pLqMQFf89yPfz5ClnVSrNEeoTh3NOEQyH9CaZw,1069
-qurl_python-0.3.0.dist-info/RECORD,,
+layerv_qurl/types.py,sha256=Rb4Wu1ER_1U4pNES7A__TR_k7FPj3Y_6EmHOijGZC1w,18872
+qurl_python-0.4.0.dist-info/METADATA,sha256=dURx4UtZTHY3pdYLXEm96FlY3Ab7Ltyn2f9wqmhUkJg,14560
+qurl_python-0.4.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+qurl_python-0.4.0.dist-info/licenses/LICENSE,sha256=cg6W6pLqMQFf89yPfz5ClnVSrNEeoTh3NOEQyH9CaZw,1069
+qurl_python-0.4.0.dist-info/RECORD,,

{qurl_python-0.3.0.dist-info → qurl_python-0.4.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.32.0
+Generator: hatchling 1.32.4
 Root-Is-Purelib: true
 Tag: py3-none-any