helix.fhir.client.sdk 4.2.9__py3-none-any.whl → 4.2.11__py3-none-any.whl

helix_fhir_client_sdk/fhir_merge_resources_mixin.py

@@ -119,8 +119,6 @@ class FhirMergeResourcesMixin(FhirClientProtocol):
                 access_token=self._access_token,
                 access_token_expiry_date=self._access_token_expiry_date,
                 persistent_session=self._persistent_session,
-                use_persistent_session=self._use_persistent_session,
-                close_session_on_exit=self._close_session,
             ) as client:
                 http_post_start = time.time()
                 response: RetryableAioHttpResponse = await client.post(

{helix_fhir_client_sdk-4.2.9.dist-info → helix_fhir_client_sdk-4.2.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helix.fhir.client.sdk
-Version: 4.2.9
+Version: 4.2.11
 Summary: helix.fhir.client.sdk
 Home-page: https://github.com/icanbwell/helix.fhir.client.sdk
 Author: Imran Qureshi

{helix_fhir_client_sdk-4.2.9.dist-info → helix_fhir_client_sdk-4.2.11.dist-info}/RECORD

@@ -6,7 +6,7 @@ helix_fhir_client_sdk/fhir_bundle_appender.py,sha256=t1hs7p_vXKC9MUFyUnN9dTuDhRF
 helix_fhir_client_sdk/fhir_client.py,sha256=vSkgWVgNlRkdu7RFPkD1-4BF9N88PnRXhCTSqUJqHlI,34930
 helix_fhir_client_sdk/fhir_delete_mixin.py,sha256=1YiKddTJTUzzrRvG7WgSisXY8rfJAHPAEXTsOevrom8,6521
 helix_fhir_client_sdk/fhir_merge_mixin.py,sha256=YTUODvc2rqXhk5_kwNMFPykm1I9_omww2WUcDExMESg,15264
-helix_fhir_client_sdk/fhir_merge_resources_mixin.py,sha256=GsVeqcYpDvV5oeNbwyHS5YQozAyayICNcIRTQTRcrY0,36130
+helix_fhir_client_sdk/fhir_merge_resources_mixin.py,sha256=d5x41uL__yxMcaAnYDdmbpt529ZsOZcO0EBvnV1HSGI,36002
 helix_fhir_client_sdk/fhir_patch_mixin.py,sha256=YGcCPStoqVxWCYOaNI8vCKSFkAyRzP0YM_UWp4UKYro,5858
 helix_fhir_client_sdk/fhir_update_mixin.py,sha256=7psQTBsGPY1izuwn3yD4MGLjLVWQjqA_15_IeaUspew,6230
 helix_fhir_client_sdk/function_types.py,sha256=x95j6ix3Xa9b276Q741xX1jguqBuFT6EBLDw35_EoVM,3916
@@ -130,7 +130,7 @@ helix_fhir_client_sdk/validators/async_fhir_validator.py,sha256=Bgiw5atbc5YzBYpk
 helix_fhir_client_sdk/validators/fhir_validator.py,sha256=HWBldSEB9yeKIcnLcV8R-LoTzwT_OMu8SchtUUBKzys,2331
 helix_fhir_client_sdk/validators/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 helix_fhir_client_sdk/validators/test/test_async_fhir_validator.py,sha256=RmSowjPUdZee5nYuYujghxWyqJ20cu7U0lJFtFT-ZBs,3285
-helix_fhir_client_sdk-4.2.9.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+helix_fhir_client_sdk-4.2.11.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/logger_for_test.py,sha256=UC-7F6w6fDsUIYf37aRnvUdiUUVk8qkJEUSuO17NQnI,1525
 tests/test_fhir_client_clone.py,sha256=ZjC0ctog5r8Ba0ZD94ggwbnbQMeQdxk5pTt3zTpE8rQ,2832
@@ -152,6 +152,7 @@ tests/async/test_async_fhir_client_patient_update.py,sha256=Q-hNO9D4FZ_r7oa62pyB
 tests/async/test_async_real_fhir_server_get_patients.py,sha256=0oMnUJg1KEspJ5_4eBen8z12Ion5HXv-gKAzFAkyII0,3837
 tests/async/test_async_real_fhir_server_get_patients_error.py,sha256=_s7chLogAg0yKgGpsq1o9_dDHBrzGaRWBAo8agFTN6U,1914
 tests/async/test_benchmark_compress.py,sha256=q1gDG7qXvof-3uVAqJlZAW7uO8cR0vEeDfzl-iwIEtY,16470
+tests/async/test_benchmark_merge.py,sha256=ME0Pow_IXpIaVGWvq3ii7dGltXcz-3DGxz2gGF4LmYQ,19830
 tests/async/fhir_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/async/fhir_server/test_async_real_fhir_server_get_graph_large.py,sha256=fM2MPF47nDF2Qwj2AkdTZ2CfvgUYGN4AVIS253KC9MQ,9430
 tests/async/fhir_server/test_async_real_fhir_server_get_patients_large.py,sha256=rXRF8E8Al7XANCmef1d_WqxSA9TVQjVC7B41OZaEQlY,5583
@@ -211,7 +212,7 @@ tests_integration/test_emr_server_auth.py,sha256=2I4QUAspQN89uGf6JB2aVuYaBeDnRJz
 tests_integration/test_firely_fhir.py,sha256=ll6-plwQrKfdrEyfbw0wLTC1jB-Qei1Mj-81tYTl5eQ,697
 tests_integration/test_merge_vs_smart_merge_behavior.py,sha256=LrIuyxzw0YLaTjcRtG0jzy0M6xSv9qebmdBtMPDcacQ,3733
 tests_integration/test_staging_server_graph.py,sha256=5RfMxjhdX9o4-n_ZRvze4Sm8u8NjRijRLDpqiz8qD_0,7132
-helix_fhir_client_sdk-4.2.9.dist-info/METADATA,sha256=e-ajvH1vdbrt84TIgYqnldqWv9RzfHeuyzgSURayZyk,5841
-helix_fhir_client_sdk-4.2.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-helix_fhir_client_sdk-4.2.9.dist-info/top_level.txt,sha256=BRnDS6ceQxs-4u2jXznATObgP8G2cGAerlH0ZS4sJ6M,46
-helix_fhir_client_sdk-4.2.9.dist-info/RECORD,,
+helix_fhir_client_sdk-4.2.11.dist-info/METADATA,sha256=VunX8xH3c-NbVsUU9tEISnIRudlQaS7QfOB1CeYf2G8,5842
+helix_fhir_client_sdk-4.2.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+helix_fhir_client_sdk-4.2.11.dist-info/top_level.txt,sha256=BRnDS6ceQxs-4u2jXznATObgP8G2cGAerlH0ZS4sJ6M,46
+helix_fhir_client_sdk-4.2.11.dist-info/RECORD,,

tests/async/test_benchmark_merge.py

@@ -0,0 +1,506 @@
+"""
+Benchmark tests for comparing compressed vs uncompressed FHIR client merge operations.
+
+These tests measure the performance of:
+- merge_async() with compress=True vs compress=False
+
+=============================================================================
+HOW TO RUN THESE TESTS
+=============================================================================
+
+1. Start services using docker-compose:
+   docker-compose up -d mock-server
+
+2. First time only - rebuild dev container to include pytest-benchmark:
+   docker-compose build dev
+
+   OR install pytest-benchmark in the running container:
+   docker-compose run --rm dev pip install pytest-benchmark
+
+3. Run benchmark tests inside docker container:
+   docker-compose run --rm dev pytest tests/async/test_benchmark_merge.py -v --benchmark-only
+
+4. Or run all benchmark variations:
+   docker-compose run --rm dev pytest tests/async/test_benchmark_merge.py -v --benchmark-only --benchmark-group-by=func
+
+5. Save benchmark results for comparison:
+   docker-compose run --rm dev pytest tests/async/test_benchmark_merge.py -v --benchmark-autosave
+
+6. Compare with previous runs:
+   docker-compose run --rm dev pytest tests/async/test_benchmark_merge.py -v --benchmark-compare
+
+7. Run with more iterations for accuracy:
+   docker-compose run --rm dev pytest tests/async/test_benchmark_merge.py -v --benchmark-min-rounds=10
+
+8. To stop mock-server:
+   docker-compose down mock-server
+
+=============================================================================
+"""
+
+import asyncio
+import json
+import socket
+from typing import Any
+
+import pytest
+from mockserver_client.mockserver_client import (
+    MockServerFriendlyClient,
+    mock_request,
+    mock_response,
+    times,
+)
+
+from helix_fhir_client_sdk.fhir_client import FhirClient
+from helix_fhir_client_sdk.responses.fhir_merge_response import FhirMergeResponse
+
+
+def is_mock_server_running(host: str = "mock-server", port: int = 1080) -> bool:
+    """Check if mock-server is reachable."""
+    try:
+        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        sock.settimeout(2)
+        result = sock.connect_ex((host, port))
+        sock.close()
+        return result == 0
+    except OSError:
+        return False
+
+
+# Skip all tests if the mock-server is not running
+pytestmark = pytest.mark.skipif(
+    not is_mock_server_running(), reason="Mock server not running. Start with: docker-compose up -d mock-server"
+)
+
+
+def generate_patient_resource(index: int) -> dict[str, Any]:
+    """Generate a realistic FHIR Patient resource."""
+    return {
+        "resourceType": "Patient",
+        "id": f"patient-{index}",
+        "meta": {
+            "versionId": "1",
+            "lastUpdated": "2025-01-15T10:30:00.000Z",
+            "source": "http://example.org/fhir",
+            "profile": ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"],
+        },
+        "identifier": [
+            {
+                "use": "official",
+                "type": {
+                    "coding": [
+                        {
+                            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
+                            "code": "MR",
+                            "display": "Medical Record Number",
+                        }
+                    ]
+                },
+                "system": "http://hospital.example.org/mrn",
+                "value": f"MRN-{index:08d}",
+            },
+            {
+                "use": "official",
+                "type": {
+                    "coding": [
+                        {
+                            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
+                            "code": "SS",
+                            "display": "Social Security Number",
+                        }
+                    ]
+                },
+                "system": "http://hl7.org/fhir/sid/us-ssn",
+                "value": f"{100 + index:03d}-{50 + index:02d}-{1000 + index:04d}",
+            },
+        ],
+        "active": True,
+        "name": [
+            {
+                "use": "official",
+                "family": f"TestFamily{index}",
+                "given": [f"TestGiven{index}", f"MiddleName{index}"],
+                "prefix": ["Mr."],
+                "suffix": ["Jr."],
+            },
+            {
+                "use": "nickname",
+                "given": [f"Nick{index}"],
+            },
+        ],
+        "telecom": [
+            {"system": "phone", "value": f"555-{100 + index:03d}-{1000 + index:04d}", "use": "home"},
+            {"system": "phone", "value": f"555-{200 + index:03d}-{2000 + index:04d}", "use": "mobile"},
+            {"system": "email", "value": f"patient{index}@example.com", "use": "home"},
+        ],
+        "gender": "male" if index % 2 == 0 else "female",
+        "birthDate": f"{1950 + (index % 50)}-{(index % 12) + 1:02d}-{(index % 28) + 1:02d}",
+        "deceasedBoolean": False,
+        "address": [
+            {
+                "use": "home",
+                "type": "physical",
+                "line": [f"{100 + index} Main Street", f"Apt {index}"],
+                "city": "Boston",
+                "state": "MA",
+                "postalCode": f"02{100 + (index % 900):03d}",
+                "country": "USA",
+            },
+            {
+                "use": "work",
+                "type": "postal",
+                "line": [f"{200 + index} Business Ave"],
+                "city": "Cambridge",
+                "state": "MA",
+                "postalCode": f"02{200 + (index % 800):03d}",
+                "country": "USA",
+            },
+        ],
+        "maritalStatus": {
+            "coding": [
+                {
+                    "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
+                    "code": "M" if index % 2 == 0 else "S",
+                    "display": "Married" if index % 2 == 0 else "Never Married",
+                }
+            ]
+        },
+        "communication": [
+            {
+                "language": {
+                    "coding": [
+                        {
+                            "system": "urn:ietf:bcp:47",
+                            "code": "en-US",
+                            "display": "English (United States)",
+                        }
+                    ]
+                },
+                "preferred": True,
+            }
+        ],
+        "generalPractitioner": [{"reference": f"Practitioner/practitioner-{index % 10}"}],
+        "managingOrganization": {"reference": "Organization/org-1"},
+    }
+
+
+def generate_patient_resources_list(count: int) -> list[dict[str, Any]]:
+    """Generate a list of FHIR Patient resources."""
+    return [generate_patient_resource(i) for i in range(count)]
+
+
+def generate_merge_response(count: int) -> list[dict[str, Any]]:
+    """Generate a merge response for the given count of resources."""
+    return [{"created": 1, "updated": 0} for _ in range(count)]
+
+
+@pytest.fixture(scope="module")
+def mock_server_url() -> str:
+    return "http://mock-server:1080"
+
+
+@pytest.fixture(scope="module")
+def mock_client(mock_server_url: str) -> MockServerFriendlyClient:
+    return MockServerFriendlyClient(base_url=mock_server_url)
+
+
+@pytest.fixture(scope="module")
+def setup_mock_merge_endpoints(mock_client: MockServerFriendlyClient, mock_server_url: str) -> str:
+    """Set up mock endpoints for merge operations with different payload sizes."""
+    test_name = "benchmark_merge"
+
+    mock_client.clear(f"/{test_name}/*.*")
+    mock_client.reset()
+
+    # Create payloads of different sizes for benchmarking
+    payload_sizes = {
+        "small": 10,  # 10 patients
+        "medium": 100,  # 100 patients
+        "large": 500,  # 500 patients
+    }
+
+    # Setup mock endpoints for each payload size - using regex to match any request body
+    for size, count in payload_sizes.items():
+        response_body = json.dumps(generate_merge_response(count))
+
+        # Endpoint for POST /Patient/1/$merge (single resource merge)
+        mock_client.expect(
+            request=mock_request(
+                path=f"/{test_name}/{size}/Patient/1/$merge",
+                method="POST",
+            ),
+            response=mock_response(body=response_body),
+            timing=times(10000),  # Allow many requests for benchmarking
+        )
+
+        # Endpoint for POST /Patient/$merge (batch merge)
+        mock_client.expect(
+            request=mock_request(
+                path=f"/{test_name}/{size}/Patient/$merge",
+                method="POST",
+            ),
+            response=mock_response(body=response_body),
+            timing=times(10000),
+        )
+
+    return f"{mock_server_url}/{test_name}"
+
+
+# ============================================================================
+# Benchmark Tests for merge_async() - Small Payload (10 patients)
+# ============================================================================
+
+
+def test_benchmark_merge_async_compress_false_small(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark merge_async with compress=False and small payload (10 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/small"
+    resources = generate_patient_resources_list(10)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(False)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(id_="1", json_data_list=json_data_list)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_merge_async_compress_true_small(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark merge_async with compress=True and small payload (10 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/small"
+    resources = generate_patient_resources_list(10)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(True)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(id_="1", json_data_list=json_data_list)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+# ============================================================================
+# Benchmark Tests for merge_async() - Medium Payload (100 patients)
+# ============================================================================
+
+
+def test_benchmark_merge_async_compress_false_medium(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark merge_async with compress=False and medium payload (100 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/medium"
+    resources = generate_patient_resources_list(100)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(False)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(id_="1", json_data_list=json_data_list)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_merge_async_compress_true_medium(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark merge_async with compress=True and medium payload (100 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/medium"
+    resources = generate_patient_resources_list(100)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(True)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(id_="1", json_data_list=json_data_list)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+# ============================================================================
+# Benchmark Tests for merge_async() - Large Payload (500 patients)
+# ============================================================================
+
+
+def test_benchmark_merge_async_compress_false_large(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark merge_async with compress=False and large payload (500 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/large"
+    resources = generate_patient_resources_list(500)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(False)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(id_="1", json_data_list=json_data_list)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_merge_async_compress_true_large(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark merge_async with compress=True and large payload (500 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/large"
+    resources = generate_patient_resources_list(500)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(True)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(id_="1", json_data_list=json_data_list)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+# ============================================================================
+# Benchmark Tests for batch merge_async() - Multiple resources in single call
+# ============================================================================
+
+
+def test_benchmark_batch_merge_async_compress_false_small(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark batch merge_async with compress=False and small payload (10 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/small"
+    resources = generate_patient_resources_list(10)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(False)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(json_data_list=json_data_list, batch_size=10)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_batch_merge_async_compress_true_small(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark batch merge_async with compress=True and small payload (10 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/small"
+    resources = generate_patient_resources_list(10)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(True)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(json_data_list=json_data_list, batch_size=10)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_batch_merge_async_compress_false_medium(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark batch merge_async with compress=False and medium payload (100 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/medium"
+    resources = generate_patient_resources_list(100)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(False)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(json_data_list=json_data_list, batch_size=50)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_batch_merge_async_compress_true_medium(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark batch merge_async with compress=True and medium payload (100 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/medium"
+    resources = generate_patient_resources_list(100)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(True)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(json_data_list=json_data_list, batch_size=50)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_batch_merge_async_compress_false_large(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark batch merge_async with compress=False and large payload (500 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/large"
+    resources = generate_patient_resources_list(500)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(False)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(json_data_list=json_data_list, batch_size=100)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None
+
+
+def test_benchmark_batch_merge_async_compress_true_large(benchmark: Any, setup_mock_merge_endpoints: str) -> None:
+    """Benchmark batch merge_async with compress=True and large payload (500 patients)."""
+    base_url = f"{setup_mock_merge_endpoints}/large"
+    resources = generate_patient_resources_list(500)
+    json_data_list = [json.dumps(r) for r in resources]
+
+    async def run_merge_async() -> FhirMergeResponse | None:
+        fhir_client = FhirClient().url(base_url).resource("Patient")
+        fhir_client = fhir_client.compress(True)
+        return await FhirMergeResponse.from_async_generator(
+            fhir_client.merge_async(json_data_list=json_data_list, batch_size=100)
+        )
+
+    def run_sync() -> FhirMergeResponse | None:
+        return asyncio.run(run_merge_async())
+
+    result = benchmark(run_sync)
+    assert result is not None