fathom-python 0.0.23__py3-none-any.whl

fathom/raw_base_client.py

@@ -0,0 +1,512 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from .core.api_error import ApiError
+from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from .core.http_response import AsyncHttpResponse, HttpResponse
+from .core.pydantic_utilities import parse_obj_as
+from .core.request_options import RequestOptions
+from .errors.bad_request_error import BadRequestError
+from .errors.unauthorized_error import UnauthorizedError
+from .types.list_meetings_request_meeting_type import ListMeetingsRequestMeetingType
+from .types.meeting_list_response import MeetingListResponse
+from .types.team_list_response import TeamListResponse
+from .types.team_member_list_response import TeamMemberListResponse
+
+
+class RawBaseClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list_meetings(
+        self,
+        *,
+        recorded_by: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        teams: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        calendar_invitees: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        created_after: typing.Optional[str] = None,
+        meeting_type: typing.Optional[ListMeetingsRequestMeetingType] = None,
+        include_transcript: typing.Optional[bool] = None,
+        cursor: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[MeetingListResponse]:
+        """
+        Parameters
+        ----------
+        recorded_by : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Email addresses of meeting owners.
+
+            Pass the parameter once per value, e.g.
+            `recorded_by[]=ceo@acme.com&recorded_by[]=pm@acme.com`.
+
+            Returns meetings hosted by any of the specified users.
+
+        teams : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Team names to filter by.
+
+            Pass the parameter once per value, e.g.
+            `teams[]=Sales&teams[]=Engineering`.
+
+            Returns meetings that belong to any of the specified teams.
+
+        calendar_invitees : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Email addresses of calendar_invitees.
+
+            Pass the parameter once per value, e.g.
+            `calendar_invitees[]=cfo@acme.com&calendar_invitees[]=legal@acme.com`.
+
+            Returns meetings where any of the given email addresses appear
+            in the calendar_invitees list.
+
+        created_after : typing.Optional[str]
+            Filter to meetings with created_at after this timestamp, e.g. `created_after=2025-01-01T00:00:00Z`.
+
+        meeting_type : typing.Optional[ListMeetingsRequestMeetingType]
+            Filter by meeting type.
+
+        include_transcript : typing.Optional[bool]
+            Include the transcript for each meeting.
+
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[MeetingListResponse]
+            Paginated list of meetings.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "meetings",
+            method="GET",
+            params={
+                "recorded_by[]": recorded_by,
+                "teams[]": teams,
+                "calendar_invitees[]": calendar_invitees,
+                "created_after": created_after,
+                "meeting_type": meeting_type,
+                "include_transcript": include_transcript,
+                "cursor": cursor,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    MeetingListResponse,
+                    parse_obj_as(
+                        type_=MeetingListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def list_teams(
+        self, *, cursor: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[TeamListResponse]:
+        """
+        Parameters
+        ----------
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[TeamListResponse]
+            Paginated list of teams.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "teams",
+            method="GET",
+            params={
+                "cursor": cursor,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TeamListResponse,
+                    parse_obj_as(
+                        type_=TeamListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def list_team_members(
+        self,
+        *,
+        team: typing.Optional[str] = None,
+        cursor: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[TeamMemberListResponse]:
+        """
+        Parameters
+        ----------
+        team : typing.Optional[str]
+            Team name to filter by.
+
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[TeamMemberListResponse]
+            Paginated list of team members.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "team_members",
+            method="GET",
+            params={
+                "team": team,
+                "cursor": cursor,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TeamMemberListResponse,
+                    parse_obj_as(
+                        type_=TeamMemberListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawBaseClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list_meetings(
+        self,
+        *,
+        recorded_by: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        teams: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        calendar_invitees: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        created_after: typing.Optional[str] = None,
+        meeting_type: typing.Optional[ListMeetingsRequestMeetingType] = None,
+        include_transcript: typing.Optional[bool] = None,
+        cursor: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[MeetingListResponse]:
+        """
+        Parameters
+        ----------
+        recorded_by : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Email addresses of meeting owners.
+
+            Pass the parameter once per value, e.g.
+            `recorded_by[]=ceo@acme.com&recorded_by[]=pm@acme.com`.
+
+            Returns meetings hosted by any of the specified users.
+
+        teams : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Team names to filter by.
+
+            Pass the parameter once per value, e.g.
+            `teams[]=Sales&teams[]=Engineering`.
+
+            Returns meetings that belong to any of the specified teams.
+
+        calendar_invitees : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Email addresses of calendar_invitees.
+
+            Pass the parameter once per value, e.g.
+            `calendar_invitees[]=cfo@acme.com&calendar_invitees[]=legal@acme.com`.
+
+            Returns meetings where any of the given email addresses appear
+            in the calendar_invitees list.
+
+        created_after : typing.Optional[str]
+            Filter to meetings with created_at after this timestamp, e.g. `created_after=2025-01-01T00:00:00Z`.
+
+        meeting_type : typing.Optional[ListMeetingsRequestMeetingType]
+            Filter by meeting type.
+
+        include_transcript : typing.Optional[bool]
+            Include the transcript for each meeting.
+
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[MeetingListResponse]
+            Paginated list of meetings.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "meetings",
+            method="GET",
+            params={
+                "recorded_by[]": recorded_by,
+                "teams[]": teams,
+                "calendar_invitees[]": calendar_invitees,
+                "created_after": created_after,
+                "meeting_type": meeting_type,
+                "include_transcript": include_transcript,
+                "cursor": cursor,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    MeetingListResponse,
+                    parse_obj_as(
+                        type_=MeetingListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def list_teams(
+        self, *, cursor: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[TeamListResponse]:
+        """
+        Parameters
+        ----------
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[TeamListResponse]
+            Paginated list of teams.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "teams",
+            method="GET",
+            params={
+                "cursor": cursor,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TeamListResponse,
+                    parse_obj_as(
+                        type_=TeamListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def list_team_members(
+        self,
+        *,
+        team: typing.Optional[str] = None,
+        cursor: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[TeamMemberListResponse]:
+        """
+        Parameters
+        ----------
+        team : typing.Optional[str]
+            Team name to filter by.
+
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[TeamMemberListResponse]
+            Paginated list of team members.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "team_members",
+            method="GET",
+            params={
+                "team": team,
+                "cursor": cursor,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TeamMemberListResponse,
+                    parse_obj_as(
+                        type_=TeamMemberListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

fathom/types/__init__.py

@@ -0,0 +1,45 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .action_item import ActionItem
+from .assignee import Assignee
+from .crm_company_match import CrmCompanyMatch
+from .crm_contact_match import CrmContactMatch
+from .crm_deal_match import CrmDealMatch
+from .crm_matches import CrmMatches
+from .fathom_user import FathomUser
+from .invitee import Invitee
+from .list_meetings_request_meeting_type import ListMeetingsRequestMeetingType
+from .meeting import Meeting
+from .meeting_list_response import MeetingListResponse
+from .meeting_meeting_type import MeetingMeetingType
+from .meeting_summary import MeetingSummary
+from .team import Team
+from .team_list_response import TeamListResponse
+from .team_member import TeamMember
+from .team_member_list_response import TeamMemberListResponse
+from .transcript_item import TranscriptItem
+from .transcript_item_speaker import TranscriptItemSpeaker
+
+__all__ = [
+    "ActionItem",
+    "Assignee",
+    "CrmCompanyMatch",
+    "CrmContactMatch",
+    "CrmDealMatch",
+    "CrmMatches",
+    "FathomUser",
+    "Invitee",
+    "ListMeetingsRequestMeetingType",
+    "Meeting",
+    "MeetingListResponse",
+    "MeetingMeetingType",
+    "MeetingSummary",
+    "Team",
+    "TeamListResponse",
+    "TeamMember",
+    "TeamMemberListResponse",
+    "TranscriptItem",
+    "TranscriptItemSpeaker",
+]

fathom/types/action_item.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .assignee import Assignee
+
+
+class ActionItem(UniversalBaseModel):
+    description: str
+    user_generated: bool
+    completed: bool
+    recording_timestamp: str = pydantic.Field()
+    """
+    Timestamp relative to the start of the recording (HH:MM:SS).
+    """
+
+    recording_playback_url: str
+    assignee: Assignee
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

fathom/types/assignee.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class Assignee(UniversalBaseModel):
+    name: str
+    email: str
+    team: str
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

fathom/types/crm_company_match.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class CrmCompanyMatch(UniversalBaseModel):
+    name: str
+    record_url: str
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

fathom/types/crm_contact_match.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class CrmContactMatch(UniversalBaseModel):
+    name: str
+    email: str
+    record_url: str
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

fathom/types/crm_deal_match.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class CrmDealMatch(UniversalBaseModel):
+    name: str
+    amount: int
+    record_url: str
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow