usebridge-api 0.1.0__py3-none-any.whl

rtaylor_205/services/client.py

@@ -0,0 +1,796 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+
+import datetime as dt
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from .raw_client import AsyncRawServicesClient, RawServicesClient
+from .types.service_create_v_1_request_location import ServiceCreateV1RequestLocation
+from .types.service_create_v_1_request_metadata import ServiceCreateV1RequestMetadata
+from .types.service_create_v_1_request_responsible_party import ServiceCreateV1RequestResponsibleParty
+from .types.service_create_v_1_request_service_eligibility import ServiceCreateV1RequestServiceEligibility
+from .types.service_create_v_1_response import ServiceCreateV1Response
+from .types.service_get_v_1_response import ServiceGetV1Response
+from .types.service_note_get_v_1_response import ServiceNoteGetV1Response
+from .types.service_stream_v_1_response import ServiceStreamV1Response
+from .types.services_list_v_1_filter_provider_id import ServicesListV1FilterProviderId
+from .types.services_list_v_1_filter_status import ServicesListV1FilterStatus
+from .types.services_list_v_1_order_created_at import ServicesListV1OrderCreatedAt
+from .types.services_list_v_1_response import ServicesListV1Response
+
+if typing.TYPE_CHECKING:
+    from .payments.client import AsyncPaymentsClient, PaymentsClient
+    from .v_2.client import AsyncV2Client, V2Client
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class ServicesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawServicesClient(client_wrapper=client_wrapper)
+        self._client_wrapper = client_wrapper
+        self._payments: typing.Optional[PaymentsClient] = None
+        self._v_2: typing.Optional[V2Client] = None
+
+    @property
+    def with_raw_response(self) -> RawServicesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawServicesClient
+        """
+        return self._raw_client
+
+    def stream_service(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.Iterator[ServiceStreamV1Response]:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Yields
+        ------
+        typing.Iterator[ServiceStreamV1Response]
+
+        Examples
+        --------
+        from rtaylor_205 import BridgeApiClient
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        response = client.services.stream_service(
+            id="id",
+        )
+        for chunk in response:
+            yield chunk
+        """
+        with self._raw_client.stream_service(id, request_options=request_options) as r:
+            yield from r.data
+
+    def list_services(
+        self,
+        *,
+        filter_service_type_id: typing.Optional[str] = None,
+        filter_patient_id: typing.Optional[str] = None,
+        filter_status: typing.Optional[typing.Sequence[ServicesListV1FilterStatus]] = None,
+        filter_provider_id: typing.Optional[typing.Sequence[ServicesListV1FilterProviderId]] = None,
+        order_created_at: typing.Optional[ServicesListV1OrderCreatedAt] = None,
+        page: typing.Optional[int] = None,
+        limit: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ServicesListV1Response:
+        """
+        Parameters
+        ----------
+        filter_service_type_id : typing.Optional[str]
+            should be JSON-encoded, for example filter.serviceTypeId="svt_xxx"
+
+        filter_patient_id : typing.Optional[str]
+            should be JSON-encoded, for example filter.patientId="pat_xxx"
+
+        filter_status : typing.Optional[typing.Sequence[ServicesListV1FilterStatus]]
+            should be a JSON-encoded array, for example filter.status=["PENDING", "COMPLETE"]
+
+        filter_provider_id : typing.Optional[typing.Sequence[ServicesListV1FilterProviderId]]
+            should be JSON-encoded array, for example filter.providerId=["prv_xxx", "prv_yyy"]
+
+        order_created_at : typing.Optional[ServicesListV1OrderCreatedAt]
+
+        page : typing.Optional[int]
+
+        limit : typing.Optional[int]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServicesListV1Response
+
+        Examples
+        --------
+        from rtaylor_205 import BridgeApiClient
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.services.list_services()
+        """
+        _response = self._raw_client.list_services(
+            filter_service_type_id=filter_service_type_id,
+            filter_patient_id=filter_patient_id,
+            filter_status=filter_status,
+            filter_provider_id=filter_provider_id,
+            order_created_at=order_created_at,
+            page=page,
+            limit=limit,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def create_service(
+        self,
+        *,
+        patient_id: str,
+        date_of_service: dt.datetime,
+        service_type_id: str,
+        location: ServiceCreateV1RequestLocation,
+        provider_id: str,
+        external_id: typing.Optional[str] = OMIT,
+        service_eligibility: typing.Optional[ServiceCreateV1RequestServiceEligibility] = OMIT,
+        prior_authorization_number: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[ServiceCreateV1RequestMetadata] = OMIT,
+        responsible_party: typing.Optional[ServiceCreateV1RequestResponsibleParty] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ServiceCreateV1Response:
+        """
+        Parameters
+        ----------
+        patient_id : str
+
+        date_of_service : dt.datetime
+            Full ISO8601 timestamp, including timezone
+
+        service_type_id : str
+
+        location : ServiceCreateV1RequestLocation
+            Location of the Patient at the date of service, requires only the `state` value for telehealth
+
+        provider_id : str
+
+        external_id : typing.Optional[str]
+
+        service_eligibility : typing.Optional[ServiceCreateV1RequestServiceEligibility]
+
+        prior_authorization_number : typing.Optional[str]
+
+        metadata : typing.Optional[ServiceCreateV1RequestMetadata]
+            Customizable object of string to string key-value data
+
+        responsible_party : typing.Optional[ServiceCreateV1RequestResponsibleParty]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServiceCreateV1Response
+
+        Examples
+        --------
+        import datetime
+
+        from rtaylor_205 import BridgeApiClient
+        from rtaylor_205.services import ServiceCreateV1RequestLocation
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.services.create_service(
+            patient_id="patientId",
+            date_of_service=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            service_type_id="serviceTypeId",
+            location=ServiceCreateV1RequestLocation(
+                state="AL",
+            ),
+            provider_id="providerId",
+        )
+        """
+        _response = self._raw_client.create_service(
+            patient_id=patient_id,
+            date_of_service=date_of_service,
+            service_type_id=service_type_id,
+            location=location,
+            provider_id=provider_id,
+            external_id=external_id,
+            service_eligibility=service_eligibility,
+            prior_authorization_number=prior_authorization_number,
+            metadata=metadata,
+            responsible_party=responsible_party,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def get_service(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> ServiceGetV1Response:
+        """
+        Fetch a Service by `id` or `externalId`
+
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServiceGetV1Response
+
+        Examples
+        --------
+        from rtaylor_205 import BridgeApiClient
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.services.get_service(
+            id="id",
+        )
+        """
+        _response = self._raw_client.get_service(id, request_options=request_options)
+        return _response.data
+
+    def revalidate_service(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from rtaylor_205 import BridgeApiClient
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.services.revalidate_service(
+            id="id",
+        )
+        """
+        _response = self._raw_client.revalidate_service(id, request_options=request_options)
+        return _response.data
+
+    def bill_service(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from rtaylor_205 import BridgeApiClient
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.services.bill_service(
+            id="id",
+        )
+        """
+        _response = self._raw_client.bill_service(id, request_options=request_options)
+        return _response.data
+
+    def get_service_note(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> ServiceNoteGetV1Response:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServiceNoteGetV1Response
+
+        Examples
+        --------
+        from rtaylor_205 import BridgeApiClient
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.services.get_service_note(
+            id="id",
+        )
+        """
+        _response = self._raw_client.get_service_note(id, request_options=request_options)
+        return _response.data
+
+    def delete_service_note(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from rtaylor_205 import BridgeApiClient
+
+        client = BridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+        client.services.delete_service_note(
+            id="id",
+        )
+        """
+        _response = self._raw_client.delete_service_note(id, request_options=request_options)
+        return _response.data
+
+    @property
+    def payments(self):
+        if self._payments is None:
+            from .payments.client import PaymentsClient  # noqa: E402
+
+            self._payments = PaymentsClient(client_wrapper=self._client_wrapper)
+        return self._payments
+
+    @property
+    def v_2(self):
+        if self._v_2 is None:
+            from .v_2.client import V2Client  # noqa: E402
+
+            self._v_2 = V2Client(client_wrapper=self._client_wrapper)
+        return self._v_2
+
+
+class AsyncServicesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawServicesClient(client_wrapper=client_wrapper)
+        self._client_wrapper = client_wrapper
+        self._payments: typing.Optional[AsyncPaymentsClient] = None
+        self._v_2: typing.Optional[AsyncV2Client] = None
+
+    @property
+    def with_raw_response(self) -> AsyncRawServicesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawServicesClient
+        """
+        return self._raw_client
+
+    async def stream_service(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.AsyncIterator[ServiceStreamV1Response]:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Yields
+        ------
+        typing.AsyncIterator[ServiceStreamV1Response]
+
+        Examples
+        --------
+        import asyncio
+
+        from rtaylor_205 import AsyncBridgeApiClient
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            response = await client.services.stream_service(
+                id="id",
+            )
+            async for chunk in response:
+                yield chunk
+
+
+        asyncio.run(main())
+        """
+        async with self._raw_client.stream_service(id, request_options=request_options) as r:
+            async for _chunk in r.data:
+                yield _chunk
+
+    async def list_services(
+        self,
+        *,
+        filter_service_type_id: typing.Optional[str] = None,
+        filter_patient_id: typing.Optional[str] = None,
+        filter_status: typing.Optional[typing.Sequence[ServicesListV1FilterStatus]] = None,
+        filter_provider_id: typing.Optional[typing.Sequence[ServicesListV1FilterProviderId]] = None,
+        order_created_at: typing.Optional[ServicesListV1OrderCreatedAt] = None,
+        page: typing.Optional[int] = None,
+        limit: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ServicesListV1Response:
+        """
+        Parameters
+        ----------
+        filter_service_type_id : typing.Optional[str]
+            should be JSON-encoded, for example filter.serviceTypeId="svt_xxx"
+
+        filter_patient_id : typing.Optional[str]
+            should be JSON-encoded, for example filter.patientId="pat_xxx"
+
+        filter_status : typing.Optional[typing.Sequence[ServicesListV1FilterStatus]]
+            should be a JSON-encoded array, for example filter.status=["PENDING", "COMPLETE"]
+
+        filter_provider_id : typing.Optional[typing.Sequence[ServicesListV1FilterProviderId]]
+            should be JSON-encoded array, for example filter.providerId=["prv_xxx", "prv_yyy"]
+
+        order_created_at : typing.Optional[ServicesListV1OrderCreatedAt]
+
+        page : typing.Optional[int]
+
+        limit : typing.Optional[int]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServicesListV1Response
+
+        Examples
+        --------
+        import asyncio
+
+        from rtaylor_205 import AsyncBridgeApiClient
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.services.list_services()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list_services(
+            filter_service_type_id=filter_service_type_id,
+            filter_patient_id=filter_patient_id,
+            filter_status=filter_status,
+            filter_provider_id=filter_provider_id,
+            order_created_at=order_created_at,
+            page=page,
+            limit=limit,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def create_service(
+        self,
+        *,
+        patient_id: str,
+        date_of_service: dt.datetime,
+        service_type_id: str,
+        location: ServiceCreateV1RequestLocation,
+        provider_id: str,
+        external_id: typing.Optional[str] = OMIT,
+        service_eligibility: typing.Optional[ServiceCreateV1RequestServiceEligibility] = OMIT,
+        prior_authorization_number: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[ServiceCreateV1RequestMetadata] = OMIT,
+        responsible_party: typing.Optional[ServiceCreateV1RequestResponsibleParty] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ServiceCreateV1Response:
+        """
+        Parameters
+        ----------
+        patient_id : str
+
+        date_of_service : dt.datetime
+            Full ISO8601 timestamp, including timezone
+
+        service_type_id : str
+
+        location : ServiceCreateV1RequestLocation
+            Location of the Patient at the date of service, requires only the `state` value for telehealth
+
+        provider_id : str
+
+        external_id : typing.Optional[str]
+
+        service_eligibility : typing.Optional[ServiceCreateV1RequestServiceEligibility]
+
+        prior_authorization_number : typing.Optional[str]
+
+        metadata : typing.Optional[ServiceCreateV1RequestMetadata]
+            Customizable object of string to string key-value data
+
+        responsible_party : typing.Optional[ServiceCreateV1RequestResponsibleParty]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServiceCreateV1Response
+
+        Examples
+        --------
+        import asyncio
+        import datetime
+
+        from rtaylor_205 import AsyncBridgeApiClient
+        from rtaylor_205.services import ServiceCreateV1RequestLocation
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.services.create_service(
+                patient_id="patientId",
+                date_of_service=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                service_type_id="serviceTypeId",
+                location=ServiceCreateV1RequestLocation(
+                    state="AL",
+                ),
+                provider_id="providerId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_service(
+            patient_id=patient_id,
+            date_of_service=date_of_service,
+            service_type_id=service_type_id,
+            location=location,
+            provider_id=provider_id,
+            external_id=external_id,
+            service_eligibility=service_eligibility,
+            prior_authorization_number=prior_authorization_number,
+            metadata=metadata,
+            responsible_party=responsible_party,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def get_service(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> ServiceGetV1Response:
+        """
+        Fetch a Service by `id` or `externalId`
+
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServiceGetV1Response
+
+        Examples
+        --------
+        import asyncio
+
+        from rtaylor_205 import AsyncBridgeApiClient
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.services.get_service(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_service(id, request_options=request_options)
+        return _response.data
+
+    async def revalidate_service(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from rtaylor_205 import AsyncBridgeApiClient
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.services.revalidate_service(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.revalidate_service(id, request_options=request_options)
+        return _response.data
+
+    async def bill_service(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from rtaylor_205 import AsyncBridgeApiClient
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.services.bill_service(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.bill_service(id, request_options=request_options)
+        return _response.data
+
+    async def get_service_note(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> ServiceNoteGetV1Response:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ServiceNoteGetV1Response
+
+        Examples
+        --------
+        import asyncio
+
+        from rtaylor_205 import AsyncBridgeApiClient
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.services.get_service_note(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_service_note(id, request_options=request_options)
+        return _response.data
+
+    async def delete_service_note(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from rtaylor_205 import AsyncBridgeApiClient
+
+        client = AsyncBridgeApiClient(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.services.delete_service_note(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.delete_service_note(id, request_options=request_options)
+        return _response.data
+
+    @property
+    def payments(self):
+        if self._payments is None:
+            from .payments.client import AsyncPaymentsClient  # noqa: E402
+
+            self._payments = AsyncPaymentsClient(client_wrapper=self._client_wrapper)
+        return self._payments
+
+    @property
+    def v_2(self):
+        if self._v_2 is None:
+            from .v_2.client import AsyncV2Client  # noqa: E402
+
+            self._v_2 = AsyncV2Client(client_wrapper=self._client_wrapper)
+        return self._v_2