samsara-api 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

samsara/safety_events/audit_logs/raw_client.py

@@ -5,7 +5,7 @@ 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.pagination import AsyncPager, BaseHttpResponse, SyncPager
 from ...core.pydantic_utilities import parse_obj_as
 from ...core.request_options import RequestOptions
 from ...errors.bad_gateway_error import BadGatewayError
@@ -17,6 +17,7 @@ from ...errors.not_implemented_error import NotImplementedError
 from ...errors.service_unavailable_error import ServiceUnavailableError
 from ...errors.too_many_requests_error import TooManyRequestsError
 from ...errors.unauthorized_error import UnauthorizedError
+from ...types.safety_event_activity_feed_item_response_body import SafetyEventActivityFeedItemResponseBody
 from ...types.safety_events_get_safety_activity_event_feed_response_body import (
     SafetyEventsGetSafetyActivityEventFeedResponseBody,
 )
@@ -32,7 +33,7 @@ class RawAuditLogsClient:
         after: typing.Optional[str] = None,
         start_time: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[SafetyEventsGetSafetyActivityEventFeedResponseBody]:
+    ) -> SyncPager[SafetyEventActivityFeedItemResponseBody]:
         """
         Get continuous safety events. The safety activity event feed offers a change-log for safety events. Use this endpoint to subscribe to safety event changes. See documentation below for all supported change-log types.
 
@@ -62,7 +63,7 @@ class RawAuditLogsClient:
 
         Returns
         -------
-        HttpResponse[SafetyEventsGetSafetyActivityEventFeedResponseBody]
+        SyncPager[SafetyEventActivityFeedItemResponseBody]
             OK response.
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -76,14 +77,27 @@ class RawAuditLogsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     SafetyEventsGetSafetyActivityEventFeedResponseBody,
                     parse_obj_as(
                         type_=SafetyEventsGetSafetyActivityEventFeedResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return HttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+                    _get_next = lambda: self.feed(
+                        after=_parsed_next,
+                        start_time=start_time,
+                        request_options=request_options,
+                    )
+                return SyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),
@@ -199,7 +213,7 @@ class AsyncRawAuditLogsClient:
         after: typing.Optional[str] = None,
         start_time: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[SafetyEventsGetSafetyActivityEventFeedResponseBody]:
+    ) -> AsyncPager[SafetyEventActivityFeedItemResponseBody]:
         """
         Get continuous safety events. The safety activity event feed offers a change-log for safety events. Use this endpoint to subscribe to safety event changes. See documentation below for all supported change-log types.
 
@@ -229,7 +243,7 @@ class AsyncRawAuditLogsClient:
 
         Returns
         -------
-        AsyncHttpResponse[SafetyEventsGetSafetyActivityEventFeedResponseBody]
+        AsyncPager[SafetyEventActivityFeedItemResponseBody]
             OK response.
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -243,14 +257,30 @@ class AsyncRawAuditLogsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     SafetyEventsGetSafetyActivityEventFeedResponseBody,
                     parse_obj_as(
                         type_=SafetyEventsGetSafetyActivityEventFeedResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return AsyncHttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+
+                    async def _get_next():
+                        return await self.feed(
+                            after=_parsed_next,
+                            start_time=start_time,
+                            request_options=request_options,
+                        )
+
+                return AsyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),

samsara/safety_events/client.py

@@ -3,8 +3,9 @@
 import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
 from ..core.request_options import RequestOptions
-from ..types.safety_events_list_response import SafetyEventsListResponse
+from ..types.safety_event import SafetyEvent
 from .audit_logs.client import AsyncAuditLogsClient, AuditLogsClient
 from .raw_client import AsyncRawSafetyEventsClient, RawSafetyEventsClient
 
@@ -35,7 +36,7 @@ class SafetyEventsClient:
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> SafetyEventsListResponse:
+    ) -> SyncPager[SafetyEvent]:
         """
         Fetch safety events for the organization in a given time period.
 
@@ -68,7 +69,7 @@ class SafetyEventsClient:
 
         Returns
         -------
-        SafetyEventsListResponse
+        SyncPager[SafetyEvent]
             List of safety events from given time period.
 
         Examples
@@ -78,12 +79,17 @@ class SafetyEventsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.safety_events.list(
+        response = client.safety_events.list(
             start_time="startTime",
             end_time="endTime",
         )
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
         """
-        _response = self._raw_client.list(
+        return self._raw_client.list(
             start_time=start_time,
             end_time=end_time,
             after=after,
@@ -92,7 +98,6 @@ class SafetyEventsClient:
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data
 
 
 class AsyncSafetyEventsClient:
@@ -121,7 +126,7 @@ class AsyncSafetyEventsClient:
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> SafetyEventsListResponse:
+    ) -> AsyncPager[SafetyEvent]:
         """
         Fetch safety events for the organization in a given time period.
 
@@ -154,7 +159,7 @@ class AsyncSafetyEventsClient:
 
         Returns
         -------
-        SafetyEventsListResponse
+        AsyncPager[SafetyEvent]
             List of safety events from given time period.
 
         Examples
@@ -169,15 +174,21 @@ class AsyncSafetyEventsClient:
 
 
         async def main() -> None:
-            await client.safety_events.list(
+            response = await client.safety_events.list(
                 start_time="startTime",
                 end_time="endTime",
             )
+            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())
         """
-        _response = await self._raw_client.list(
+        return await self._raw_client.list(
             start_time=start_time,
             end_time=end_time,
             after=after,
@@ -186,4 +197,3 @@ class AsyncSafetyEventsClient:
             vehicle_ids=vehicle_ids,
             request_options=request_options,
         )
-        return _response.data

samsara/safety_events/raw_client.py

@@ -5,9 +5,10 @@ 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.pagination import AsyncPager, BaseHttpResponse, SyncPager
 from ..core.pydantic_utilities import parse_obj_as
 from ..core.request_options import RequestOptions
+from ..types.safety_event import SafetyEvent
 from ..types.safety_events_list_response import SafetyEventsListResponse
 
 
@@ -25,7 +26,7 @@ class RawSafetyEventsClient:
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[SafetyEventsListResponse]:
+    ) -> SyncPager[SafetyEvent]:
         """
         Fetch safety events for the organization in a given time period.
 
@@ -58,7 +59,7 @@ class RawSafetyEventsClient:
 
         Returns
         -------
-        HttpResponse[SafetyEventsListResponse]
+        SyncPager[SafetyEvent]
             List of safety events from given time period.
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -76,14 +77,31 @@ class RawSafetyEventsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     SafetyEventsListResponse,
                     parse_obj_as(
                         type_=SafetyEventsListResponse,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return HttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+                    _get_next = lambda: self.list(
+                        start_time=start_time,
+                        end_time=end_time,
+                        after=_parsed_next,
+                        tag_ids=tag_ids,
+                        parent_tag_ids=parent_tag_ids,
+                        vehicle_ids=vehicle_ids,
+                        request_options=request_options,
+                    )
+                return SyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
@@ -104,7 +122,7 @@ class AsyncRawSafetyEventsClient:
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         vehicle_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[SafetyEventsListResponse]:
+    ) -> AsyncPager[SafetyEvent]:
         """
         Fetch safety events for the organization in a given time period.
 
@@ -137,7 +155,7 @@ class AsyncRawSafetyEventsClient:
 
         Returns
         -------
-        AsyncHttpResponse[SafetyEventsListResponse]
+        AsyncPager[SafetyEvent]
             List of safety events from given time period.
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -155,14 +173,34 @@ class AsyncRawSafetyEventsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     SafetyEventsListResponse,
                     parse_obj_as(
                         type_=SafetyEventsListResponse,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return AsyncHttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+
+                    async def _get_next():
+                        return await self.list(
+                            start_time=start_time,
+                            end_time=end_time,
+                            after=_parsed_next,
+                            tag_ids=tag_ids,
+                            parent_tag_ids=parent_tag_ids,
+                            vehicle_ids=vehicle_ids,
+                            request_options=request_options,
+                        )
+
+                return AsyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)

samsara/speeding_intervals/client.py

@@ -3,10 +3,9 @@
 import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
 from ..core.request_options import RequestOptions
-from ..types.speeding_intervals_get_speeding_intervals_response_body import (
-    SpeedingIntervalsGetSpeedingIntervalsResponseBody,
-)
+from ..types.trip_speeding_intervals_response_body import TripSpeedingIntervalsResponseBody
 from .raw_client import AsyncRawSpeedingIntervalsClient, RawSpeedingIntervalsClient
 from .types.speeding_intervals_stream_request_query_by import SpeedingIntervalsStreamRequestQueryBy
 
@@ -38,9 +37,9 @@ class SpeedingIntervalsClient:
         after: typing.Optional[str] = None,
         severity_levels: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> SpeedingIntervalsGetSpeedingIntervalsResponseBody:
+    ) -> SyncPager[TripSpeedingIntervalsResponseBody]:
         """
-        This endpoint will return all speeding intervals associated with trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Results are paginated.
+        This endpoint will return all speeding intervals associated with all trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Trips with no speeding intervals detected will be returned with an empty list of intervals. Results are paginated.
 
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
@@ -73,14 +72,14 @@ class SpeedingIntervalsClient:
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
         severity_levels : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”.
+            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”. This filter does not exclude trips that have no speeding intervals.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        SpeedingIntervalsGetSpeedingIntervalsResponseBody
+        SyncPager[TripSpeedingIntervalsResponseBody]
             OK response.
 
         Examples
@@ -90,11 +89,16 @@ class SpeedingIntervalsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.speeding_intervals.stream(
+        response = client.speeding_intervals.stream(
             start_time="startTime",
         )
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
         """
-        _response = self._raw_client.stream(
+        return self._raw_client.stream(
             start_time=start_time,
             asset_ids=asset_ids,
             end_time=end_time,
@@ -105,7 +109,6 @@ class SpeedingIntervalsClient:
             severity_levels=severity_levels,
             request_options=request_options,
         )
-        return _response.data
 
 
 class AsyncSpeedingIntervalsClient:
@@ -135,9 +138,9 @@ class AsyncSpeedingIntervalsClient:
         after: typing.Optional[str] = None,
         severity_levels: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> SpeedingIntervalsGetSpeedingIntervalsResponseBody:
+    ) -> AsyncPager[TripSpeedingIntervalsResponseBody]:
         """
-        This endpoint will return all speeding intervals associated with trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Results are paginated.
+        This endpoint will return all speeding intervals associated with all trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Trips with no speeding intervals detected will be returned with an empty list of intervals. Results are paginated.
 
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
@@ -170,14 +173,14 @@ class AsyncSpeedingIntervalsClient:
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
         severity_levels : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”.
+            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”. This filter does not exclude trips that have no speeding intervals.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        SpeedingIntervalsGetSpeedingIntervalsResponseBody
+        AsyncPager[TripSpeedingIntervalsResponseBody]
             OK response.
 
         Examples
@@ -192,14 +195,20 @@ class AsyncSpeedingIntervalsClient:
 
 
         async def main() -> None:
-            await client.speeding_intervals.stream(
+            response = await client.speeding_intervals.stream(
                 start_time="startTime",
             )
+            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())
         """
-        _response = await self._raw_client.stream(
+        return await self._raw_client.stream(
             start_time=start_time,
             asset_ids=asset_ids,
             end_time=end_time,
@@ -210,4 +219,3 @@ class AsyncSpeedingIntervalsClient:
             severity_levels=severity_levels,
             request_options=request_options,
         )
-        return _response.data

samsara/speeding_intervals/raw_client.py

@@ -5,7 +5,7 @@ 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.pagination import AsyncPager, BaseHttpResponse, SyncPager
 from ..core.pydantic_utilities import parse_obj_as
 from ..core.request_options import RequestOptions
 from ..errors.bad_gateway_error import BadGatewayError
@@ -20,6 +20,7 @@ from ..errors.unauthorized_error import UnauthorizedError
 from ..types.speeding_intervals_get_speeding_intervals_response_body import (
     SpeedingIntervalsGetSpeedingIntervalsResponseBody,
 )
+from ..types.trip_speeding_intervals_response_body import TripSpeedingIntervalsResponseBody
 from .types.speeding_intervals_stream_request_query_by import SpeedingIntervalsStreamRequestQueryBy
 
 
@@ -39,9 +40,9 @@ class RawSpeedingIntervalsClient:
         after: typing.Optional[str] = None,
         severity_levels: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[SpeedingIntervalsGetSpeedingIntervalsResponseBody]:
+    ) -> SyncPager[TripSpeedingIntervalsResponseBody]:
         """
-        This endpoint will return all speeding intervals associated with trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Results are paginated.
+        This endpoint will return all speeding intervals associated with all trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Trips with no speeding intervals detected will be returned with an empty list of intervals. Results are paginated.
 
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
@@ -74,14 +75,14 @@ class RawSpeedingIntervalsClient:
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
         severity_levels : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”.
+            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”. This filter does not exclude trips that have no speeding intervals.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        HttpResponse[SpeedingIntervalsGetSpeedingIntervalsResponseBody]
+        SyncPager[TripSpeedingIntervalsResponseBody]
             OK response.
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -101,14 +102,33 @@ class RawSpeedingIntervalsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     SpeedingIntervalsGetSpeedingIntervalsResponseBody,
                     parse_obj_as(
                         type_=SpeedingIntervalsGetSpeedingIntervalsResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return HttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+                    _get_next = lambda: self.stream(
+                        start_time=start_time,
+                        asset_ids=asset_ids,
+                        end_time=end_time,
+                        query_by=query_by,
+                        include_asset=include_asset,
+                        include_driver_id=include_driver_id,
+                        after=_parsed_next,
+                        severity_levels=severity_levels,
+                        request_options=request_options,
+                    )
+                return SyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),
@@ -230,9 +250,9 @@ class AsyncRawSpeedingIntervalsClient:
         after: typing.Optional[str] = None,
         severity_levels: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[SpeedingIntervalsGetSpeedingIntervalsResponseBody]:
+    ) -> AsyncPager[TripSpeedingIntervalsResponseBody]:
         """
-        This endpoint will return all speeding intervals associated with trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Results are paginated.
+        This endpoint will return all speeding intervals associated with all trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Trips with no speeding intervals detected will be returned with an empty list of intervals. Results are paginated.
 
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
@@ -265,14 +285,14 @@ class AsyncRawSpeedingIntervalsClient:
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
         severity_levels : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”.
+            Optional string of comma-separated severity levels to filter speeding intervals by. Valid values:  “light”, ”moderate”, ”heavy”, “severe”. This filter does not exclude trips that have no speeding intervals.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        AsyncHttpResponse[SpeedingIntervalsGetSpeedingIntervalsResponseBody]
+        AsyncPager[TripSpeedingIntervalsResponseBody]
             OK response.
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -292,14 +312,36 @@ class AsyncRawSpeedingIntervalsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     SpeedingIntervalsGetSpeedingIntervalsResponseBody,
                     parse_obj_as(
                         type_=SpeedingIntervalsGetSpeedingIntervalsResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return AsyncHttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+
+                    async def _get_next():
+                        return await self.stream(
+                            start_time=start_time,
+                            asset_ids=asset_ids,
+                            end_time=end_time,
+                            query_by=query_by,
+                            include_asset=include_asset,
+                            include_driver_id=include_driver_id,
+                            after=_parsed_next,
+                            severity_levels=severity_levels,
+                            request_options=request_options,
+                        )
+
+                return AsyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),

samsara/tachograph/__init__.py

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

samsara/tachograph/client.py

@@ -0,0 +1,44 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from .driver.client import AsyncDriverClient, DriverClient
+from .raw_client import AsyncRawTachographClient, RawTachographClient
+from .vehicles.client import AsyncVehiclesClient, VehiclesClient
+
+
+class TachographClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawTachographClient(client_wrapper=client_wrapper)
+        self.driver = DriverClient(client_wrapper=client_wrapper)
+
+        self.vehicles = VehiclesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawTachographClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawTachographClient
+        """
+        return self._raw_client
+
+
+class AsyncTachographClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawTachographClient(client_wrapper=client_wrapper)
+        self.driver = AsyncDriverClient(client_wrapper=client_wrapper)
+
+        self.vehicles = AsyncVehiclesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawTachographClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawTachographClient
+        """
+        return self._raw_client