driftstack-sdk 0.1.3__tar.gz → 0.1.5__tar.gz

{driftstack_sdk-0.1.3 → driftstack_sdk-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: driftstack-sdk
-Version: 0.1.3
+Version: 0.1.5
 Summary: Driftstack Python SDK — stealth iPhone Safari automation. Import as `driftstack`.
 Project-URL: Homepage, https://driftstack.dev
 Project-URL: Repository, https://github.com/driftstackdev/driftstack-api

{driftstack_sdk-0.1.3 → driftstack_sdk-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "driftstack-sdk"
-version = "0.1.3"
+version = "0.1.5"
 description = "Driftstack Python SDK — stealth iPhone Safari automation. Import as `driftstack`."
 readme = "README.md"
 requires-python = ">=3.10"

{driftstack_sdk-0.1.3 → driftstack_sdk-0.1.5}/src/driftstack/__init__.py

@@ -29,8 +29,10 @@ from driftstack.errors import (
     QuotaExceededError,
     RateLimitError,
     RevokedKeyError,
+    LegalAcceptanceRequiredError,
     SessionDestroyedError,
     SessionNotFoundError,
+    SessionTimeoutError,
     TransportError,
     ValidationError,
 )
@@ -53,6 +55,8 @@ __all__ = [
     "ConcurrencyLimitError",
     "SessionNotFoundError",
     "SessionDestroyedError",
+    "SessionTimeoutError",
+    "LegalAcceptanceRequiredError",
     "DriverError",
     "ValidationError",
     "TransportError",

{driftstack_sdk-0.1.3 → driftstack_sdk-0.1.5}/src/driftstack/_generated/models.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.json
-#   timestamp: 2026-05-03T10:05:29+00:00
+#   timestamp: 2026-05-03T12:11:01+00:00
 
 from __future__ import annotations
 

{driftstack_sdk-0.1.3 → driftstack_sdk-0.1.5}/src/driftstack/_version.py

@@ -7,4 +7,4 @@ needed — useful for tools that scrape the version without installing.
 
 from __future__ import annotations
 
-__version__ = "0.1.3"
+__version__ = "0.1.5"

{driftstack_sdk-0.1.3 → driftstack_sdk-0.1.5}/src/driftstack/errors.py

@@ -94,6 +94,50 @@ class SessionDestroyedError(DriftstackError):
     """The session was destroyed; further operations on it are rejected (410)."""
 
 
+class LegalAcceptanceRequiredError(DriftstackError):
+    """409 when an operation (e.g. creating an API key) is gated on the
+    customer accepting one or more legal documents.
+
+    ``pending_acceptances`` carries the document keys + current versions
+    so the client can drive the user through the acceptance flow without
+    a follow-up GET.
+    """
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        pending_acceptances: list[dict[str, str]] | None = None,
+        status: int | None = 409,
+        problem_type: str | None = None,
+        problem: dict[str, Any] | None = None,
+    ) -> None:
+        super().__init__(message, status=status, problem_type=problem_type, problem=problem)
+        self.pending_acceptances = pending_acceptances or []
+
+
+class SessionTimeoutError(DriftstackError):
+    """The operation exceeded the per-call ``timeout_ms`` (504).
+
+    Distinguished from ``DriverError`` so customers can react specifically
+    to "didn't finish in time" without conflating with downstream driver
+    failures. ``timeout_ms`` is the bound the server actually applied
+    (may differ from the request if the server clamped it).
+    """
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        timeout_ms: int | None = None,
+        status: int | None = 504,
+        problem_type: str | None = None,
+        problem: dict[str, Any] | None = None,
+    ) -> None:
+        super().__init__(message, status=status, problem_type=problem_type, problem=problem)
+        self.timeout_ms = timeout_ms
+
+
 # ── Rate / quota (429) ────────────────────────────────────────────────────
 
 
@@ -188,6 +232,8 @@ PROBLEM_TYPE_TO_ERROR: dict[str, type[DriftstackError]] = {
     "https://errors.driftstack.dev/expired-key": ExpiredKeyError,
     "https://errors.driftstack.dev/invalid-key": InvalidKeyError,
     "https://errors.driftstack.dev/session-destroyed": SessionDestroyedError,
+    "https://errors.driftstack.dev/session-timeout": SessionTimeoutError,
+    "https://errors.driftstack.dev/legal-acceptance-required": LegalAcceptanceRequiredError,
     "https://errors.driftstack.dev/driver-error": DriverError,
     "https://errors.driftstack.dev/driver-not-integrated": DriverError,
     "https://errors.driftstack.dev/validation-failed": ValidationError,

{driftstack_sdk-0.1.3 → driftstack_sdk-0.1.5}/src/driftstack/http.py

@@ -25,6 +25,8 @@ from driftstack._version import __version__
 from driftstack.errors import (
     PROBLEM_TYPE_TO_ERROR,
     ConcurrencyLimitError,
+    LegalAcceptanceRequiredError,
+    SessionTimeoutError,
     DriftstackError,
     QuotaExceededError,
     RateLimitError,
@@ -126,6 +128,37 @@ def _error_from_response_data(
             problem_type=problem_type,
             problem=problem,
         )
+    if error_cls is SessionTimeoutError:
+        return SessionTimeoutError(
+            detail,
+            timeout_ms=_int_or_none(problem.get("timeout_ms")),
+            status=status,
+            problem_type=problem_type,
+            problem=problem,
+        )
+    if error_cls is LegalAcceptanceRequiredError:
+        raw = problem.get("pending_acceptances")
+        pending: list[dict[str, str]] = []
+        if isinstance(raw, list):
+            for entry in raw:
+                if (
+                    isinstance(entry, dict)
+                    and isinstance(entry.get("document_key"), str)
+                    and isinstance(entry.get("current_version"), str)
+                ):
+                    pending.append(
+                        {
+                            "document_key": entry["document_key"],
+                            "current_version": entry["current_version"],
+                        }
+                    )
+        return LegalAcceptanceRequiredError(
+            detail,
+            pending_acceptances=pending,
+            status=status,
+            problem_type=problem_type,
+            problem=problem,
+        )
     return error_cls(detail, status=status, problem_type=problem_type, problem=problem)