# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

from __future__ import annotations

import os
from typing import TYPE_CHECKING, Any, Mapping
from typing_extensions import Self, override

import httpx

from . import _exceptions
from ._qs import Querystring
from ._types import (
    Omit,
    Timeout,
    NotGiven,
    Transport,
    ProxiesTypes,
    RequestOptions,
    not_given,
)
from ._utils import is_given, get_async_library
from ._compat import cached_property
from ._version import __version__
from ._streaming import Stream as Stream, AsyncStream as AsyncStream
from ._exceptions import APIStatusError
from ._base_client import (
    DEFAULT_MAX_RETRIES,
    SyncAPIClient,
    AsyncAPIClient,
)

if TYPE_CHECKING:
    from .resources import member, account, contact, opportunity, workflow_run
    from .resources.member import MemberResource, AsyncMemberResource
    from .resources.account import AccountResource, AsyncAccountResource
    from .resources.contact import ContactResource, AsyncContactResource
    from .resources.opportunity import OpportunityResource, AsyncOpportunityResource
    from .resources.workflow_run import WorkflowRunResource, AsyncWorkflowRunResource

__all__ = [
    "Timeout",
    "Transport",
    "ProxiesTypes",
    "RequestOptions",
    "Lightfield",
    "AsyncLightfield",
    "Client",
    "AsyncClient",
]


class Lightfield(SyncAPIClient):
    # client options
    api_key: str

    def __init__(
        self,
        *,
        api_key: str,
        base_url: str | httpx.URL | None = None,
        timeout: float | Timeout | None | NotGiven = not_given,
        max_retries: int = DEFAULT_MAX_RETRIES,
        default_headers: Mapping[str, str] | None = None,
        default_query: Mapping[str, object] | None = None,
        # Configure a custom httpx client.
        # We provide a `DefaultHttpxClient` class that you can pass to retain the default values we use for `limits`, `timeout` & `follow_redirects`.
        # See the [httpx documentation](https://www.python-httpx.org/api/#client) for more details.
        http_client: httpx.Client | None = None,
        # Enable or disable schema validation for data returned by the API.
        # When enabled an error APIResponseValidationError is raised
        # if the API responds with invalid data for the expected schema.
        #
        # This parameter may be removed or changed in the future.
        # If you rely on this feature, please open a GitHub issue
        # outlining your use-case to help us decide if it should be
        # part of our public interface in the future.
        _strict_response_validation: bool = False,
    ) -> None:
        """Construct a new synchronous Lightfield client instance."""
        self.api_key = api_key

        if base_url is None:
            base_url = os.environ.get("LIGHTFIELD_BASE_URL")
        if base_url is None:
            base_url = f"https://api.lightfield.app"

        super().__init__(
            version=__version__,
            base_url=base_url,
            max_retries=max_retries,
            timeout=timeout,
            http_client=http_client,
            custom_headers=default_headers,
            custom_query=default_query,
            _strict_response_validation=_strict_response_validation,
        )

    @cached_property
    def account(self) -> AccountResource:
        """Accounts represent companies or organizations in Lightfield.

        Each account can have contacts, opportunities, tasks, and notes associated with it.
        """
        from .resources.account import AccountResource

        return AccountResource(self)

    @cached_property
    def contact(self) -> ContactResource:
        """Contacts represent individual people in Lightfield.

        Contacts can be associated with one or more accounts.
        """
        from .resources.contact import ContactResource

        return ContactResource(self)

    @cached_property
    def opportunity(self) -> OpportunityResource:
        """Opportunities represent potential deals or sales in Lightfield.

        Each opportunity belongs to an account and can have tasks and notes associated with it.
        """
        from .resources.opportunity import OpportunityResource

        return OpportunityResource(self)

    @cached_property
    def member(self) -> MemberResource:
        """Members represent users in your Lightfield workspace.

        Members can own accounts and opportunities, and are referenced in relationships like `$owner` and `$createdBy`.
        """
        from .resources.member import MemberResource

        return MemberResource(self)

    @cached_property
    def workflow_run(self) -> WorkflowRunResource:
        """Workflow runs represent executions of automated workflows."""
        from .resources.workflow_run import WorkflowRunResource

        return WorkflowRunResource(self)

    @cached_property
    def with_raw_response(self) -> LightfieldWithRawResponse:
        return LightfieldWithRawResponse(self)

    @cached_property
    def with_streaming_response(self) -> LightfieldWithStreamedResponse:
        return LightfieldWithStreamedResponse(self)

    @property
    @override
    def qs(self) -> Querystring:
        return Querystring(array_format="comma")

    @property
    @override
    def auth_headers(self) -> dict[str, str]:
        api_key = self.api_key
        return {"Authorization": f"Bearer {api_key}"}

    @property
    @override
    def default_headers(self) -> dict[str, str | Omit]:
        return {
            **super().default_headers,
            "X-Stainless-Async": "false",
            "Lightfield-Version": "2026-03-01",
            **self._custom_headers,
        }

    def copy(
        self,
        *,
        api_key: str | None = None,
        base_url: str | httpx.URL | None = None,
        timeout: float | Timeout | None | NotGiven = not_given,
        http_client: httpx.Client | None = None,
        max_retries: int | NotGiven = not_given,
        default_headers: Mapping[str, str] | None = None,
        set_default_headers: Mapping[str, str] | None = None,
        default_query: Mapping[str, object] | None = None,
        set_default_query: Mapping[str, object] | None = None,
        _extra_kwargs: Mapping[str, Any] = {},
    ) -> Self:
        """
        Create a new client instance re-using the same options given to the current client with optional overriding.
        """
        if default_headers is not None and set_default_headers is not None:
            raise ValueError("The `default_headers` and `set_default_headers` arguments are mutually exclusive")

        if default_query is not None and set_default_query is not None:
            raise ValueError("The `default_query` and `set_default_query` arguments are mutually exclusive")

        headers = self._custom_headers
        if default_headers is not None:
            headers = {**headers, **default_headers}
        elif set_default_headers is not None:
            headers = set_default_headers

        params = self._custom_query
        if default_query is not None:
            params = {**params, **default_query}
        elif set_default_query is not None:
            params = set_default_query

        http_client = http_client or self._client
        return self.__class__(
            api_key=api_key or self.api_key,
            base_url=base_url or self.base_url,
            timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
            http_client=http_client,
            max_retries=max_retries if is_given(max_retries) else self.max_retries,
            default_headers=headers,
            default_query=params,
            **_extra_kwargs,
        )

    # Alias for `copy` for nicer inline usage, e.g.
    # client.with_options(timeout=10).foo.create(...)
    with_options = copy

    @override
    def _make_status_error(
        self,
        err_msg: str,
        *,
        body: object,
        response: httpx.Response,
    ) -> APIStatusError:
        if response.status_code == 400:
            return _exceptions.BadRequestError(err_msg, response=response, body=body)

        if response.status_code == 401:
            return _exceptions.AuthenticationError(err_msg, response=response, body=body)

        if response.status_code == 403:
            return _exceptions.PermissionDeniedError(err_msg, response=response, body=body)

        if response.status_code == 404:
            return _exceptions.NotFoundError(err_msg, response=response, body=body)

        if response.status_code == 409:
            return _exceptions.ConflictError(err_msg, response=response, body=body)

        if response.status_code == 422:
            return _exceptions.UnprocessableEntityError(err_msg, response=response, body=body)

        if response.status_code == 429:
            return _exceptions.RateLimitError(err_msg, response=response, body=body)

        if response.status_code >= 500:
            return _exceptions.InternalServerError(err_msg, response=response, body=body)
        return APIStatusError(err_msg, response=response, body=body)


class AsyncLightfield(AsyncAPIClient):
    # client options
    api_key: str

    def __init__(
        self,
        *,
        api_key: str,
        base_url: str | httpx.URL | None = None,
        timeout: float | Timeout | None | NotGiven = not_given,
        max_retries: int = DEFAULT_MAX_RETRIES,
        default_headers: Mapping[str, str] | None = None,
        default_query: Mapping[str, object] | None = None,
        # Configure a custom httpx client.
        # We provide a `DefaultAsyncHttpxClient` class that you can pass to retain the default values we use for `limits`, `timeout` & `follow_redirects`.
        # See the [httpx documentation](https://www.python-httpx.org/api/#asyncclient) for more details.
        http_client: httpx.AsyncClient | None = None,
        # Enable or disable schema validation for data returned by the API.
        # When enabled an error APIResponseValidationError is raised
        # if the API responds with invalid data for the expected schema.
        #
        # This parameter may be removed or changed in the future.
        # If you rely on this feature, please open a GitHub issue
        # outlining your use-case to help us decide if it should be
        # part of our public interface in the future.
        _strict_response_validation: bool = False,
    ) -> None:
        """Construct a new async AsyncLightfield client instance."""
        self.api_key = api_key

        if base_url is None:
            base_url = os.environ.get("LIGHTFIELD_BASE_URL")
        if base_url is None:
            base_url = f"https://api.lightfield.app"

        super().__init__(
            version=__version__,
            base_url=base_url,
            max_retries=max_retries,
            timeout=timeout,
            http_client=http_client,
            custom_headers=default_headers,
            custom_query=default_query,
            _strict_response_validation=_strict_response_validation,
        )

    @cached_property
    def account(self) -> AsyncAccountResource:
        """Accounts represent companies or organizations in Lightfield.

        Each account can have contacts, opportunities, tasks, and notes associated with it.
        """
        from .resources.account import AsyncAccountResource

        return AsyncAccountResource(self)

    @cached_property
    def contact(self) -> AsyncContactResource:
        """Contacts represent individual people in Lightfield.

        Contacts can be associated with one or more accounts.
        """
        from .resources.contact import AsyncContactResource

        return AsyncContactResource(self)

    @cached_property
    def opportunity(self) -> AsyncOpportunityResource:
        """Opportunities represent potential deals or sales in Lightfield.

        Each opportunity belongs to an account and can have tasks and notes associated with it.
        """
        from .resources.opportunity import AsyncOpportunityResource

        return AsyncOpportunityResource(self)

    @cached_property
    def member(self) -> AsyncMemberResource:
        """Members represent users in your Lightfield workspace.

        Members can own accounts and opportunities, and are referenced in relationships like `$owner` and `$createdBy`.
        """
        from .resources.member import AsyncMemberResource

        return AsyncMemberResource(self)

    @cached_property
    def workflow_run(self) -> AsyncWorkflowRunResource:
        """Workflow runs represent executions of automated workflows."""
        from .resources.workflow_run import AsyncWorkflowRunResource

        return AsyncWorkflowRunResource(self)

    @cached_property
    def with_raw_response(self) -> AsyncLightfieldWithRawResponse:
        return AsyncLightfieldWithRawResponse(self)

    @cached_property
    def with_streaming_response(self) -> AsyncLightfieldWithStreamedResponse:
        return AsyncLightfieldWithStreamedResponse(self)

    @property
    @override
    def qs(self) -> Querystring:
        return Querystring(array_format="comma")

    @property
    @override
    def auth_headers(self) -> dict[str, str]:
        api_key = self.api_key
        return {"Authorization": f"Bearer {api_key}"}

    @property
    @override
    def default_headers(self) -> dict[str, str | Omit]:
        return {
            **super().default_headers,
            "X-Stainless-Async": f"async:{get_async_library()}",
            "Lightfield-Version": "2026-03-01",
            **self._custom_headers,
        }

    def copy(
        self,
        *,
        api_key: str | None = None,
        base_url: str | httpx.URL | None = None,
        timeout: float | Timeout | None | NotGiven = not_given,
        http_client: httpx.AsyncClient | None = None,
        max_retries: int | NotGiven = not_given,
        default_headers: Mapping[str, str] | None = None,
        set_default_headers: Mapping[str, str] | None = None,
        default_query: Mapping[str, object] | None = None,
        set_default_query: Mapping[str, object] | None = None,
        _extra_kwargs: Mapping[str, Any] = {},
    ) -> Self:
        """
        Create a new client instance re-using the same options given to the current client with optional overriding.
        """
        if default_headers is not None and set_default_headers is not None:
            raise ValueError("The `default_headers` and `set_default_headers` arguments are mutually exclusive")

        if default_query is not None and set_default_query is not None:
            raise ValueError("The `default_query` and `set_default_query` arguments are mutually exclusive")

        headers = self._custom_headers
        if default_headers is not None:
            headers = {**headers, **default_headers}
        elif set_default_headers is not None:
            headers = set_default_headers

        params = self._custom_query
        if default_query is not None:
            params = {**params, **default_query}
        elif set_default_query is not None:
            params = set_default_query

        http_client = http_client or self._client
        return self.__class__(
            api_key=api_key or self.api_key,
            base_url=base_url or self.base_url,
            timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
            http_client=http_client,
            max_retries=max_retries if is_given(max_retries) else self.max_retries,
            default_headers=headers,
            default_query=params,
            **_extra_kwargs,
        )

    # Alias for `copy` for nicer inline usage, e.g.
    # client.with_options(timeout=10).foo.create(...)
    with_options = copy

    @override
    def _make_status_error(
        self,
        err_msg: str,
        *,
        body: object,
        response: httpx.Response,
    ) -> APIStatusError:
        if response.status_code == 400:
            return _exceptions.BadRequestError(err_msg, response=response, body=body)

        if response.status_code == 401:
            return _exceptions.AuthenticationError(err_msg, response=response, body=body)

        if response.status_code == 403:
            return _exceptions.PermissionDeniedError(err_msg, response=response, body=body)

        if response.status_code == 404:
            return _exceptions.NotFoundError(err_msg, response=response, body=body)

        if response.status_code == 409:
            return _exceptions.ConflictError(err_msg, response=response, body=body)

        if response.status_code == 422:
            return _exceptions.UnprocessableEntityError(err_msg, response=response, body=body)

        if response.status_code == 429:
            return _exceptions.RateLimitError(err_msg, response=response, body=body)

        if response.status_code >= 500:
            return _exceptions.InternalServerError(err_msg, response=response, body=body)
        return APIStatusError(err_msg, response=response, body=body)


class LightfieldWithRawResponse:
    _client: Lightfield

    def __init__(self, client: Lightfield) -> None:
        self._client = client

    @cached_property
    def account(self) -> account.AccountResourceWithRawResponse:
        """Accounts represent companies or organizations in Lightfield.

        Each account can have contacts, opportunities, tasks, and notes associated with it.
        """
        from .resources.account import AccountResourceWithRawResponse

        return AccountResourceWithRawResponse(self._client.account)

    @cached_property
    def contact(self) -> contact.ContactResourceWithRawResponse:
        """Contacts represent individual people in Lightfield.

        Contacts can be associated with one or more accounts.
        """
        from .resources.contact import ContactResourceWithRawResponse

        return ContactResourceWithRawResponse(self._client.contact)

    @cached_property
    def opportunity(self) -> opportunity.OpportunityResourceWithRawResponse:
        """Opportunities represent potential deals or sales in Lightfield.

        Each opportunity belongs to an account and can have tasks and notes associated with it.
        """
        from .resources.opportunity import OpportunityResourceWithRawResponse

        return OpportunityResourceWithRawResponse(self._client.opportunity)

    @cached_property
    def member(self) -> member.MemberResourceWithRawResponse:
        """Members represent users in your Lightfield workspace.

        Members can own accounts and opportunities, and are referenced in relationships like `$owner` and `$createdBy`.
        """
        from .resources.member import MemberResourceWithRawResponse

        return MemberResourceWithRawResponse(self._client.member)

    @cached_property
    def workflow_run(self) -> workflow_run.WorkflowRunResourceWithRawResponse:
        """Workflow runs represent executions of automated workflows."""
        from .resources.workflow_run import WorkflowRunResourceWithRawResponse

        return WorkflowRunResourceWithRawResponse(self._client.workflow_run)


class AsyncLightfieldWithRawResponse:
    _client: AsyncLightfield

    def __init__(self, client: AsyncLightfield) -> None:
        self._client = client

    @cached_property
    def account(self) -> account.AsyncAccountResourceWithRawResponse:
        """Accounts represent companies or organizations in Lightfield.

        Each account can have contacts, opportunities, tasks, and notes associated with it.
        """
        from .resources.account import AsyncAccountResourceWithRawResponse

        return AsyncAccountResourceWithRawResponse(self._client.account)

    @cached_property
    def contact(self) -> contact.AsyncContactResourceWithRawResponse:
        """Contacts represent individual people in Lightfield.

        Contacts can be associated with one or more accounts.
        """
        from .resources.contact import AsyncContactResourceWithRawResponse

        return AsyncContactResourceWithRawResponse(self._client.contact)

    @cached_property
    def opportunity(self) -> opportunity.AsyncOpportunityResourceWithRawResponse:
        """Opportunities represent potential deals or sales in Lightfield.

        Each opportunity belongs to an account and can have tasks and notes associated with it.
        """
        from .resources.opportunity import AsyncOpportunityResourceWithRawResponse

        return AsyncOpportunityResourceWithRawResponse(self._client.opportunity)

    @cached_property
    def member(self) -> member.AsyncMemberResourceWithRawResponse:
        """Members represent users in your Lightfield workspace.

        Members can own accounts and opportunities, and are referenced in relationships like `$owner` and `$createdBy`.
        """
        from .resources.member import AsyncMemberResourceWithRawResponse

        return AsyncMemberResourceWithRawResponse(self._client.member)

    @cached_property
    def workflow_run(self) -> workflow_run.AsyncWorkflowRunResourceWithRawResponse:
        """Workflow runs represent executions of automated workflows."""
        from .resources.workflow_run import AsyncWorkflowRunResourceWithRawResponse

        return AsyncWorkflowRunResourceWithRawResponse(self._client.workflow_run)


class LightfieldWithStreamedResponse:
    _client: Lightfield

    def __init__(self, client: Lightfield) -> None:
        self._client = client

    @cached_property
    def account(self) -> account.AccountResourceWithStreamingResponse:
        """Accounts represent companies or organizations in Lightfield.

        Each account can have contacts, opportunities, tasks, and notes associated with it.
        """
        from .resources.account import AccountResourceWithStreamingResponse

        return AccountResourceWithStreamingResponse(self._client.account)

    @cached_property
    def contact(self) -> contact.ContactResourceWithStreamingResponse:
        """Contacts represent individual people in Lightfield.

        Contacts can be associated with one or more accounts.
        """
        from .resources.contact import ContactResourceWithStreamingResponse

        return ContactResourceWithStreamingResponse(self._client.contact)

    @cached_property
    def opportunity(self) -> opportunity.OpportunityResourceWithStreamingResponse:
        """Opportunities represent potential deals or sales in Lightfield.

        Each opportunity belongs to an account and can have tasks and notes associated with it.
        """
        from .resources.opportunity import OpportunityResourceWithStreamingResponse

        return OpportunityResourceWithStreamingResponse(self._client.opportunity)

    @cached_property
    def member(self) -> member.MemberResourceWithStreamingResponse:
        """Members represent users in your Lightfield workspace.

        Members can own accounts and opportunities, and are referenced in relationships like `$owner` and `$createdBy`.
        """
        from .resources.member import MemberResourceWithStreamingResponse

        return MemberResourceWithStreamingResponse(self._client.member)

    @cached_property
    def workflow_run(self) -> workflow_run.WorkflowRunResourceWithStreamingResponse:
        """Workflow runs represent executions of automated workflows."""
        from .resources.workflow_run import WorkflowRunResourceWithStreamingResponse

        return WorkflowRunResourceWithStreamingResponse(self._client.workflow_run)


class AsyncLightfieldWithStreamedResponse:
    _client: AsyncLightfield

    def __init__(self, client: AsyncLightfield) -> None:
        self._client = client

    @cached_property
    def account(self) -> account.AsyncAccountResourceWithStreamingResponse:
        """Accounts represent companies or organizations in Lightfield.

        Each account can have contacts, opportunities, tasks, and notes associated with it.
        """
        from .resources.account import AsyncAccountResourceWithStreamingResponse

        return AsyncAccountResourceWithStreamingResponse(self._client.account)

    @cached_property
    def contact(self) -> contact.AsyncContactResourceWithStreamingResponse:
        """Contacts represent individual people in Lightfield.

        Contacts can be associated with one or more accounts.
        """
        from .resources.contact import AsyncContactResourceWithStreamingResponse

        return AsyncContactResourceWithStreamingResponse(self._client.contact)

    @cached_property
    def opportunity(self) -> opportunity.AsyncOpportunityResourceWithStreamingResponse:
        """Opportunities represent potential deals or sales in Lightfield.

        Each opportunity belongs to an account and can have tasks and notes associated with it.
        """
        from .resources.opportunity import AsyncOpportunityResourceWithStreamingResponse

        return AsyncOpportunityResourceWithStreamingResponse(self._client.opportunity)

    @cached_property
    def member(self) -> member.AsyncMemberResourceWithStreamingResponse:
        """Members represent users in your Lightfield workspace.

        Members can own accounts and opportunities, and are referenced in relationships like `$owner` and `$createdBy`.
        """
        from .resources.member import AsyncMemberResourceWithStreamingResponse

        return AsyncMemberResourceWithStreamingResponse(self._client.member)

    @cached_property
    def workflow_run(self) -> workflow_run.AsyncWorkflowRunResourceWithStreamingResponse:
        """Workflow runs represent executions of automated workflows."""
        from .resources.workflow_run import AsyncWorkflowRunResourceWithStreamingResponse

        return AsyncWorkflowRunResourceWithStreamingResponse(self._client.workflow_run)


Client = Lightfield

AsyncClient = AsyncLightfield
