hubble-sdk-python 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

hubble_sdk/_hubble.py

@@ -132,6 +132,19 @@ def _require_fhir_namespace(base_url: str, url: httpx.URL, shown: str) -> None:
         raise HubbleError(f"Invalid FHIR path: {shown!r}")
 
 
+def _pdf_export_url(
+    base_url: str, connection: str | None, version: str | None, combined: bool
+) -> httpx.URL:
+    if combined and (not version or not connection):
+        raise HubbleError("A combined PDF requires version and connection.")
+    url = _fhir_url(base_url, "Patient/$pdf")
+    if connection is not None:
+        url = url.copy_set_param("connection", connection)
+    if combined:
+        url = url.copy_set_param("combined", "true")
+    return url
+
+
 def _pdf_export(
     resp: httpx.Response, file: httpx.Response | None = None, version: str | None = None
 ) -> PdfExport:
@@ -330,6 +343,7 @@ class Hubble:
         *,
         connection: str | None = None,
         version: str | None = None,
+        combined: bool = False,
         timeout: float = _EXPORT_TIMEOUT,
     ) -> PdfExport:
         """The patient's records as PDF via ``Patient/$pdf``: a ZIP of per-source
@@ -337,10 +351,10 @@ class Hubble:
 
         Pass ``version`` (a ``Hubble-Version``, such as ``"2026-11-01"``) for that
         version's export instead. It is built in the background, so this waits up
-        to ``timeout`` seconds for it, then downloads it."""
-        url = _fhir_url(self.base_url, "Patient/$pdf")
-        if connection is not None:
-            url = url.copy_set_param("connection", connection)
+        to ``timeout`` seconds for it, then downloads it. Set ``combined=True``
+        with ``version`` and ``connection`` for one PDF containing that source's
+        summary and documents instead of the archive. Defaults to false."""
+        url = _pdf_export_url(self.base_url, connection, version, combined)
         if version is None:
             return _pdf_export(self._consent_get(consent_id, url, None))
         return _versioned_pdf_export(
@@ -676,6 +690,7 @@ class PatientSession:
         *,
         connection: str | None = None,
         version: str | None = None,
+        combined: bool = False,
         timeout: float = _EXPORT_TIMEOUT,
     ) -> PdfExport:
         """Export the patient's records as PDF via ``Patient/$pdf``.
@@ -689,11 +704,11 @@ class PatientSession:
 
         Pass ``version`` (a ``Hubble-Version``, such as ``"2026-11-01"``) for that
         version's export instead. It is built in the background, so this waits up
-        to ``timeout`` seconds for it, then downloads it."""
+        to ``timeout`` seconds for it, then downloads it. Set ``combined=True``
+        with ``version`` and ``connection`` for one PDF containing that source's
+        summary and documents instead of the archive. Defaults to false."""
         retry = self.refresh_token is not None
-        url = _fhir_url(self._hubble.base_url, "Patient/$pdf")
-        if connection is not None:
-            url = url.copy_set_param("connection", connection)
+        url = _pdf_export_url(self._hubble.base_url, connection, version, combined)
         if version is None:
             return _pdf_export(self._fhir_request(url, retry))
         return _versioned_pdf_export(
@@ -779,8 +794,8 @@ class PdfExport:
     ``content`` is the raw body — a ZIP of per-source PDFs (with a
     ``manifest.json`` naming each file and marking it complete/partial/failed),
     or a single PDF when ``connection`` was set. With a ``version``, it is that
-    version's export, described in the API reference. The counts come from the
-    response headers; a non-zero ``sources_failed`` means some records are
+    version's archive, or one PDF if ``combined=True`` was requested. The counts
+    come from the response headers; a non-zero ``sources_failed`` means some records are
     missing. ``version`` is the ``Hubble-Version`` served, or ``None`` when none
     was asked for."""
 

{hubble_sdk_python-0.3.1.dist-info → hubble_sdk_python-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: hubble-sdk-python
-Version: 0.3.1
+Version: 0.3.2
 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
@@ -81,6 +81,27 @@ export = hub.export_pdf(consent_id, connection=connection_id)         # one sour
 
 Reuse one `Hubble` client so its token is reused too.
 
+### Combined PDF exports
+
+Pass `version`, `connection`, and `combined=True` to download one PDF containing
+the source's summary and documents. The helper requests background generation,
+waits for completion, and downloads the file.
+
+```python
+export = hub.export_pdf(
+    consent_id,
+    version="2026-11-01",
+    connection=connection_id,
+    combined=True,
+)
+# export.content contains the PDF bytes; export.content_type is "application/pdf".
+```
+
+`session.export_pdf` accepts the same options without the consent ID. With a
+version and `combined` omitted or false, the result is a records archive (ZIP).
+Calls without a version keep their existing behavior. `timeout` controls the
+wait for background generation in seconds and defaults to ten minutes.
+
 ### The device flow
 
 Existing integrations can keep using the device flow, which waits for the

{hubble_sdk_python-0.3.1.dist-info → hubble_sdk_python-0.3.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 hubble_sdk/__init__.py,sha256=ZWHqgD53YvB-IHk4GT26Z9J6IZGd-OdmjraHePXDcj4,1789
-hubble_sdk/_hubble.py,sha256=AYmB5S2c1BrRSUDOihL7y6pajfQl6OztIH1vLMwYbio,35452
+hubble_sdk/_hubble.py,sha256=PYtitUsIX0kYIRthJZMlUgT8w792a9TsuinfArCm8fU,36199
 hubble_sdk/_params.py,sha256=CeR3ksQk2QOoRAFmy8Pu1kGICcrBQ_wnOLpo9Yfiwlo,3046
 hubble_sdk/_webhooks.py,sha256=5luPbiJwfozo7q1t95oyWGnphZhtlW27RpuHviuGMJI,8150
 hubble_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -66,7 +66,7 @@ hubble_sdk/_generated/models/provider_seed.py,sha256=H-OqWFvhcwwp9dNMsYDlAQdk_LN
 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.3.1.dist-info/METADATA,sha256=_pH56Dgap96l6aoVguNiZyBsM_z5w3ahV4gHHqCGyhY,6231
-hubble_sdk_python-0.3.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-hubble_sdk_python-0.3.1.dist-info/licenses/LICENSE,sha256=S8zTUFi7pK2HOg-wSn6bFAWbNAO4Lt1UiyDu_vcqO6w,1063
-hubble_sdk_python-0.3.1.dist-info/RECORD,,
+hubble_sdk_python-0.3.2.dist-info/METADATA,sha256=fNKv0Xm1G2x1Ck-1Y6bpbzvhrvIF7mn0i1TyT7_Iri4,6986
+hubble_sdk_python-0.3.2.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+hubble_sdk_python-0.3.2.dist-info/licenses/LICENSE,sha256=S8zTUFi7pK2HOg-wSn6bFAWbNAO4Lt1UiyDu_vcqO6w,1063
+hubble_sdk_python-0.3.2.dist-info/RECORD,,