hubble-sdk-python 0.0.3__tar.gz → 0.1.0__tar.gz

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.1.0](https://github.com/hubble-dot-ai/hubble-sdks/compare/hubble-sdk-python-v0.0.3...hubble-sdk-python-v0.1.0) (2026-09-02)
+
+
+### ⚠ BREAKING CHANGES
+
+* `Consent.granted_at` is removed. Callers reading it must derive authorization time another way (e.g. status transitions).
+
+### Features
+
+* add attach_authorization for BYO HIPAA authorization ([#41](https://github.com/hubble-dot-ai/hubble-sdks/issues/41)) ([66baf11](https://github.com/hubble-dot-ai/hubble-sdks/commit/66baf1192291b31cb03e325be44f1e6c5e4371f3))
+* drop granted_at from Consent ([#44](https://github.com/hubble-dot-ai/hubble-sdks/issues/44)) ([cb61be8](https://github.com/hubble-dot-ai/hubble-sdks/commit/cb61be8dc6e8c4784e30332cb4e31317f773ec3b))
+* support represented organizations in SDK links ([#45](https://github.com/hubble-dot-ai/hubble-sdks/issues/45)) ([430a1d0](https://github.com/hubble-dot-ai/hubble-sdks/commit/430a1d022f75ea645d27b0b7ebf87b910f1c51a9))
+
 ## [0.0.3](https://github.com/hubble-dot-ai/hubble-sdks/compare/hubble-sdk-python-v0.0.2...hubble-sdk-python-v0.0.3) (2026-08-23)
 
 

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: hubble-sdk-python
-Version: 0.0.3
+Version: 0.1.0
 Summary: Python client for the Hubble Patient Access API.
 Project-URL: Homepage, https://github.com/hubble-dot-ai/hubble-sdks
 Project-URL: Repository, https://github.com/hubble-dot-ai/hubble-sdks
@@ -45,8 +45,9 @@ from hubble_sdk import Hubble
 hub = Hubble(client_id="hbl_client_prod_...", client_secret="hbl_prod_...")
 
 # 1. Create a patient link and send the patient to it. Optionally prefill with
-#    patient={"first_name": ...} demographics and providers=[{"name": ...}].
-link = hub.create_link(patient_ref="abc123")
+#    patient={"first_name": ...} demographics, providers=[{"name": ...}], and
+#    the optional organization your verified Hubble organization represents.
+link = hub.create_link(patient_ref="abc123", on_behalf_of_organization_name="Acme Health")
 print(link.verification_uri_complete)
 
 # 2. Wait for the patient to authorize (polls the token endpoint for you).

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/README.md

@@ -13,8 +13,9 @@ from hubble_sdk import Hubble
 hub = Hubble(client_id="hbl_client_prod_...", client_secret="hbl_prod_...")
 
 # 1. Create a patient link and send the patient to it. Optionally prefill with
-#    patient={"first_name": ...} demographics and providers=[{"name": ...}].
-link = hub.create_link(patient_ref="abc123")
+#    patient={"first_name": ...} demographics, providers=[{"name": ...}], and
+#    the optional organization your verified Hubble organization represents.
+link = hub.create_link(patient_ref="abc123", on_behalf_of_organization_name="Acme Health")
 print(link.verification_uri_complete)
 
 # 2. Wait for the patient to authorize (polls the token endpoint for you).

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/api/default/attach_client_authorization.py

@@ -8,9 +8,7 @@ from ... import errors
 from ...client import AuthenticatedClient, Client
 from ...models.api_error import ApiError
 from ...models.attach_client_authorization_body import AttachClientAuthorizationBody
-from ...models.attach_client_authorization_response_201 import (
-    AttachClientAuthorizationResponse201,
-)
+from ...models.consent import Consent
 from ...types import Response
 
 
@@ -38,11 +36,11 @@ def _get_kwargs(
 
 def _parse_response(
     *, client: AuthenticatedClient | Client, response: httpx.Response
-) -> ApiError | AttachClientAuthorizationResponse201 | None:
-    if response.status_code == 201:
-        response_201 = AttachClientAuthorizationResponse201.from_dict(response.json())
+) -> ApiError | Consent | None:
+    if response.status_code == 200:
+        response_200 = Consent.from_dict(response.json())
 
-        return response_201
+        return response_200
 
     if response.status_code == 400:
         response_400 = ApiError.from_dict(response.json())
@@ -64,6 +62,11 @@ def _parse_response(
 
         return response_404
 
+    if response.status_code == 409:
+        response_409 = ApiError.from_dict(response.json())
+
+        return response_409
+
     if response.status_code == 413:
         response_413 = ApiError.from_dict(response.json())
 
@@ -77,7 +80,7 @@ def _parse_response(
 
 def _build_response(
     *, client: AuthenticatedClient | Client, response: httpx.Response
-) -> Response[ApiError | AttachClientAuthorizationResponse201]:
+) -> Response[ApiError | Consent]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -91,7 +94,7 @@ def sync_detailed(
     *,
     client: AuthenticatedClient,
     body: AttachClientAuthorizationBody,
-) -> Response[ApiError | AttachClientAuthorizationResponse201]:
+) -> Response[ApiError | Consent]:
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
@@ -107,7 +110,7 @@ def sync_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[ApiError | AttachClientAuthorizationResponse201]
+        Response[ApiError | Consent]
     """
 
     kwargs = _get_kwargs(
@@ -127,7 +130,7 @@ def sync(
     *,
     client: AuthenticatedClient,
     body: AttachClientAuthorizationBody,
-) -> ApiError | AttachClientAuthorizationResponse201 | None:
+) -> ApiError | Consent | None:
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
@@ -143,7 +146,7 @@ def sync(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        ApiError | AttachClientAuthorizationResponse201
+        ApiError | Consent
     """
 
     return sync_detailed(
@@ -158,7 +161,7 @@ async def asyncio_detailed(
     *,
     client: AuthenticatedClient,
     body: AttachClientAuthorizationBody,
-) -> Response[ApiError | AttachClientAuthorizationResponse201]:
+) -> Response[ApiError | Consent]:
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
@@ -174,7 +177,7 @@ async def asyncio_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[ApiError | AttachClientAuthorizationResponse201]
+        Response[ApiError | Consent]
     """
 
     kwargs = _get_kwargs(
@@ -192,7 +195,7 @@ async def asyncio(
     *,
     client: AuthenticatedClient,
     body: AttachClientAuthorizationBody,
-) -> ApiError | AttachClientAuthorizationResponse201 | None:
+) -> ApiError | Consent | None:
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
@@ -208,7 +211,7 @@ async def asyncio(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        ApiError | AttachClientAuthorizationResponse201
+        ApiError | Consent
     """
 
     return (

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/client.py

@@ -1,5 +1,5 @@
 import ssl
-from typing import Any
+from typing import Any, Self
 
 import httpx
 from attrs import define, evolve, field
@@ -73,7 +73,7 @@ class Client:
             self._async_client.timeout = timeout
         return evolve(self, timeout=timeout)
 
-    def set_httpx_client(self, client: httpx.Client) -> "Client":
+    def set_httpx_client(self, client: httpx.Client) -> Self:
         """Manually set the underlying httpx.Client
 
         **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
@@ -95,7 +95,7 @@ class Client:
             )
         return self._client
 
-    def __enter__(self) -> "Client":
+    def __enter__(self) -> Self:
         """Enter a context manager for self.client—you cannot enter twice (see httpx docs)"""
         self.get_httpx_client().__enter__()
         return self
@@ -104,7 +104,7 @@ class Client:
         """Exit a context manager for internal httpx.Client (see httpx docs)"""
         self.get_httpx_client().__exit__(*args, **kwargs)
 
-    def set_async_httpx_client(self, async_client: httpx.AsyncClient) -> "Client":
+    def set_async_httpx_client(self, async_client: httpx.AsyncClient) -> Self:
         """Manually set the underlying httpx.AsyncClient
 
         **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
@@ -126,7 +126,7 @@ class Client:
             )
         return self._async_client
 
-    async def __aenter__(self) -> "Client":
+    async def __aenter__(self) -> Self:
         """Enter a context manager for underlying httpx.AsyncClient—you cannot enter twice (see httpx docs)"""
         await self.get_async_httpx_client().__aenter__()
         return self
@@ -211,7 +211,7 @@ class AuthenticatedClient:
             self._async_client.timeout = timeout
         return evolve(self, timeout=timeout)
 
-    def set_httpx_client(self, client: httpx.Client) -> "AuthenticatedClient":
+    def set_httpx_client(self, client: httpx.Client) -> Self:
         """Manually set the underlying httpx.Client
 
         **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
@@ -236,7 +236,7 @@ class AuthenticatedClient:
             )
         return self._client
 
-    def __enter__(self) -> "AuthenticatedClient":
+    def __enter__(self) -> Self:
         """Enter a context manager for self.client—you cannot enter twice (see httpx docs)"""
         self.get_httpx_client().__enter__()
         return self
@@ -245,9 +245,7 @@ class AuthenticatedClient:
         """Exit a context manager for internal httpx.Client (see httpx docs)"""
         self.get_httpx_client().__exit__(*args, **kwargs)
 
-    def set_async_httpx_client(
-        self, async_client: httpx.AsyncClient
-    ) -> "AuthenticatedClient":
+    def set_async_httpx_client(self, async_client: httpx.AsyncClient) -> Self:
         """Manually set the underlying httpx.AsyncClient
 
         **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
@@ -272,7 +270,7 @@ class AuthenticatedClient:
             )
         return self._async_client
 
-    async def __aenter__(self) -> "AuthenticatedClient":
+    async def __aenter__(self) -> Self:
         """Enter a context manager for underlying httpx.AsyncClient—you cannot enter twice (see httpx docs)"""
         await self.get_async_httpx_client().__aenter__()
         return self

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/__init__.py

@@ -2,12 +2,6 @@
 
 from .api_error import ApiError
 from .attach_client_authorization_body import AttachClientAuthorizationBody
-from .attach_client_authorization_response_201 import (
-    AttachClientAuthorizationResponse201,
-)
-from .attach_client_authorization_response_201_status import (
-    AttachClientAuthorizationResponse201Status,
-)
 from .consent import Consent
 from .consent_error import ConsentError
 from .consent_link_request import ConsentLinkRequest
@@ -33,8 +27,6 @@ from .token_response import TokenResponse
 __all__ = (
     "ApiError",
     "AttachClientAuthorizationBody",
-    "AttachClientAuthorizationResponse201",
-    "AttachClientAuthorizationResponse201Status",
     "Consent",
     "ConsentError",
     "ConsentLinkRequest",

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/consent.py

@@ -24,7 +24,6 @@ class Consent:
         status (ConsentStatus):
         patient_ref (None | str): Your own reference for the patient, echoed back from consent creation.
         created_at (datetime.datetime): When the consent was created.
-        granted_at (datetime.datetime | None): When the patient authorized. Null until active.
         expires_at (datetime.datetime): When a pending link expires, or when the grant lapses.
         sources (list[ConsentSource]): Each source on the consent and its progress (live vs one-time,
             available/pending/failed).
@@ -35,7 +34,6 @@ class Consent:
     status: ConsentStatus
     patient_ref: None | str
     created_at: datetime.datetime
-    granted_at: datetime.datetime | None
     expires_at: datetime.datetime
     sources: list[ConsentSource]
     error: ConsentError | None
@@ -52,12 +50,6 @@ class Consent:
 
         created_at = self.created_at.isoformat()
 
-        granted_at: None | str
-        if isinstance(self.granted_at, datetime.datetime):
-            granted_at = self.granted_at.isoformat()
-        else:
-            granted_at = self.granted_at
-
         expires_at = self.expires_at.isoformat()
 
         sources = []
@@ -79,7 +71,6 @@ class Consent:
                 "status": status,
                 "patient_ref": patient_ref,
                 "created_at": created_at,
-                "granted_at": granted_at,
                 "expires_at": expires_at,
                 "sources": sources,
                 "error": error,
@@ -107,21 +98,6 @@ class Consent:
 
         created_at = datetime.datetime.fromisoformat(d.pop("created_at"))
 
-        def _parse_granted_at(data: object) -> datetime.datetime | None:
-            if data is None:
-                return data
-            try:
-                if not isinstance(data, str):
-                    raise TypeError()
-                granted_at_type_0 = datetime.datetime.fromisoformat(data)
-
-                return granted_at_type_0
-            except (TypeError, ValueError, AttributeError, KeyError):
-                pass
-            return cast(datetime.datetime | None, data)
-
-        granted_at = _parse_granted_at(d.pop("granted_at"))
-
         expires_at = datetime.datetime.fromisoformat(d.pop("expires_at"))
 
         sources = []
@@ -151,7 +127,6 @@ class Consent:
             status=status,
             patient_ref=patient_ref,
             created_at=created_at,
-            granted_at=granted_at,
             expires_at=expires_at,
             sources=sources,
             error=error,

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/consent_link_request.py

@@ -23,11 +23,14 @@ class ConsentLinkRequest:
         patient (PatientDemographics | Unset):
         providers (list[ProviderSeed] | Unset): Provider seeds to prefill the patient's list. Seeded by name (freeform);
             the patient can add, change, or remove them on the link page.
+        on_behalf_of_organization_name (str | Unset): Organization the verified requester is acting on behalf of for
+            this link.
     """
 
     patient_ref: str | Unset = UNSET
     patient: PatientDemographics | Unset = UNSET
     providers: list[ProviderSeed] | Unset = UNSET
+    on_behalf_of_organization_name: str | Unset = UNSET
 
     def to_dict(self) -> dict[str, Any]:
         patient_ref = self.patient_ref
@@ -43,6 +46,8 @@ class ConsentLinkRequest:
                 providers_item = providers_item_data.to_dict()
                 providers.append(providers_item)
 
+        on_behalf_of_organization_name = self.on_behalf_of_organization_name
+
         field_dict: dict[str, Any] = {}
 
         field_dict.update({})
@@ -52,6 +57,10 @@ class ConsentLinkRequest:
             field_dict["patient"] = patient
         if providers is not UNSET:
             field_dict["providers"] = providers
+        if on_behalf_of_organization_name is not UNSET:
+            field_dict["on_behalf_of_organization_name"] = (
+                on_behalf_of_organization_name
+            )
 
         return field_dict
 
@@ -79,10 +88,13 @@ class ConsentLinkRequest:
 
                 providers.append(providers_item)
 
+        on_behalf_of_organization_name = d.pop("on_behalf_of_organization_name", UNSET)
+
         consent_link_request = cls(
             patient_ref=patient_ref,
             patient=patient,
             providers=providers,
+            on_behalf_of_organization_name=on_behalf_of_organization_name,
         )
 
         return consent_link_request

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/consent_source_status.py

@@ -1,7 +1,7 @@
-from enum import Enum
+from enum import StrEnum
 
 
-class ConsentSourceStatus(str, Enum):
+class ConsentSourceStatus(StrEnum):
     AVAILABLE = "available"
     FAILED = "failed"
     PENDING = "pending"

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/consent_source_type.py

@@ -1,7 +1,7 @@
-from enum import Enum
+from enum import StrEnum
 
 
-class ConsentSourceType(str, Enum):
+class ConsentSourceType(StrEnum):
     LIVE = "live"
     ONE_TIME = "one_time"
 

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/consent_status.py

@@ -1,7 +1,7 @@
-from enum import Enum
+from enum import StrEnum
 
 
-class ConsentStatus(str, Enum):
+class ConsentStatus(StrEnum):
     ACTIVE = "active"
     ERROR = "error"
     EXPIRED = "expired"

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/device_authorization_request.py

@@ -20,6 +20,7 @@ class DeviceAuthorizationRequest:
         patient_birth_date (str | Unset): Patient's date of birth, ISO YYYY-MM-DD.
         patient_sex (str | Unset): Patient's sex.
         patient_address_line1 (str | Unset): Patient's street address.
+        patient_address_line2 (str | Unset): Patient's street address, second line (apt, suite, unit).
         patient_city (str | Unset): Patient's city.
         patient_state (str | Unset): Patient's state or region.
         patient_postal_code (str | Unset): Patient's postal code.
@@ -27,6 +28,8 @@ class DeviceAuthorizationRequest:
         patient_email (str | Unset): Patient's email, used as the signer identity.
         providers (str | Unset): JSON array of provider seeds to prefill the patient's list, each `{ "name", "phone"?
             }`. Seeded by name (freeform); the patient can add, change, or remove them on the link page.
+        on_behalf_of_organization_name (str | Unset): Organization the verified requester is acting on behalf of for
+            this link.
     """
 
     patient_ref: str | Unset = UNSET
@@ -35,12 +38,14 @@ class DeviceAuthorizationRequest:
     patient_birth_date: str | Unset = UNSET
     patient_sex: str | Unset = UNSET
     patient_address_line1: str | Unset = UNSET
+    patient_address_line2: str | Unset = UNSET
     patient_city: str | Unset = UNSET
     patient_state: str | Unset = UNSET
     patient_postal_code: str | Unset = UNSET
     patient_phone: str | Unset = UNSET
     patient_email: str | Unset = UNSET
     providers: str | Unset = UNSET
+    on_behalf_of_organization_name: str | Unset = UNSET
 
     def to_dict(self) -> dict[str, Any]:
         patient_ref = self.patient_ref
@@ -55,6 +60,8 @@ class DeviceAuthorizationRequest:
 
         patient_address_line1 = self.patient_address_line1
 
+        patient_address_line2 = self.patient_address_line2
+
         patient_city = self.patient_city
 
         patient_state = self.patient_state
@@ -67,6 +74,8 @@ class DeviceAuthorizationRequest:
 
         providers = self.providers
 
+        on_behalf_of_organization_name = self.on_behalf_of_organization_name
+
         field_dict: dict[str, Any] = {}
 
         field_dict.update({})
@@ -82,6 +91,8 @@ class DeviceAuthorizationRequest:
             field_dict["patient_sex"] = patient_sex
         if patient_address_line1 is not UNSET:
             field_dict["patient_address_line1"] = patient_address_line1
+        if patient_address_line2 is not UNSET:
+            field_dict["patient_address_line2"] = patient_address_line2
         if patient_city is not UNSET:
             field_dict["patient_city"] = patient_city
         if patient_state is not UNSET:
@@ -94,6 +105,10 @@ class DeviceAuthorizationRequest:
             field_dict["patient_email"] = patient_email
         if providers is not UNSET:
             field_dict["providers"] = providers
+        if on_behalf_of_organization_name is not UNSET:
+            field_dict["on_behalf_of_organization_name"] = (
+                on_behalf_of_organization_name
+            )
 
         return field_dict
 
@@ -112,6 +127,8 @@ class DeviceAuthorizationRequest:
 
         patient_address_line1 = d.pop("patient_address_line1", UNSET)
 
+        patient_address_line2 = d.pop("patient_address_line2", UNSET)
+
         patient_city = d.pop("patient_city", UNSET)
 
         patient_state = d.pop("patient_state", UNSET)
@@ -124,6 +141,8 @@ class DeviceAuthorizationRequest:
 
         providers = d.pop("providers", UNSET)
 
+        on_behalf_of_organization_name = d.pop("on_behalf_of_organization_name", UNSET)
+
         device_authorization_request = cls(
             patient_ref=patient_ref,
             patient_first_name=patient_first_name,
@@ -131,12 +150,14 @@ class DeviceAuthorizationRequest:
             patient_birth_date=patient_birth_date,
             patient_sex=patient_sex,
             patient_address_line1=patient_address_line1,
+            patient_address_line2=patient_address_line2,
             patient_city=patient_city,
             patient_state=patient_state,
             patient_postal_code=patient_postal_code,
             patient_phone=patient_phone,
             patient_email=patient_email,
             providers=providers,
+            on_behalf_of_organization_name=on_behalf_of_organization_name,
         )
 
         return device_authorization_request

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/o_auth_error_error.py

@@ -1,7 +1,7 @@
-from enum import Enum
+from enum import StrEnum
 
 
-class OAuthErrorError(str, Enum):
+class OAuthErrorError(StrEnum):
     ACCESS_DENIED = "access_denied"
     AUTHORIZATION_PENDING = "authorization_pending"
     EXPIRED_TOKEN = "expired_token"

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/operation_outcome.py

@@ -51,7 +51,9 @@ class OperationOutcome:
 
     @classmethod
     def from_dict(cls, src_dict: Mapping[str, Any]) -> Self:
-        from ..models.operation_outcome_issue_item import OperationOutcomeIssueItem
+        from ..models.operation_outcome_issue_item import (
+            OperationOutcomeIssueItem,
+        )
 
         d = dict(src_dict)
         resource_type = cast(Literal["OperationOutcome"], d.pop("resourceType"))

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/patient_address.py

@@ -15,12 +15,14 @@ class PatientAddress:
     """
     Attributes:
         line1 (str | Unset): Street address.
+        line2 (str | Unset): Street address, second line (apt, suite, unit).
         city (str | Unset): City.
         state (str | Unset): State or region.
         postal_code (str | Unset): Postal code.
     """
 
     line1: str | Unset = UNSET
+    line2: str | Unset = UNSET
     city: str | Unset = UNSET
     state: str | Unset = UNSET
     postal_code: str | Unset = UNSET
@@ -28,6 +30,8 @@ class PatientAddress:
     def to_dict(self) -> dict[str, Any]:
         line1 = self.line1
 
+        line2 = self.line2
+
         city = self.city
 
         state = self.state
@@ -39,6 +43,8 @@ class PatientAddress:
         field_dict.update({})
         if line1 is not UNSET:
             field_dict["line1"] = line1
+        if line2 is not UNSET:
+            field_dict["line2"] = line2
         if city is not UNSET:
             field_dict["city"] = city
         if state is not UNSET:
@@ -53,6 +59,8 @@ class PatientAddress:
         d = dict(src_dict)
         line1 = d.pop("line1", UNSET)
 
+        line2 = d.pop("line2", UNSET)
+
         city = d.pop("city", UNSET)
 
         state = d.pop("state", UNSET)
@@ -61,6 +69,7 @@ class PatientAddress:
 
         patient_address = cls(
             line1=line1,
+            line2=line2,
             city=city,
             state=state,
             postal_code=postal_code,

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_generated/models/token_request_grant_type.py

@@ -1,7 +1,7 @@
-from enum import Enum
+from enum import StrEnum
 
 
-class TokenRequestGrantType(str, Enum):
+class TokenRequestGrantType(StrEnum):
     AUTHORIZATION_CODE = "authorization_code"
     REFRESH_TOKEN = "refresh_token"
     URNIETFPARAMSOAUTHGRANT_TYPEDEVICE_CODE = (

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/hubble_sdk/_hubble.py

@@ -11,15 +11,20 @@ device-authorization flow, and refreshes consent tokens transparently.
 from __future__ import annotations
 
 import base64
+import json
 import time
 from collections.abc import Callable, Mapping
 from dataclasses import dataclass
+from datetime import datetime
+from io import BytesIO
+from pathlib import Path
 from typing import Any, TypeVar
 from urllib.parse import unquote
 
 import httpx
 
 from ._generated.api.default import (
+    attach_client_authorization as _attach_client_authorization,
     create_consent_link,
     exchange_token,
     get_consent as _get_consent,
@@ -28,6 +33,7 @@ from ._generated.api.default import (
 )
 from ._generated.client import AuthenticatedClient
 from ._generated.models import (
+    AttachClientAuthorizationBody,
     Consent,
     ConsentLinkRequest,
     ConsentList,
@@ -37,7 +43,7 @@ from ._generated.models import (
     TokenRequestGrantType,
     TokenResponse,
 )
-from ._generated.types import UNSET
+from ._generated.types import UNSET, File
 
 DEFAULT_BASE_URL = "https://portal.hubble.ai"
 _DEVICE_CODE_GRANT = TokenRequestGrantType("urn:ietf:params:oauth:grant-type:device_code")
@@ -88,13 +94,16 @@ class Hubble:
         self,
         *,
         patient_ref: str | None = None,
+        on_behalf_of_organization_name: str | None = None,
         patient: Mapping[str, Any] | None = None,
         providers: list[Mapping[str, Any]] | None = None,
     ) -> DeviceAuthorizationResponse:
         """Start the patient link flow. Send the patient to the returned
         ``verification_uri_complete``, then call `wait_for_authorization()`.
 
-        Optionally prefill the link. ``patient`` is a mapping of demographics
+        Optionally prefill the link. ``on_behalf_of_organization_name`` identifies
+        the organization your verified Hubble organization represents for this
+        link. ``patient`` is a mapping of demographics
         (``first_name``, ``last_name``, ``birth_date``, ``sex``, ``phone``,
         ``email``, and a nested ``address``); ``providers`` is a list of provider
         seeds (each ``{"name": ..., "phone"?: ...}``) to prefill the patient's
@@ -102,6 +111,8 @@ class Hubble:
         body: dict[str, Any] = {}
         if patient_ref is not None:
             body["patient_ref"] = patient_ref
+        if on_behalf_of_organization_name is not None:
+            body["on_behalf_of_organization_name"] = on_behalf_of_organization_name
         if patient is not None:
             body["patient"] = dict(patient)
         if providers is not None:
@@ -172,6 +183,59 @@ class Hubble:
             f"Could not revoke consent {consent_id}",
         )
 
+    def attach_authorization(
+        self,
+        consent_id: str,
+        *,
+        authorization: bytes | str | Path,
+        disclosers: list[Mapping[str, str]],
+        expires_at: str | datetime | None = None,
+        content_type: str = "application/pdf",
+    ) -> Consent:
+        """Attach a customer-supplied, already-signed HIPAA authorization to a
+        consent and grant delegated retrieval from the providers it names.
+
+        The signed artifact is the evidence, so the consent is granted at once
+        with no patient step, and the granted `Consent` is returned — each
+        discloser appears on it as a one-time source, ``pending`` until its
+        records are retrieved. Requires the ``byo_hipaa_authorization``
+        entitlement on your organization (a caller without it gets a `HubbleError`
+        wrapping the API's 403).
+
+        Args:
+            authorization: the signed file to upload, as raw ``bytes`` or a
+                filesystem path (``str``/``Path``) to read it from.
+            disclosers: the providers to disclose from — a list of mappings, each
+                with a ``name`` (e.g. a provider named General Hospital),
+                serialized to the JSON array the API expects.
+            expires_at: the authorization's asserted expiration (ISO 8601 string
+                or ``datetime``); omit if it does not expire.
+        """
+        if isinstance(authorization, (str, Path)):
+            path = Path(authorization)
+            data = path.read_bytes()
+            upload_name = path.name
+        else:
+            data = authorization
+            upload_name = "authorization"
+
+        expires = (
+            datetime.fromisoformat(expires_at) if isinstance(expires_at, str) else expires_at
+        )
+        # The multipart part must carry a non-empty filename or the server parses
+        # it as a text field instead of a file. The value is transport-only — the
+        # API stores the artifact under its own id and never reads this name.
+        body = AttachClientAuthorizationBody(
+            authorization=File(payload=BytesIO(data), file_name=upload_name, mime_type=content_type),
+            disclosers=json.dumps([dict(d) for d in disclosers]),
+            expires_at=expires if expires is not None else UNSET,
+        )
+        return _unwrap(
+            _attach_client_authorization.sync(id=consent_id, client=self._control, body=body),
+            Consent,
+            f"Could not attach authorization to consent {consent_id}",
+        )
+
     # ── reconstruct a session from stored tokens ──────────────────────────────
 
     def session(

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/pyproject.toml

@@ -3,7 +3,7 @@
 # none); this file and the build config are not.
 [project]
 name = "hubble-sdk-python"
-version = "0.0.3"
+version = "0.1.0"
 description = "Python client for the Hubble Patient Access API."
 readme = "README.md"
 requires-python = ">=3.11"

{hubble_sdk_python-0.0.3 → hubble_sdk_python-0.1.0}/tests/test_hubble.py

@@ -15,7 +15,14 @@ import pytest
 import respx
 
 from hubble_sdk import ConsentTimeout, Hubble, HubbleError, TokenSet
-from hubble_sdk._generated.models import DeviceAuthorizationResponse
+from hubble_sdk._generated.models import (
+    ConsentLinkRequest,
+    DeviceAuthorizationRequest,
+    DeviceAuthorizationResponse,
+    PatientDemographics,
+    ProviderSeed,
+)
+from hubble_sdk._generated.types import UNSET
 
 BASE = "https://portal.hubble.ai"
 BASIC = "Basic " + base64.b64encode(b"id:sec").decode()
@@ -41,7 +48,6 @@ CONSENT_DICT = {
     "status": "active",
     "patient_ref": "abc",
     "created_at": "2026-01-01T00:00:00Z",
-    "granted_at": "2026-01-01T00:05:00Z",
     "expires_at": "2026-06-01T00:00:00Z",
     "sources": [{"provider": "General Hospital", "type": "live", "status": "available"}],
     "error": None,
@@ -67,6 +73,7 @@ def test_create_link_posts_json_with_basic_auth_and_nested_prefill():
 
     result = hub().create_link(
         patient_ref="abc",
+        on_behalf_of_organization_name="Acme Health",
         patient={"first_name": "Jane", "address": {"city": "Springfield"}},
         providers=[{"name": "Dr. Smith", "phone": "555-0100"}],
     )
@@ -77,11 +84,30 @@ def test_create_link_posts_json_with_basic_auth_and_nested_prefill():
     assert req.headers["Content-Type"].startswith("application/json")
     sent = json.loads(req.content)
     assert sent["patient_ref"] == "abc"
+    assert sent["on_behalf_of_organization_name"] == "Acme Health"
     assert sent["patient"]["first_name"] == "Jane"
     assert sent["patient"]["address"]["city"] == "Springfield"
     assert sent["providers"] == [{"name": "Dr. Smith", "phone": "555-0100"}]
 
 
+def test_generated_request_models_preserve_existing_positional_arguments():
+    patient = PatientDemographics(first_name="Jane")
+    provider = ProviderSeed(name="Dr. Smith")
+
+    # These were valid positional calls before the represented-organization
+    # field was added. It must remain last in generated models so none of the
+    # existing arguments silently changes meaning.
+    link_request = ConsentLinkRequest("abc", patient, [provider])
+    form_request = DeviceAuthorizationRequest("abc", "Jane", "Rivera")
+
+    assert link_request.patient is patient
+    assert link_request.providers == [provider]
+    assert link_request.on_behalf_of_organization_name is UNSET
+    assert form_request.patient_first_name == "Jane"
+    assert form_request.patient_last_name == "Rivera"
+    assert form_request.on_behalf_of_organization_name is UNSET
+
+
 @respx.mock
 def test_create_link_raises_with_context_on_error():
     respx.post(f"{BASE}/api/v1/consents/oauth/device_authorization").mock(
@@ -136,6 +162,78 @@ def test_revoke_consent_surfaces_failure():
         hub().revoke_consent("cns_x")
 
 
+GRANT_CONSENT_DICT = {
+    "id": "cns_1",
+    "status": "active",
+    "patient_ref": "abc",
+    "created_at": "2026-01-01T00:00:00Z",
+    "expires_at": "2027-01-01T00:00:00Z",
+    "sources": [
+        {"provider": "General Hospital", "type": "one_time", "status": "pending"},
+        {"provider": "City Clinic", "type": "one_time", "status": "pending"},
+    ],
+    "error": None,
+}
+
+
+@respx.mock
+def test_attach_authorization_posts_multipart_and_returns_consent():
+    route = respx.post(f"{BASE}/api/v1/consents/cns_1/authorization").mock(
+        return_value=httpx.Response(200, json=GRANT_CONSENT_DICT)
+    )
+
+    consent = hub().attach_authorization(
+        "cns_1",
+        authorization=b"%PDF-1.7 signed",
+        disclosers=[{"name": "General Hospital"}, {"name": "City Clinic"}],
+        expires_at="2027-01-01T00:00:00",
+    )
+
+    # Returns the granted consent, with each discloser as a pending one-time source.
+    assert consent.id == "cns_1"
+    assert consent.status.value == "active"
+    assert [(s.provider, s.type_.value, s.status.value) for s in consent.sources] == [
+        ("General Hospital", "one_time", "pending"),
+        ("City Clinic", "one_time", "pending"),
+    ]
+
+    req = route.calls.last.request
+    assert req.headers["Authorization"] == BASIC
+    assert req.headers["Content-Type"].startswith("multipart/form-data")
+    body = req.content
+    assert b'name="authorization"' in body
+    assert b"%PDF-1.7 signed" in body
+    # disclosers travels as a JSON array string.
+    assert b'[{"name": "General Hospital"}, {"name": "City Clinic"}]' in body
+    assert b"2027-01-01T00:00:00" in body
+
+
+@respx.mock
+def test_attach_authorization_reads_a_file_path(tmp_path):
+    route = respx.post(f"{BASE}/api/v1/consents/cns_1/authorization").mock(
+        return_value=httpx.Response(200, json=GRANT_CONSENT_DICT)
+    )
+    pdf = tmp_path / "signed-auth.pdf"
+    pdf.write_bytes(b"%PDF-1.7 from disk")
+
+    hub().attach_authorization("cns_1", authorization=pdf, disclosers=[{"name": "X"}])
+
+    body = route.calls.last.request.content
+    assert b"%PDF-1.7 from disk" in body
+    # The path's name becomes the upload filename.
+    assert b'filename="signed-auth.pdf"' in body
+
+
+@respx.mock
+def test_attach_authorization_surfaces_not_entitled_403():
+    respx.post(f"{BASE}/api/v1/consents/cns_1/authorization").mock(
+        return_value=httpx.Response(403, json={"error": "not enabled for this"})
+    )
+
+    with pytest.raises(HubbleError, match="Could not attach authorization to consent cns_1"):
+        hub().attach_authorization("cns_1", authorization=b"x", disclosers=[{"name": "X"}])
+
+
 def test_base_url_trailing_slash_is_normalized():
     assert Hubble("id", "sec", base_url="https://staging.hubble.ai/").base_url == (
         "https://staging.hubble.ai"

hubble_sdk_python-0.0.3/hubble_sdk/_generated/models/attach_client_authorization_response_201.py

@@ -1,100 +0,0 @@
-from __future__ import annotations
-
-from collections.abc import Mapping
-from typing import Any, Self, TypeVar, cast
-
-from attrs import define as _attrs_define
-from attrs import field as _attrs_field
-
-from ..models.attach_client_authorization_response_201_status import (
-    AttachClientAuthorizationResponse201Status,
-)
-from ..types import UNSET, Unset
-
-T = TypeVar("T", bound="AttachClientAuthorizationResponse201")
-
-
-@_attrs_define
-class AttachClientAuthorizationResponse201:
-    """
-    Attributes:
-        consent_id (str | Unset):
-        status (AttachClientAuthorizationResponse201Status | Unset):
-        authorization_id (str | Unset):
-        requests (list[str] | Unset):
-    """
-
-    consent_id: str | Unset = UNSET
-    status: AttachClientAuthorizationResponse201Status | Unset = UNSET
-    authorization_id: str | Unset = UNSET
-    requests: list[str] | Unset = UNSET
-    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
-
-    def to_dict(self) -> dict[str, Any]:
-        consent_id = self.consent_id
-
-        status: str | Unset = UNSET
-        if not isinstance(self.status, Unset):
-            status = self.status.value
-
-        authorization_id = self.authorization_id
-
-        requests: list[str] | Unset = UNSET
-        if not isinstance(self.requests, Unset):
-            requests = self.requests
-
-        field_dict: dict[str, Any] = {}
-        field_dict.update(self.additional_properties)
-        field_dict.update({})
-        if consent_id is not UNSET:
-            field_dict["consent_id"] = consent_id
-        if status is not UNSET:
-            field_dict["status"] = status
-        if authorization_id is not UNSET:
-            field_dict["authorization_id"] = authorization_id
-        if requests is not UNSET:
-            field_dict["requests"] = requests
-
-        return field_dict
-
-    @classmethod
-    def from_dict(cls, src_dict: Mapping[str, Any]) -> Self:
-        d = dict(src_dict)
-        consent_id = d.pop("consent_id", UNSET)
-
-        _status = d.pop("status", UNSET)
-        status: AttachClientAuthorizationResponse201Status | Unset
-        if isinstance(_status, Unset):
-            status = UNSET
-        else:
-            status = AttachClientAuthorizationResponse201Status(_status)
-
-        authorization_id = d.pop("authorization_id", UNSET)
-
-        requests = cast(list[str], d.pop("requests", UNSET))
-
-        attach_client_authorization_response_201 = cls(
-            consent_id=consent_id,
-            status=status,
-            authorization_id=authorization_id,
-            requests=requests,
-        )
-
-        attach_client_authorization_response_201.additional_properties = d
-        return attach_client_authorization_response_201
-
-    @property
-    def additional_keys(self) -> list[str]:
-        return list(self.additional_properties.keys())
-
-    def __getitem__(self, key: str) -> Any:
-        return self.additional_properties[key]
-
-    def __setitem__(self, key: str, value: Any) -> None:
-        self.additional_properties[key] = value
-
-    def __delitem__(self, key: str) -> None:
-        del self.additional_properties[key]
-
-    def __contains__(self, key: str) -> bool:
-        return key in self.additional_properties

hubble_sdk_python-0.0.3/hubble_sdk/_generated/models/attach_client_authorization_response_201_status.py

@@ -1,8 +0,0 @@
-from enum import Enum
-
-
-class AttachClientAuthorizationResponse201Status(str, Enum):
-    GRANTED = "granted"
-
-    def __str__(self) -> str:
-        return str(self.value)