hubble-sdk-python 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

hubble_sdk/_generated/api/default/attach_client_authorization.py

@@ -98,8 +98,14 @@ def sync_detailed(
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
-    providers it names. The artifact IS the evidence, so the consent is granted at once with no patient
-    step. Requires the `byo_hipaa_authorization` entitlement on your organization.
+    providers it names. Hubble keeps a copy of the signed authorization on file and, based on your
+    attestation, makes the consent `active` right away with no patient step. If your organization also
+    uses EHR sign-in, health plans, or the health information network, the consent stays `pending` until
+    the patient finishes the link. Requires the `byo_hipaa_authorization` entitlement on your
+    organization. Attaching an authorization is your organization's attestation that it holds a valid
+    HIPAA authorization signed by the patient, and that it covers the providers you name. Hubble does
+    not review the document or ask the patient to confirm it, so your organization is responsible for
+    checking that the authorization is correct before you attach it.
 
     Args:
         id (str):
@@ -134,8 +140,14 @@ def sync(
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
-    providers it names. The artifact IS the evidence, so the consent is granted at once with no patient
-    step. Requires the `byo_hipaa_authorization` entitlement on your organization.
+    providers it names. Hubble keeps a copy of the signed authorization on file and, based on your
+    attestation, makes the consent `active` right away with no patient step. If your organization also
+    uses EHR sign-in, health plans, or the health information network, the consent stays `pending` until
+    the patient finishes the link. Requires the `byo_hipaa_authorization` entitlement on your
+    organization. Attaching an authorization is your organization's attestation that it holds a valid
+    HIPAA authorization signed by the patient, and that it covers the providers you name. Hubble does
+    not review the document or ask the patient to confirm it, so your organization is responsible for
+    checking that the authorization is correct before you attach it.
 
     Args:
         id (str):
@@ -165,8 +177,14 @@ async def asyncio_detailed(
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
-    providers it names. The artifact IS the evidence, so the consent is granted at once with no patient
-    step. Requires the `byo_hipaa_authorization` entitlement on your organization.
+    providers it names. Hubble keeps a copy of the signed authorization on file and, based on your
+    attestation, makes the consent `active` right away with no patient step. If your organization also
+    uses EHR sign-in, health plans, or the health information network, the consent stays `pending` until
+    the patient finishes the link. Requires the `byo_hipaa_authorization` entitlement on your
+    organization. Attaching an authorization is your organization's attestation that it holds a valid
+    HIPAA authorization signed by the patient, and that it covers the providers you name. Hubble does
+    not review the document or ask the patient to confirm it, so your organization is responsible for
+    checking that the authorization is correct before you attach it.
 
     Args:
         id (str):
@@ -199,8 +217,14 @@ async def asyncio(
     """Attach a customer-supplied HIPAA authorization
 
      Upload an already-signed HIPAA authorization for a consent and grant delegated retrieval from the
-    providers it names. The artifact IS the evidence, so the consent is granted at once with no patient
-    step. Requires the `byo_hipaa_authorization` entitlement on your organization.
+    providers it names. Hubble keeps a copy of the signed authorization on file and, based on your
+    attestation, makes the consent `active` right away with no patient step. If your organization also
+    uses EHR sign-in, health plans, or the health information network, the consent stays `pending` until
+    the patient finishes the link. Requires the `byo_hipaa_authorization` entitlement on your
+    organization. Attaching an authorization is your organization's attestation that it holds a valid
+    HIPAA authorization signed by the patient, and that it covers the providers you name. Hubble does
+    not review the document or ask the patient to confirm it, so your organization is responsible for
+    checking that the authorization is correct before you attach it.
 
     Args:
         id (str):

hubble_sdk/_generated/models/consent.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING, Any, Self, TypeVar, cast
 from attrs import define as _attrs_define
 
 from ..models.consent_status import ConsentStatus
+from ..types import UNSET, Unset
 
 if TYPE_CHECKING:
     from ..models.consent_error import ConsentError
@@ -27,7 +28,9 @@ class Consent:
         expires_at (datetime.datetime): When the patient link expires.
         sources (list[ConsentSource]): Each source on the consent and its progress (live vs one-time,
             available/pending/failed).
-        error (ConsentError | None): Populated only when status is error.
+        error (ConsentError | None | Unset): Deprecated and scheduled for removal. Branch on `status` instead: `error`
+            means the consent finished with no source attached. `code` is always `authorization_failed`, and `message` is
+            internal diagnostic text, so neither is safe to depend on.
     """
 
     id: str
@@ -36,7 +39,7 @@ class Consent:
     created_at: datetime.datetime
     expires_at: datetime.datetime
     sources: list[ConsentSource]
-    error: ConsentError | None
+    error: ConsentError | None | Unset = UNSET
 
     def to_dict(self) -> dict[str, Any]:
         from ..models.consent_error import ConsentError
@@ -57,8 +60,10 @@ class Consent:
             sources_item = sources_item_data.to_dict()
             sources.append(sources_item)
 
-        error: dict[str, Any] | None
-        if isinstance(self.error, ConsentError):
+        error: dict[str, Any] | None | Unset
+        if isinstance(self.error, Unset):
+            error = UNSET
+        elif isinstance(self.error, ConsentError):
             error = self.error.to_dict()
         else:
             error = self.error
@@ -73,9 +78,10 @@ class Consent:
                 "created_at": created_at,
                 "expires_at": expires_at,
                 "sources": sources,
-                "error": error,
             }
         )
+        if error is not UNSET:
+            field_dict["error"] = error
 
         return field_dict
 
@@ -87,7 +93,7 @@ class Consent:
         d = dict(src_dict)
         id = d.pop("id")
 
-        status = ConsentStatus(d.pop("status"))
+        status = ConsentStatus._from_value(d.pop("status"))
 
         def _parse_patient_ref(data: object) -> None | str:
             if data is None:
@@ -107,9 +113,11 @@ class Consent:
 
             sources.append(sources_item)
 
-        def _parse_error(data: object) -> ConsentError | None:
+        def _parse_error(data: object) -> ConsentError | None | Unset:
             if data is None:
                 return data
+            if isinstance(data, Unset):
+                return data
             try:
                 if not isinstance(data, dict):
                     raise TypeError()
@@ -118,9 +126,9 @@ class Consent:
                 return error_type_0
             except (TypeError, ValueError, AttributeError, KeyError):
                 pass
-            return cast(ConsentError | None, data)
+            return cast(ConsentError | None | Unset, data)
 
-        error = _parse_error(d.pop("error"))
+        error = _parse_error(d.pop("error", UNSET))
 
         consent = cls(
             id=id,

hubble_sdk/_generated/models/consent_source.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from collections.abc import Mapping
-from typing import Any, Self, TypeVar
+from typing import Any, Self, TypeVar, cast
 
 from attrs import define as _attrs_define
 
@@ -18,6 +18,8 @@ class ConsentSource:
         id (str): The source's id. Pass it as `connection=<id>` to read or export this one source instead of all of
             them. Present on every source, including ones still pending.
         provider (str): The source as the customer knows it (facility / provider name).
+        provider_ref (None | str): The `provider_ref` you gave the seeded provider this source came from. Null for a
+            source the patient added themselves.
         type_ (ConsentSourceType): live = an ongoing connection re-readable until its access lapses (EHR, HIE); one_time
             = a single pull with no ongoing connection (delegated retrieval).
         status (ConsentSourceStatus): available = records readable now; pending = still being reached out to; failed =
@@ -27,6 +29,7 @@ class ConsentSource:
 
     id: str
     provider: str
+    provider_ref: None | str
     type_: ConsentSourceType
     status: ConsentSourceStatus
 
@@ -35,6 +38,9 @@ class ConsentSource:
 
         provider = self.provider
 
+        provider_ref: None | str
+        provider_ref = self.provider_ref
+
         type_ = self.type_.value
 
         status = self.status.value
@@ -45,6 +51,7 @@ class ConsentSource:
             {
                 "id": id,
                 "provider": provider,
+                "provider_ref": provider_ref,
                 "type": type_,
                 "status": status,
             }
@@ -59,13 +66,21 @@ class ConsentSource:
 
         provider = d.pop("provider")
 
-        type_ = ConsentSourceType(d.pop("type"))
+        def _parse_provider_ref(data: object) -> None | str:
+            if data is None:
+                return data
+            return cast(None | str, data)
+
+        provider_ref = _parse_provider_ref(d.pop("provider_ref"))
+
+        type_ = ConsentSourceType._from_value(d.pop("type"))
 
-        status = ConsentSourceStatus(d.pop("status"))
+        status = ConsentSourceStatus._from_value(d.pop("status"))
 
         consent_source = cls(
             id=id,
             provider=provider,
+            provider_ref=provider_ref,
             type_=type_,
             status=status,
         )

hubble_sdk/_generated/models/consent_source_status.py

@@ -9,3 +9,22 @@ class ConsentSourceStatus(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(ConsentSourceStatus), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "ConsentSourceStatus":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/consent_source_type.py

@@ -7,3 +7,22 @@ class ConsentSourceType(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(ConsentSourceType), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "ConsentSourceType":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/consent_status.py

@@ -10,3 +10,22 @@ class ConsentStatus(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(ConsentStatus), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "ConsentStatus":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/device_authorization_request.py

@@ -29,8 +29,8 @@ class DeviceAuthorizationRequest:
         patient_postal_code (str | Unset): Patient's postal code.
         patient_phone (str | Unset): Patient's phone number.
         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.
+        providers (str | Unset): JSON array of provider seeds to prefill the patient's list, each a `ProviderSeed`.
+            Seeded by name (freeform); the patient can add, change, or remove them on the link page.
     """
 
     patient_ref: str | Unset = UNSET

hubble_sdk/_generated/models/export_patient_fhir_prefer.py

@@ -6,3 +6,22 @@ class ExportPatientFhirPrefer(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(ExportPatientFhirPrefer), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "ExportPatientFhirPrefer":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/export_patient_fhir_response_202.py

@@ -70,7 +70,7 @@ class ExportPatientFhirResponse202:
         if isinstance(_status, Unset):
             status = UNSET
         else:
-            status = ExportPatientFhirResponse202Status(_status)
+            status = ExportPatientFhirResponse202Status._from_value(_status)
 
         _expires_at = d.pop("expiresAt", UNSET)
         expires_at: datetime.datetime | Unset

hubble_sdk/_generated/models/export_patient_fhir_response_202_status.py

@@ -7,3 +7,22 @@ class ExportPatientFhirResponse202Status(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(ExportPatientFhirResponse202Status), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "ExportPatientFhirResponse202Status":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/export_patient_pdf_prefer.py

@@ -6,3 +6,22 @@ class ExportPatientPdfPrefer(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(ExportPatientPdfPrefer), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "ExportPatientPdfPrefer":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/export_patient_pdf_response_202.py

@@ -70,7 +70,7 @@ class ExportPatientPdfResponse202:
         if isinstance(_status, Unset):
             status = UNSET
         else:
-            status = ExportPatientPdfResponse202Status(_status)
+            status = ExportPatientPdfResponse202Status._from_value(_status)
 
         _expires_at = d.pop("expiresAt", UNSET)
         expires_at: datetime.datetime | Unset

hubble_sdk/_generated/models/export_patient_pdf_response_202_status.py

@@ -7,3 +7,22 @@ class ExportPatientPdfResponse202Status(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(ExportPatientPdfResponse202Status), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "ExportPatientPdfResponse202Status":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/get_patient_pdf_export_download.py

@@ -6,3 +6,22 @@ class GetPatientPdfExportDownload(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(GetPatientPdfExportDownload), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "GetPatientPdfExportDownload":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/get_patient_pdf_export_response_200.py

@@ -76,7 +76,7 @@ class GetPatientPdfExportResponse200:
         if isinstance(_status, Unset):
             status = UNSET
         else:
-            status = GetPatientPdfExportResponse200Status(_status)
+            status = GetPatientPdfExportResponse200Status._from_value(_status)
 
         download_url = d.pop("downloadUrl", UNSET)
 

hubble_sdk/_generated/models/get_patient_pdf_export_response_200_status.py

@@ -6,3 +6,22 @@ class GetPatientPdfExportResponse200Status(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(GetPatientPdfExportResponse200Status), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "GetPatientPdfExportResponse200Status":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/o_auth_error.py

@@ -42,7 +42,7 @@ class OAuthError:
     @classmethod
     def from_dict(cls, src_dict: Mapping[str, Any]) -> Self:
         d = dict(src_dict)
-        error = OAuthErrorError(d.pop("error"))
+        error = OAuthErrorError._from_value(d.pop("error"))
 
         error_description = d.pop("error_description", UNSET)
 

hubble_sdk/_generated/models/o_auth_error_error.py

@@ -14,3 +14,22 @@ class OAuthErrorError(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(OAuthErrorError), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "OAuthErrorError":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_generated/models/provider_seed.py

@@ -16,16 +16,22 @@ class ProviderSeed:
     Attributes:
         name (str): Provider name, as the patient would recognize it.
         phone (str | Unset): Optional contact, for a provider that isn't reachable electronically.
+        provider_ref (str | Unset): Your own id for this provider, echoed as `provider_ref` on every source that comes
+            from it, in GET /consents/{id} and in source webhooks. A source the patient added themselves has none. Must be
+            unique within the request.
     """
 
     name: str
     phone: str | Unset = UNSET
+    provider_ref: str | Unset = UNSET
 
     def to_dict(self) -> dict[str, Any]:
         name = self.name
 
         phone = self.phone
 
+        provider_ref = self.provider_ref
+
         field_dict: dict[str, Any] = {}
 
         field_dict.update(
@@ -35,6 +41,8 @@ class ProviderSeed:
         )
         if phone is not UNSET:
             field_dict["phone"] = phone
+        if provider_ref is not UNSET:
+            field_dict["provider_ref"] = provider_ref
 
         return field_dict
 
@@ -45,9 +53,12 @@ class ProviderSeed:
 
         phone = d.pop("phone", UNSET)
 
+        provider_ref = d.pop("provider_ref", UNSET)
+
         provider_seed = cls(
             name=name,
             phone=phone,
+            provider_ref=provider_ref,
         )
 
         return provider_seed

hubble_sdk/_generated/models/token_request.py

@@ -60,7 +60,7 @@ class TokenRequest:
     @classmethod
     def from_dict(cls, src_dict: Mapping[str, Any]) -> Self:
         d = dict(src_dict)
-        grant_type = TokenRequestGrantType(d.pop("grant_type"))
+        grant_type = TokenRequestGrantType._from_value(d.pop("grant_type"))
 
         device_code = d.pop("device_code", UNSET)
 

hubble_sdk/_generated/models/token_request_grant_type.py

@@ -9,3 +9,22 @@ class TokenRequestGrantType(StrEnum):
 
     def __str__(self) -> str:
         return str(self.value)
+
+    # How API responses are parsed. The API may add values to this enum without a
+    # new SDK release, so a value this version does not know becomes a member
+    # carrying the raw string instead of raising. It compares equal to that string
+    # and is absent from list(TokenRequestGrantType), which is how to tell it apart.
+    # A value that is not a string is a malformed response and still raises.
+    # Constructing the enum directly stays strict, so a typo in a value you pass
+    # in still raises and membership checks are unchanged.
+    @classmethod
+    def _from_value(cls, value: object) -> "TokenRequestGrantType":
+        try:
+            return cls(value)
+        except ValueError:
+            if not isinstance(value, str):
+                raise
+            member = str.__new__(cls, value)
+            member._name_ = value
+            member._value_ = value
+            return member

hubble_sdk/_hubble.py

@@ -106,8 +106,7 @@ class Hubble:
         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
-        list. The patient can add, change, or remove any of it on the link page."""
+        seeds (each shaped like ``ProviderSeed``) to prefill the patient's list. The patient can add, change, or remove any of it on the link page."""
         body: dict[str, Any] = {}
         if patient_ref is not None:
             body["patient_ref"] = patient_ref
@@ -219,12 +218,18 @@ class Hubble:
         """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).
+        Hubble keeps a copy of the signed authorization on file and, based on your
+        attestation, makes the consent ``active`` right away with no patient step,
+        and returns the `Consent`. 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).
+
+        Attaching an authorization is your organization's attestation that it
+        holds a valid HIPAA authorization signed by the patient, and that it
+        covers the providers you name. Hubble does not review the document or ask
+        the patient to confirm it, so your organization is responsible for
+        checking that the authorization is correct before you attach it.
 
         Args:
             authorization: the signed file to upload, as raw ``bytes`` or a

hubble_sdk/_webhooks.py

@@ -48,6 +48,9 @@ class WebhookEventSource:
     provider: str
     type: str  # "live" | "one_time"
     status: str  # "available" | "pending" | "failed" | "revoked" (source.revoked only)
+    # Your ``provider_ref`` for the seeded provider this source came from; ``None``
+    # for a source the patient added, and on events emitted before the field existed.
+    provider_ref: str | None = None
 
 
 @dataclass(frozen=True)
@@ -97,7 +100,11 @@ class WebhookEvent:
         if not isinstance(s, dict):
             return None
         return WebhookEventSource(
-            id=s["id"], provider=s["provider"], type=s["type"], status=s["status"]
+            id=s["id"],
+            provider=s["provider"],
+            type=s["type"],
+            status=s["status"],
+            provider_ref=s.get("provider_ref"),
         )
 
 

{hubble_sdk_python-0.2.0.dist-info → hubble_sdk_python-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: hubble-sdk-python
-Version: 0.2.0
+Version: 0.2.1
 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

{hubble_sdk_python-0.2.0.dist-info → hubble_sdk_python-0.2.1.dist-info}/RECORD

@@ -1,13 +1,13 @@
 hubble_sdk/__init__.py,sha256=FV04hFDUzSKzqAXq3YJgZmmM5Yu9qbv-cIyjbLdfqsE,1335
-hubble_sdk/_hubble.py,sha256=jzsuWtyS5SWLZvMsH8RL2WAYfEUqiCt9pKnzhGmknRw,19611
-hubble_sdk/_webhooks.py,sha256=KVoGj9C4tTFiQWlXmNGHVXPNpAJN_Rc7_7RC1ogAsr0,7820
+hubble_sdk/_hubble.py,sha256=3c-G7xABewysK1TAJFxf0WipXeuVrbFU5WS1Li3Kucc,20027
+hubble_sdk/_webhooks.py,sha256=K3Zw3unBdTdiWSqZojBGniYpuTGxxMPRNNrCsBiYHUA,8111
 hubble_sdk/_generated/__init__.py,sha256=vHzWGo0njcFBcxGMOUuCWyhYdJi_xldILX7pdrPzdYA,168
 hubble_sdk/_generated/client.py,sha256=1T9SkCV9kmuiwOQqpXNCw9M1pQ94LV5q8FZGwuN0ftM,12438
 hubble_sdk/_generated/errors.py,sha256=gO8GBmKqmSNgAg-E5oT-oOyxztvp7V_6XG7OUTT15q0,546
 hubble_sdk/_generated/types.py,sha256=0We4NPvhIYASRpQ3le41nmJeEAVm42-2VKdzlJ4Ogok,1343
 hubble_sdk/_generated/api/__init__.py,sha256=zTSiG_ujSjAqWPyc435YXaX9XTlpMjiJWBbV-f-YtdA,45
 hubble_sdk/_generated/api/default/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
-hubble_sdk/_generated/api/default/attach_client_authorization.py,sha256=Mqohd4tNGI1pQQR07XFbOjyAKNdLgK6hK6essJvRozc,6357
+hubble_sdk/_generated/api/default/attach_client_authorization.py,sha256=S9ZCl4gtmeeQ47GM7t_H1Pn3fM6CkD3D6mE3aIo3h1w,8713
 hubble_sdk/_generated/api/default/create_consent_link.py,sha256=88KZtzq0cJ9hLZpNQqzpj2GjR0rmxzHTSWvqmMCGFW8,6377
 hubble_sdk/_generated/api/default/exchange_token.py,sha256=86ysMEnY2jOUItEHEv06zeszFe4k2vxjn4h0nzvR8zk,5268
 hubble_sdk/_generated/api/default/export_patient_fhir.py,sha256=1I6fJMmcuL2slxRt8FREc_Bve-g2p7NxyzAD6Um1Eoo,9683
@@ -20,37 +20,37 @@ hubble_sdk/_generated/api/default/revoke_consent.py,sha256=ocFu3svKMa-E2EKIPTE-J
 hubble_sdk/_generated/models/__init__.py,sha256=cctoHG7YlQTWWYpVmdyti-nNfoi3tu1T-GgCqWxsdWg,2781
 hubble_sdk/_generated/models/api_error.py,sha256=RrgLT6j31RWPbyMsgkFcu5DWaWi1aJooVL7C24gbGhw,780
 hubble_sdk/_generated/models/attach_client_authorization_body.py,sha256=ur71Z-fbahmKaJ0r68fkpAvaAM2ShtR1xc2ypqeNmAY,3475
-hubble_sdk/_generated/models/consent.py,sha256=L8MD23xqm0281lVWsicNxNJ2-VrjqjQmwZKNzFZ9TYI,3957
+hubble_sdk/_generated/models/consent.py,sha256=YDtOmOjYbUHdNKAD1JPTGYkLBdGGPCEvPI0nCvq9Eyc,4464
 hubble_sdk/_generated/models/consent_error.py,sha256=6FO1yRkKkpS7ENGBZeCExFqjugzhScYYDV-W9A4t47Y,1030
 hubble_sdk/_generated/models/consent_link_request.py,sha256=nYSsXg-JuheH6cc3Vbbhuk1bjcmEaYxf7Syvl5GAFmw,3589
 hubble_sdk/_generated/models/consent_list.py,sha256=YsZGsm7Ahh0bafpllLT1pf6pbkIK0yo4gpN5T0DjarM,1806
-hubble_sdk/_generated/models/consent_source.py,sha256=3keu_l3aeFbB7Jp9TA2rZ-j0Ta2VMpNT9-Xid4l1qUU,2121
-hubble_sdk/_generated/models/consent_source_status.py,sha256=MnK-9-Wk-HzJimGzPx3wnWWBKT2EQSE8xApqJflbxtI,223
-hubble_sdk/_generated/models/consent_source_type.py,sha256=WrGnwvsGo5yUtvp9j8v03ZCZv1D7YwcoCtnksJ9oxBk,167
-hubble_sdk/_generated/models/consent_status.py,sha256=BbCjYc8enJOaKB3Cl0itodYBl_2nfc_2LrD5CtxukMU,233
-hubble_sdk/_generated/models/device_authorization_request.py,sha256=OIV7GQffdF67wgO56pHs7Ms3RbPRjbrwvYLIh670T6c,6331
+hubble_sdk/_generated/models/consent_source.py,sha256=9Z9wl7ALBZD4ZkSV5BXLLtNMq15Nh0btPolLmSd30DE,2734
+hubble_sdk/_generated/models/consent_source_status.py,sha256=Tj-9hWgiEKmVFCqdbuiX4okhCGFR2JAAxkfcfObQ7Js,1125
+hubble_sdk/_generated/models/consent_source_type.py,sha256=lO5BJfcOHkvR2KF8crmMB1WkzEtZDMUostmG7ABTO-c,1065
+hubble_sdk/_generated/models/consent_status.py,sha256=5m-j-NNSYaxCTmQPAoMCW62wB-mpnh6v7RQ9iohAUHI,1123
+hubble_sdk/_generated/models/device_authorization_request.py,sha256=9YaJ6accYGReaEmffr1cbtjWWN9ePXhksu7vvl8Vsz8,6325
 hubble_sdk/_generated/models/device_authorization_response.py,sha256=LWsLmhthCw_eRO_DaYrVdFPR8XTU6ZfS95FZYR2-DrY,2627
-hubble_sdk/_generated/models/export_patient_fhir_prefer.py,sha256=Qsv7uGy3sdOGpt5A6oVHGYja1FawJXlcxkuUMZUTNlM,165
-hubble_sdk/_generated/models/export_patient_fhir_response_202.py,sha256=XsuDllyo9Fh-eScJba-nGaKlFlkP-8cdXBcu7F-WGWw,3177
-hubble_sdk/_generated/models/export_patient_fhir_response_202_status.py,sha256=ONDf5p1CasYu4qKsPL2jaIFkznmJkvVd6nPBOtod_2A,188
-hubble_sdk/_generated/models/export_patient_pdf_prefer.py,sha256=dR8xAgAA_NmXiyoGCx7rCqCdIt4oZTsL_HBEieqK1TY,164
-hubble_sdk/_generated/models/export_patient_pdf_response_202.py,sha256=INS109v8XEnbhcLnWNT8GA-_H82OLObuCRz70cZ78SM,3166
-hubble_sdk/_generated/models/export_patient_pdf_response_202_status.py,sha256=6OqzYSIJlidXM2VJP5Fq-kLnuP9lY8Pxmi8A-nwNtS0,187
+hubble_sdk/_generated/models/export_patient_fhir_prefer.py,sha256=cT0Bc-seiOxCYgnV47VV7iLOk5RU3rCkNzhXpyr_8V4,1075
+hubble_sdk/_generated/models/export_patient_fhir_response_202.py,sha256=2yfuuHHr6J0Ml9JnfLDEpxKkJAcAVP_f3GbTtoEdrxM,3189
+hubble_sdk/_generated/models/export_patient_fhir_response_202_status.py,sha256=5A344SfoyVesuQThsyYzG23BQcHHQGoKNZfEehDKoAo,1120
+hubble_sdk/_generated/models/export_patient_pdf_prefer.py,sha256=5MtaZ9h9XJyWZjRIJc0p7VUN43oODvnLWlCeDJfRGB8,1072
+hubble_sdk/_generated/models/export_patient_pdf_response_202.py,sha256=_XlYC28S8RSQAekleXjgsDxQoVLv_ssT2TS_8C9Pbts,3178
+hubble_sdk/_generated/models/export_patient_pdf_response_202_status.py,sha256=Yp2LfC78CweiQ-bGzmwDWV9oAjGW-WLe1dxzmuzgENI,1117
 hubble_sdk/_generated/models/fhir_resource.py,sha256=RWGpFkFgJVFdRleOKM8WTiFl4RFhM0wa_FjFVsaLvBI,1635
-hubble_sdk/_generated/models/get_patient_pdf_export_download.py,sha256=NvZbthx3mRdF5Eky95-_YxOIQjIEOktqdMrMnV-nqNU,151
-hubble_sdk/_generated/models/get_patient_pdf_export_response_200.py,sha256=MlMD7Kcj2vZCrDHsOWX2jfU9BQdCIJ901BKtLSFwxKk,3501
-hubble_sdk/_generated/models/get_patient_pdf_export_response_200_status.py,sha256=7xwGG5ST3sHI0CrBT_iBIhTVCAghZxGEXe-jcnZDFIw,162
-hubble_sdk/_generated/models/o_auth_error.py,sha256=mrAIGsI6Cxq1f_xHPXD53xwMS_OI6lEJZ_SXObpnmxc,1252
-hubble_sdk/_generated/models/o_auth_error_error.py,sha256=cHHuKnTHGQUD6lYvbTk4TqNCfKS-FDJtxdTsrz7wJ0k,475
+hubble_sdk/_generated/models/get_patient_pdf_export_download.py,sha256=rQLl2BwB6E1IeLdgTfkGPporcMmA_2sNrRyFfpzvNcg,1069
+hubble_sdk/_generated/models/get_patient_pdf_export_response_200.py,sha256=zg5M3CP8xsiTPCulRwtRo8Unv4sJCCd-82KXW8iCia4,3513
+hubble_sdk/_generated/models/get_patient_pdf_export_response_200_status.py,sha256=GjZMRlGGKsD6HUuYZhJVzCibIpbsJyyP9ph713PnQRk,1098
+hubble_sdk/_generated/models/o_auth_error.py,sha256=2KdLBi8X-S8YVxCcwfFDoTFgE6UwOrWLp-QgHh5c8Zk,1264
+hubble_sdk/_generated/models/o_auth_error_error.py,sha256=lUrrXD05v4YIA0HYtJF7-YZeqj6zBqbcRVy8XHSKRI8,1369
 hubble_sdk/_generated/models/operation_outcome.py,sha256=aOvD-g-BDTDyvqOcsgk_DQHI3DKAG8DwWfR3-hutqAM,1902
 hubble_sdk/_generated/models/operation_outcome_issue_item.py,sha256=wmV4n_E0880pwYchBbWH8f9PXRbR8atuzjK5Ep-54y0,1318
 hubble_sdk/_generated/models/patient_address.py,sha256=IvLI1X4e8kGXZQXbuvrFs1dUBOpU7SARDrOq9um-BdI,1890
 hubble_sdk/_generated/models/patient_demographics.py,sha256=igIRoU9SBKmnyEXjTJ_VIW-It19Z5y40Wn72wLZ6V5g,3000
-hubble_sdk/_generated/models/provider_seed.py,sha256=EmvivHxaDLQzl5H64FeZ86mUyTTxxUZB5KfFhhqm218,1133
-hubble_sdk/_generated/models/token_request.py,sha256=WTynarmq-ruTqI7_Vrq1PwV3cIz4PQWKL-BJJsjHax4,2391
-hubble_sdk/_generated/models/token_request_grant_type.py,sha256=3IvUBtKaAVbXB22VhY11G5QOv_FIQmUvu5SfYNCyrkk,272
+hubble_sdk/_generated/models/provider_seed.py,sha256=z7sUoCR2FSt4eN7Fi-B_8VmMy32jCGqSZaY6-iPUQ4Y,1678
+hubble_sdk/_generated/models/token_request.py,sha256=6gDAneGZQymGmK41_fpm0mwLoyz5kP_JokqWs-u0JRY,2403
+hubble_sdk/_generated/models/token_request_grant_type.py,sha256=B0M3WPS5YhXOc4Cc9ZQXId4pjCtFGYwZ-Aofz2Cq6fk,1178
 hubble_sdk/_generated/models/token_response.py,sha256=HORaPEpLNuPdCtGMlR-CXt8sQEYQH6gEp0gNTpQoFeE,2121
-hubble_sdk_python-0.2.0.dist-info/METADATA,sha256=4xZUmqBQvHIWkzNS0xgs3-cJPgM-D0-IsDVUj28vGmo,4947
-hubble_sdk_python-0.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-hubble_sdk_python-0.2.0.dist-info/licenses/LICENSE,sha256=S8zTUFi7pK2HOg-wSn6bFAWbNAO4Lt1UiyDu_vcqO6w,1063
-hubble_sdk_python-0.2.0.dist-info/RECORD,,
+hubble_sdk_python-0.2.1.dist-info/METADATA,sha256=9T2LKfeJnN60-T3yDFJ3mB6FP3WiUrzJqXo0HnO7NCY,4947
+hubble_sdk_python-0.2.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+hubble_sdk_python-0.2.1.dist-info/licenses/LICENSE,sha256=S8zTUFi7pK2HOg-wSn6bFAWbNAO4Lt1UiyDu_vcqO6w,1063
+hubble_sdk_python-0.2.1.dist-info/RECORD,,