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

layerv_qurl/__init__.py

@@ -31,7 +31,6 @@ from layerv_qurl.types import (
     AccessGrant,
     AccessPolicy,
     AccessToken,
-    AgentBootstrapOutput,
     AIAgentPolicy,
     APIKey,
     APIKeyListOutput,
@@ -57,7 +56,6 @@ from layerv_qurl.types import (
     InvoiceListOutput,
     ListOutput,
     MintOutput,
-    NHPServerPeerInfo,
     Portal,
     PortalSession,
     Quota,
@@ -108,7 +106,6 @@ __all__ = [
     "AccessCode",
     "AccessCodeListOutput",
     "AIAgentPolicy",
-    "AgentBootstrapOutput",
     "APIKey",
     "APIKeyListOutput",
     "BatchCreateItem",
@@ -130,7 +127,6 @@ __all__ = [
     "DomainVerifyOutput",
     "Invoice",
     "InvoiceListOutput",
-    "NHPServerPeerInfo",
     "Portal",
     "PortalSession",
     "QuotaPlan",

layerv_qurl/_utils.py

@@ -43,7 +43,6 @@ from layerv_qurl.types import (
     AccessGrant,
     AccessPolicy,
     AccessToken,
-    AgentBootstrapOutput,
     AIAgentPolicy,
     APIKey,
     APIKeyListOutput,
@@ -68,7 +67,6 @@ from layerv_qurl.types import (
     InvoiceListOutput,
     ListOutput,
     MintOutput,
-    NHPServerPeerInfo,
     Portal,
     PortalSession,
     Quota,
@@ -991,9 +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_tokens_per_qurl=data.get("max_tokens_per_qurl", 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"),
     )
 
 
@@ -1002,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"),
     )
 
 
@@ -1292,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"),
     )
 
 
@@ -1439,22 +1443,6 @@ def parse_connector_installation_list_output(
     )
 
 
-def parse_agent_bootstrap_output(data: dict[str, Any]) -> AgentBootstrapOutput:
-    """Parse connector agent bootstrap output."""
-    raw_peer = data.get("nhp_server_peer")
-    peer = raw_peer if isinstance(raw_peer, dict) else {}
-    return AgentBootstrapOutput(
-        agent_id=data.get("agent_id", ""),
-        registered_at=_parse_dt(data.get("registered_at")),
-        nhp_server_peer=NHPServerPeerInfo(
-            public_key_b64=peer.get("public_key_b64", ""),
-            host=peer.get("host", ""),
-            port=peer.get("port", 0),
-            expire_time=peer.get("expire_time", 0),
-        ),
-    )
-
-
 def _validate_batch_create_shape(data: Any) -> None:
     """Defense-in-depth structural check for batch_create responses.
 

layerv_qurl/async_client.py

@@ -35,7 +35,6 @@ from layerv_qurl._utils import (
     parse_access_code,
     parse_access_code_list_output,
     parse_access_token,
-    parse_agent_bootstrap_output,
     parse_api_key,
     parse_api_key_list_output,
     parse_batch_create_output,
@@ -101,7 +100,6 @@ if TYPE_CHECKING:
         AccessCodeListOutput,
         AccessPolicy,
         AccessToken,
-        AgentBootstrapOutput,
         APIKey,
         APIKeyListOutput,
         BatchCreateItem,
@@ -1516,33 +1514,6 @@ class AsyncQURLClient:
         )
         return parse_connector_installation_list_output(data, meta)
 
-    async def bootstrap_agent(
-        self,
-        *,
-        public_key: str,
-        agent_id: str | None = None,
-        hostname: str | None = None,
-        version: str | None = None,
-        idempotency_key: str | None = None,
-    ) -> AgentBootstrapOutput:
-        """Bootstrap a LayerV qURL Connector agent."""
-        validate_required_string(public_key, "public_key")
-        body = build_body(
-            {
-                "public_key": public_key,
-                "agent_id": agent_id,
-                "hostname": hostname,
-                "version": version,
-            }
-        )
-        resp = await self._request(
-            "POST",
-            "/v1/agent/bootstrap",
-            body=body,
-            headers=idempotency_headers(idempotency_key),
-        )
-        return parse_agent_bootstrap_output(resp)
-
     # --- Internal HTTP plumbing ---
 
     async def _request(

layerv_qurl/client.py

@@ -36,7 +36,6 @@ from layerv_qurl._utils import (
     parse_access_code,
     parse_access_code_list_output,
     parse_access_token,
-    parse_agent_bootstrap_output,
     parse_api_key,
     parse_api_key_list_output,
     parse_batch_create_output,
@@ -101,7 +100,6 @@ if TYPE_CHECKING:
         AccessCodeListOutput,
         AccessPolicy,
         AccessToken,
-        AgentBootstrapOutput,
         APIKey,
         APIKeyListOutput,
         BatchCreateItem,
@@ -1649,33 +1647,6 @@ class QURLClient:
         )
         return parse_connector_installation_list_output(data, meta)
 
-    def bootstrap_agent(
-        self,
-        *,
-        public_key: str,
-        agent_id: str | None = None,
-        hostname: str | None = None,
-        version: str | None = None,
-        idempotency_key: str | None = None,
-    ) -> AgentBootstrapOutput:
-        """Bootstrap a LayerV qURL Connector agent."""
-        validate_required_string(public_key, "public_key")
-        body = build_body(
-            {
-                "public_key": public_key,
-                "agent_id": agent_id,
-                "hostname": hostname,
-                "version": version,
-            }
-        )
-        resp = self._request(
-            "POST",
-            "/v1/agent/bootstrap",
-            body=body,
-            headers=idempotency_headers(idempotency_key),
-        )
-        return parse_agent_bootstrap_output(resp)
-
     # --- Internal HTTP plumbing ---
 
     def _request(

layerv_qurl/types.py

@@ -211,15 +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
-    max_tokens_per_qurl: 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
@@ -227,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
@@ -550,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
@@ -663,25 +675,6 @@ class ConnectorInstallationListOutput:
     has_more: bool = False
 
 
-@dataclass
-class NHPServerPeerInfo:
-    """NHP server peer info returned to connector agents."""
-
-    public_key_b64: str
-    host: str
-    port: int
-    expire_time: int
-
-
-@dataclass
-class AgentBootstrapOutput:
-    """Response from connector agent bootstrap."""
-
-    agent_id: str
-    registered_at: datetime | None
-    nhp_server_peer: NHPServerPeerInfo
-
-
 # ---- batch_create input shape -------------------------------------------
 # TypedDicts for :meth:`QURLClient.batch_create` items. Split into a
 # required-fields base class and an `total=False` subclass so callers on

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: qurl-python
-Version: 0.2.2
+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
@@ -25,6 +25,7 @@ Requires-Dist: langchain-core<2,>=0.3; extra == 'dev'
 Requires-Dist: mypy>=1.14; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.25; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: qurl-conformance<0.13,>=0.1.2; extra == 'dev'
 Requires-Dist: respx>=0.22; extra == 'dev'
 Requires-Dist: ruff>=0.11; extra == 'dev'
 Provides-Extra: langchain
@@ -331,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.4.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+layerv_qurl/__init__.py,sha256=1PMfphJ3oAJm0VygtRg3lH2uH0NP1ruzkpJeErJJZkk,3795
+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=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.2.2.dist-info → qurl_python-0.4.0.dist-info}/WHEEL

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

qurl_python-0.2.2.dist-info/RECORD

@@ -1,12 +0,0 @@
-layerv_qurl/__init__.py,sha256=nrIMkVysd1vLBj9p1TvFpz8JQFCA5al-lhCLyzIiiMk,3897
-layerv_qurl/_utils.py,sha256=OdZWAKOwewxzlSEeimgmv2r9o8feQWU-idwGziJg-bI,66046
-layerv_qurl/async_client.py,sha256=05wIEqQTPsTB8y8hYXXM0jP8EIrXb1pF4nEHcVp7Ntk,65599
-layerv_qurl/client.py,sha256=yvH-RlAx19LYCghEQpV0uam-DcF5lvloW3UKTUkQaRo,71466
-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=HhUFPS3TVxttXFyHGtUMvOPNLh7AZWQq6Uueq6o0pho,18490
-qurl_python-0.2.2.dist-info/METADATA,sha256=qDL7LzO0BFobOEWSrLnPMzKLGYZcgfm9XKgl0cC_o00,13161
-qurl_python-0.2.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-qurl_python-0.2.2.dist-info/licenses/LICENSE,sha256=cg6W6pLqMQFf89yPfz5ClnVSrNEeoTh3NOEQyH9CaZw,1069
-qurl_python-0.2.2.dist-info/RECORD,,