fathom-python 0.0.26__py3-none-any.whl → 0.0.28__py3-none-any.whl

fathom/__init__.py

@@ -11,7 +11,6 @@ from .types import (
     CrmMatches,
     FathomUser,
     Invitee,
-    ListMeetingsRequestMeetingType,
     Meeting,
     MeetingListResponse,
     MeetingMeetingType,
@@ -41,7 +40,6 @@ __all__ = [
     "CrmMatches",
     "FathomUser",
     "Invitee",
-    "ListMeetingsRequestMeetingType",
     "Meeting",
     "MeetingListResponse",
     "MeetingMeetingType",

fathom/base_client.py

@@ -4,14 +4,11 @@ import typing
 
 import httpx
 from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
-from .core.pagination import AsyncPager, SyncPager
-from .core.request_options import RequestOptions
 from .environment import FathomApiEnvironment
-from .raw_base_client import AsyncRawBaseClient, RawBaseClient
-from .types.list_meetings_request_meeting_type import ListMeetingsRequestMeetingType
-from .types.meeting import Meeting
-from .types.team import Team
-from .types.team_member import TeamMember
+from .meetings.client import AsyncMeetingsClient, MeetingsClient
+from .team_members.client import AsyncTeamMembersClient, TeamMembersClient
+from .teams.client import AsyncTeamsClient, TeamsClient
+from .webhooks.client import AsyncWebhooksClient, WebhooksClient
 
 
 class BaseClient:
@@ -69,167 +66,10 @@ class BaseClient:
             else httpx.Client(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
-        self._raw_client = RawBaseClient(client_wrapper=self._client_wrapper)
-
-    @property
-    def with_raw_response(self) -> RawBaseClient:
-        """
-        Retrieves a raw implementation of this client that returns raw responses.
-
-        Returns
-        -------
-        RawBaseClient
-        """
-        return self._raw_client
-
-    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,
-    ) -> SyncPager[Meeting]:
-        """
-        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
-        -------
-        SyncPager[Meeting]
-            Paginated list of meetings.
-
-        Examples
-        --------
-        from fathom import FathomApi
-        client = FathomApi(api_key="YOUR_API_KEY", )
-        response = client.list_meetings()
-        for item in response:
-            yield item
-        # alternatively, you can paginate page-by-page
-        for page in response.iter_pages():
-            yield page
-        """
-        return self._raw_client.list_meetings(
-            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,
-        )
-
-    def list_teams(
-        self, *, cursor: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
-    ) -> SyncPager[Team]:
-        """
-        Parameters
-        ----------
-        cursor : typing.Optional[str]
-            Cursor for pagination.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        SyncPager[Team]
-            Paginated list of teams.
-
-        Examples
-        --------
-        from fathom import FathomApi
-        client = FathomApi(api_key="YOUR_API_KEY", )
-        response = client.list_teams()
-        for item in response:
-            yield item
-        # alternatively, you can paginate page-by-page
-        for page in response.iter_pages():
-            yield page
-        """
-        return self._raw_client.list_teams(cursor=cursor, request_options=request_options)
-
-    def list_team_members(
-        self,
-        *,
-        team: typing.Optional[str] = None,
-        cursor: typing.Optional[str] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> SyncPager[TeamMember]:
-        """
-        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
-        -------
-        SyncPager[TeamMember]
-            Paginated list of team members.
-
-        Examples
-        --------
-        from fathom import FathomApi
-        client = FathomApi(api_key="YOUR_API_KEY", )
-        response = client.list_team_members()
-        for item in response:
-            yield item
-        # alternatively, you can paginate page-by-page
-        for page in response.iter_pages():
-            yield page
-        """
-        return self._raw_client.list_team_members(team=team, cursor=cursor, request_options=request_options)
+        self.meetings = MeetingsClient(client_wrapper=self._client_wrapper)
+        self.teams = TeamsClient(client_wrapper=self._client_wrapper)
+        self.team_members = TeamMembersClient(client_wrapper=self._client_wrapper)
+        self.webhooks = WebhooksClient(client_wrapper=self._client_wrapper)
 
 
 class AsyncBaseClient:
@@ -287,179 +127,10 @@ class AsyncBaseClient:
             else httpx.AsyncClient(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
-        self._raw_client = AsyncRawBaseClient(client_wrapper=self._client_wrapper)
-
-    @property
-    def with_raw_response(self) -> AsyncRawBaseClient:
-        """
-        Retrieves a raw implementation of this client that returns raw responses.
-
-        Returns
-        -------
-        AsyncRawBaseClient
-        """
-        return self._raw_client
-
-    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,
-    ) -> AsyncPager[Meeting]:
-        """
-        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
-        -------
-        AsyncPager[Meeting]
-            Paginated list of meetings.
-
-        Examples
-        --------
-        from fathom import AsyncFathomApi
-        import asyncio
-        client = AsyncFathomApi(api_key="YOUR_API_KEY", )
-        async def main() -> None:
-            response = await client.list_meetings()
-            async for item in response:
-                yield item
-
-            # alternatively, you can paginate page-by-page
-            async for page in response.iter_pages():
-                yield page
-        asyncio.run(main())
-        """
-        return await self._raw_client.list_meetings(
-            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,
-        )
-
-    async def list_teams(
-        self, *, cursor: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
-    ) -> AsyncPager[Team]:
-        """
-        Parameters
-        ----------
-        cursor : typing.Optional[str]
-            Cursor for pagination.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        AsyncPager[Team]
-            Paginated list of teams.
-
-        Examples
-        --------
-        from fathom import AsyncFathomApi
-        import asyncio
-        client = AsyncFathomApi(api_key="YOUR_API_KEY", )
-        async def main() -> None:
-            response = await client.list_teams()
-            async for item in response:
-                yield item
-
-            # alternatively, you can paginate page-by-page
-            async for page in response.iter_pages():
-                yield page
-        asyncio.run(main())
-        """
-        return await self._raw_client.list_teams(cursor=cursor, request_options=request_options)
-
-    async def list_team_members(
-        self,
-        *,
-        team: typing.Optional[str] = None,
-        cursor: typing.Optional[str] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncPager[TeamMember]:
-        """
-        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
-        -------
-        AsyncPager[TeamMember]
-            Paginated list of team members.
-
-        Examples
-        --------
-        from fathom import AsyncFathomApi
-        import asyncio
-        client = AsyncFathomApi(api_key="YOUR_API_KEY", )
-        async def main() -> None:
-            response = await client.list_team_members()
-            async for item in response:
-                yield item
-
-            # alternatively, you can paginate page-by-page
-            async for page in response.iter_pages():
-                yield page
-        asyncio.run(main())
-        """
-        return await self._raw_client.list_team_members(team=team, cursor=cursor, request_options=request_options)
+        self.meetings = AsyncMeetingsClient(client_wrapper=self._client_wrapper)
+        self.teams = AsyncTeamsClient(client_wrapper=self._client_wrapper)
+        self.team_members = AsyncTeamMembersClient(client_wrapper=self._client_wrapper)
+        self.webhooks = AsyncWebhooksClient(client_wrapper=self._client_wrapper)
 
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: FathomApiEnvironment) -> str:

fathom/core/client_wrapper.py

@@ -14,10 +14,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "fathom-python/0.0.26",
+            "User-Agent": "fathom-python/0.0.28",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "fathom-python",
-            "X-Fern-SDK-Version": "0.0.26",
+            "X-Fern-SDK-Version": "0.0.28",
         }
         headers["X-Api-Key"] = self.api_key
         return headers

fathom/errors/__init__.py

@@ -3,6 +3,8 @@
 # isort: skip_file
 
 from .bad_request_error import BadRequestError
+from .not_found_error import NotFoundError
+from .too_many_requests_error import TooManyRequestsError
 from .unauthorized_error import UnauthorizedError
 
-__all__ = ["BadRequestError", "UnauthorizedError"]
+__all__ = ["BadRequestError", "NotFoundError", "TooManyRequestsError", "UnauthorizedError"]

fathom/errors/not_found_error.py

@@ -0,0 +1,10 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.api_error import ApiError
+
+
+class NotFoundError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any], headers: typing.Optional[typing.Dict[str, str]] = None):
+        super().__init__(status_code=404, headers=headers, body=body)

fathom/errors/too_many_requests_error.py

@@ -0,0 +1,10 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.api_error import ApiError
+
+
+class TooManyRequestsError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any], headers: typing.Optional[typing.Dict[str, str]] = None):
+        super().__init__(status_code=429, headers=headers, body=body)

fathom/meetings/__init__.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .types import ListMeetingsRequestMeetingType
+
+__all__ = ["ListMeetingsRequestMeetingType"]

fathom/meetings/client.py

@@ -0,0 +1,250 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
+from ..core.request_options import RequestOptions
+from ..types.meeting import Meeting
+from .raw_client import AsyncRawMeetingsClient, RawMeetingsClient
+from .types.list_meetings_request_meeting_type import ListMeetingsRequestMeetingType
+
+
+class MeetingsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawMeetingsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawMeetingsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawMeetingsClient
+        """
+        return self._raw_client
+
+    def list_meetings(
+        self,
+        *,
+        calendar_invitees: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        calendar_invitees_domains: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        created_after: typing.Optional[str] = None,
+        created_before: typing.Optional[str] = None,
+        cursor: typing.Optional[str] = None,
+        include_crm_matches: typing.Optional[bool] = None,
+        include_transcript: typing.Optional[bool] = None,
+        meeting_type: typing.Optional[ListMeetingsRequestMeetingType] = None,
+        recorded_by: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        teams: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SyncPager[Meeting]:
+        """
+        Parameters
+        ----------
+        calendar_invitees : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Email address of calendar_invitees to filter by.
+
+            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.
+
+        calendar_invitees_domains : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Domains of the companies to filter by. Exact match.
+
+            Pass the parameter once per value, e.g.
+            `calendar_invitees_domains[]=acme.com&calendar_invitees_domains[]=client.com`.
+
+            Returns meetings where any of the given company domains appear in the meeting.
+
+        created_after : typing.Optional[str]
+            Filter to meetings with created_at after this timestamp, e.g. `created_after=2025-01-01T00:00:00Z`.
+
+        created_before : typing.Optional[str]
+            Filter to meetings with created_at before this timestamp, e.g. `created_before=2025-01-01T00:00:00Z`.
+
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        include_crm_matches : typing.Optional[bool]
+            Include CRM matches for each meeting. Only returns data from your or your team's linked CRM.
+
+        include_transcript : typing.Optional[bool]
+            Include the transcript for each meeting.
+
+        meeting_type : typing.Optional[ListMeetingsRequestMeetingType]
+            Filter by meeting type.
+
+        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.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SyncPager[Meeting]
+            Paginated list of meetings.
+
+        Examples
+        --------
+        from fathom import FathomApi
+        client = FathomApi(api_key="YOUR_API_KEY", )
+        response = client.meetings.list_meetings()
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
+        """
+        return self._raw_client.list_meetings(
+            calendar_invitees=calendar_invitees,
+            calendar_invitees_domains=calendar_invitees_domains,
+            created_after=created_after,
+            created_before=created_before,
+            cursor=cursor,
+            include_crm_matches=include_crm_matches,
+            include_transcript=include_transcript,
+            meeting_type=meeting_type,
+            recorded_by=recorded_by,
+            teams=teams,
+            request_options=request_options,
+        )
+
+
+class AsyncMeetingsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawMeetingsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawMeetingsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawMeetingsClient
+        """
+        return self._raw_client
+
+    async def list_meetings(
+        self,
+        *,
+        calendar_invitees: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        calendar_invitees_domains: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        created_after: typing.Optional[str] = None,
+        created_before: typing.Optional[str] = None,
+        cursor: typing.Optional[str] = None,
+        include_crm_matches: typing.Optional[bool] = None,
+        include_transcript: typing.Optional[bool] = None,
+        meeting_type: typing.Optional[ListMeetingsRequestMeetingType] = None,
+        recorded_by: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        teams: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncPager[Meeting]:
+        """
+        Parameters
+        ----------
+        calendar_invitees : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Email address of calendar_invitees to filter by.
+
+            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.
+
+        calendar_invitees_domains : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Domains of the companies to filter by. Exact match.
+
+            Pass the parameter once per value, e.g.
+            `calendar_invitees_domains[]=acme.com&calendar_invitees_domains[]=client.com`.
+
+            Returns meetings where any of the given company domains appear in the meeting.
+
+        created_after : typing.Optional[str]
+            Filter to meetings with created_at after this timestamp, e.g. `created_after=2025-01-01T00:00:00Z`.
+
+        created_before : typing.Optional[str]
+            Filter to meetings with created_at before this timestamp, e.g. `created_before=2025-01-01T00:00:00Z`.
+
+        cursor : typing.Optional[str]
+            Cursor for pagination.
+
+        include_crm_matches : typing.Optional[bool]
+            Include CRM matches for each meeting. Only returns data from your or your team's linked CRM.
+
+        include_transcript : typing.Optional[bool]
+            Include the transcript for each meeting.
+
+        meeting_type : typing.Optional[ListMeetingsRequestMeetingType]
+            Filter by meeting type.
+
+        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.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncPager[Meeting]
+            Paginated list of meetings.
+
+        Examples
+        --------
+        from fathom import AsyncFathomApi
+        import asyncio
+        client = AsyncFathomApi(api_key="YOUR_API_KEY", )
+        async def main() -> None:
+            response = await client.meetings.list_meetings()
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
+        asyncio.run(main())
+        """
+        return await self._raw_client.list_meetings(
+            calendar_invitees=calendar_invitees,
+            calendar_invitees_domains=calendar_invitees_domains,
+            created_after=created_after,
+            created_before=created_before,
+            cursor=cursor,
+            include_crm_matches=include_crm_matches,
+            include_transcript=include_transcript,
+            meeting_type=meeting_type,
+            recorded_by=recorded_by,
+            teams=teams,
+            request_options=request_options,
+        )