BasisTheoryClient 7.2.1__tar.gz → 7.3.0__tar.gz

{basistheoryclient-7.2.1 → basistheoryclient-7.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: BasisTheoryClient
-Version: 7.2.1
+Version: 7.3.0
 Summary: 
 License: Apache-2.0
 License-File: LICENSE

{basistheoryclient-7.2.1 → basistheoryclient-7.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "BasisTheoryClient"
-version = "7.2.1"
+version = "7.3.0"
 description = ""
 readme = "README.md"
 authors = []

{basistheoryclient-7.2.1 → basistheoryclient-7.3.0}/src/basis_theory/__init__.py

@@ -92,6 +92,9 @@ if typing.TYPE_CHECKING:
         EnrollmentProvider,
         EnrollmentStatus,
         EnrollmentType,
+        Event,
+        EventPage,
+        EventPagePagination,
         EventTypes,
         FunctionSourceDetection,
         FunctionSourceValidation,
@@ -245,6 +248,7 @@ if typing.TYPE_CHECKING:
         InternalServerError,
         NotFoundError,
         ServiceUnavailableError,
+        TooManyRequestsError,
         UnauthorizedError,
         UnprocessableEntityError,
     )
@@ -257,6 +261,7 @@ if typing.TYPE_CHECKING:
         applications,
         documents,
         enrichments,
+        events,
         google_pay,
         keys,
         logs,
@@ -369,6 +374,9 @@ _dynamic_imports: typing.Dict[str, str] = {
     "EnrollmentProvider": ".types",
     "EnrollmentStatus": ".types",
     "EnrollmentType": ".types",
+    "Event": ".types",
+    "EventPage": ".types",
+    "EventPagePagination": ".types",
     "EventTypes": ".types",
     "ForbiddenError": ".errors",
     "FunctionSourceDetection": ".types",
@@ -495,6 +503,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "TokenIntent": ".types",
     "TokenIntentExtras": ".types",
     "TokenServiceProviderDetails": ".types",
+    "TooManyRequestsError": ".errors",
     "TransactionStatus": ".types",
     "TransactionType": ".types",
     "UnauthorizedError": ".errors",
@@ -529,6 +538,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "applications": ".applications",
     "documents": ".documents",
     "enrichments": ".enrichments",
+    "events": ".events",
     "google_pay": ".google_pay",
     "keys": ".keys",
     "logs": ".logs",
@@ -660,6 +670,9 @@ __all__ = [
     "EnrollmentProvider",
     "EnrollmentStatus",
     "EnrollmentType",
+    "Event",
+    "EventPage",
+    "EventPagePagination",
     "EventTypes",
     "ForbiddenError",
     "FunctionSourceDetection",
@@ -786,6 +799,7 @@ __all__ = [
     "TokenIntent",
     "TokenIntentExtras",
     "TokenServiceProviderDetails",
+    "TooManyRequestsError",
     "TransactionStatus",
     "TransactionType",
     "UnauthorizedError",
@@ -820,6 +834,7 @@ __all__ = [
     "applications",
     "documents",
     "enrichments",
+    "events",
     "google_pay",
     "keys",
     "logs",

{basistheoryclient-7.2.1 → basistheoryclient-7.3.0}/src/basis_theory/client.py

@@ -20,6 +20,7 @@ if typing.TYPE_CHECKING:
     from .applications.client import ApplicationsClient, AsyncApplicationsClient
     from .documents.client import AsyncDocumentsClient, DocumentsClient
     from .enrichments.client import AsyncEnrichmentsClient, EnrichmentsClient
+    from .events.client import AsyncEventsClient, EventsClient
     from .google_pay.client import AsyncGooglePayClient, GooglePayClient
     from .keys.client import AsyncKeysClient, KeysClient
     from .logs.client import AsyncLogsClient, LogsClient
@@ -136,6 +137,7 @@ class BasisTheory:
         self._sessions: typing.Optional[SessionsClient] = None
         self._token_intents: typing.Optional[TokenIntentsClient] = None
         self._webhooks: typing.Optional[WebhooksClient] = None
+        self._events: typing.Optional[EventsClient] = None
         self._account_updater: typing.Optional[AccountUpdaterClient] = None
         self._agentic: typing.Optional[AgenticClient] = None
         self._tenants: typing.Optional[TenantsClient] = None
@@ -285,6 +287,14 @@ class BasisTheory:
             self._webhooks = WebhooksClient(client_wrapper=self._client_wrapper)
         return self._webhooks
 
+    @property
+    def events(self):
+        if self._events is None:
+            from .events.client import EventsClient  # noqa: E402
+
+            self._events = EventsClient(client_wrapper=self._client_wrapper)
+        return self._events
+
     @property
     def account_updater(self):
         if self._account_updater is None:
@@ -434,6 +444,7 @@ class AsyncBasisTheory:
         self._sessions: typing.Optional[AsyncSessionsClient] = None
         self._token_intents: typing.Optional[AsyncTokenIntentsClient] = None
         self._webhooks: typing.Optional[AsyncWebhooksClient] = None
+        self._events: typing.Optional[AsyncEventsClient] = None
         self._account_updater: typing.Optional[AsyncAccountUpdaterClient] = None
         self._agentic: typing.Optional[AsyncAgenticClient] = None
         self._tenants: typing.Optional[AsyncTenantsClient] = None
@@ -583,6 +594,14 @@ class AsyncBasisTheory:
             self._webhooks = AsyncWebhooksClient(client_wrapper=self._client_wrapper)
         return self._webhooks
 
+    @property
+    def events(self):
+        if self._events is None:
+            from .events.client import AsyncEventsClient  # noqa: E402
+
+            self._events = AsyncEventsClient(client_wrapper=self._client_wrapper)
+        return self._events
+
     @property
     def account_updater(self):
         if self._account_updater is None:

{basistheoryclient-7.2.1 → basistheoryclient-7.3.0}/src/basis_theory/errors/__init__.py

@@ -12,6 +12,7 @@ if typing.TYPE_CHECKING:
     from .internal_server_error import InternalServerError
     from .not_found_error import NotFoundError
     from .service_unavailable_error import ServiceUnavailableError
+    from .too_many_requests_error import TooManyRequestsError
     from .unauthorized_error import UnauthorizedError
     from .unprocessable_entity_error import UnprocessableEntityError
 _dynamic_imports: typing.Dict[str, str] = {
@@ -21,6 +22,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "InternalServerError": ".internal_server_error",
     "NotFoundError": ".not_found_error",
     "ServiceUnavailableError": ".service_unavailable_error",
+    "TooManyRequestsError": ".too_many_requests_error",
     "UnauthorizedError": ".unauthorized_error",
     "UnprocessableEntityError": ".unprocessable_entity_error",
 }
@@ -54,6 +56,7 @@ __all__ = [
     "InternalServerError",
     "NotFoundError",
     "ServiceUnavailableError",
+    "TooManyRequestsError",
     "UnauthorizedError",
     "UnprocessableEntityError",
 ]

basistheoryclient-7.3.0/src/basis_theory/errors/too_many_requests_error.py

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

basistheoryclient-7.3.0/src/basis_theory/events/client.py

@@ -0,0 +1,211 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
+from ..core.request_options import RequestOptions
+from ..types.event import Event
+from ..types.event_page import EventPage
+from .raw_client import AsyncRawEventsClient, RawEventsClient
+
+
+class EventsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawEventsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawEventsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawEventsClient
+        """
+        return self._raw_client
+
+    def list(
+        self,
+        *,
+        start_date: typing.Optional[dt.datetime] = None,
+        end_date: typing.Optional[dt.datetime] = None,
+        start: typing.Optional[str] = None,
+        size: typing.Optional[int] = None,
+        type: typing.Optional[str] = None,
+        trace_id: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SyncPager[Event, EventPage]:
+        """
+        Requires event:read. Tenant identity comes from trusted API-key authentication. History is limited by log_history_limit (24 hours by default, at most 30 days). Windows reaching outside the visible history are clamped to it rather than rejected. No secondary failover or portal JWT support. SDK callers supply data.<path> filters as literal keys through the SDK's per-request query-parameter options, not as a filters request field.
+
+        Parameters
+        ----------
+        start_date : typing.Optional[dt.datetime]
+            Inclusive timestamp; defaults to 24 hours before end_date, shortened to tenant entitlement. An earlier value is raised to the oldest visible instant. ISO 8601 with timezone, at most millisecond precision. Must not be after end_date.
+
+        end_date : typing.Optional[dt.datetime]
+            Exclusive timestamp; defaults to request time. A future value is lowered to request time. A window with no visible history returns an empty page.
+
+        start : typing.Optional[str]
+            Opaque cursor from pagination.next. Bound to tenant, filters, window, page size, and configured collection/index generation.
+
+        size : typing.Optional[int]
+            Maximum unique events returned. A short page may have a next cursor.
+
+        type : typing.Optional[str]
+            Exact event type.
+
+        trace_id : typing.Optional[str]
+            Exact trace ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SyncPager[Event, EventPage]
+            Newest-first event history. Asynchronous visibility; duplicate suppression is page-local. Follow next until null, including short pages. Continuations preserve the first page's clamped bounds while excluding newly expired history or history hidden by an entitlement reduction.
+
+        Examples
+        --------
+        import datetime
+
+        from basis_theory import BasisTheory
+
+        client = BasisTheory(
+            correlation_id="YOUR_CORRELATION_ID",
+            api_key="YOUR_API_KEY",
+        )
+        response = client.events.list(
+            start_date=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            end_date=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            start="start",
+            size=1,
+            type="type",
+            trace_id="trace_id",
+        )
+        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(
+            start_date=start_date,
+            end_date=end_date,
+            start=start,
+            size=size,
+            type=type,
+            trace_id=trace_id,
+            request_options=request_options,
+        )
+
+
+class AsyncEventsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawEventsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawEventsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawEventsClient
+        """
+        return self._raw_client
+
+    async def list(
+        self,
+        *,
+        start_date: typing.Optional[dt.datetime] = None,
+        end_date: typing.Optional[dt.datetime] = None,
+        start: typing.Optional[str] = None,
+        size: typing.Optional[int] = None,
+        type: typing.Optional[str] = None,
+        trace_id: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncPager[Event, EventPage]:
+        """
+        Requires event:read. Tenant identity comes from trusted API-key authentication. History is limited by log_history_limit (24 hours by default, at most 30 days). Windows reaching outside the visible history are clamped to it rather than rejected. No secondary failover or portal JWT support. SDK callers supply data.<path> filters as literal keys through the SDK's per-request query-parameter options, not as a filters request field.
+
+        Parameters
+        ----------
+        start_date : typing.Optional[dt.datetime]
+            Inclusive timestamp; defaults to 24 hours before end_date, shortened to tenant entitlement. An earlier value is raised to the oldest visible instant. ISO 8601 with timezone, at most millisecond precision. Must not be after end_date.
+
+        end_date : typing.Optional[dt.datetime]
+            Exclusive timestamp; defaults to request time. A future value is lowered to request time. A window with no visible history returns an empty page.
+
+        start : typing.Optional[str]
+            Opaque cursor from pagination.next. Bound to tenant, filters, window, page size, and configured collection/index generation.
+
+        size : typing.Optional[int]
+            Maximum unique events returned. A short page may have a next cursor.
+
+        type : typing.Optional[str]
+            Exact event type.
+
+        trace_id : typing.Optional[str]
+            Exact trace ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncPager[Event, EventPage]
+            Newest-first event history. Asynchronous visibility; duplicate suppression is page-local. Follow next until null, including short pages. Continuations preserve the first page's clamped bounds while excluding newly expired history or history hidden by an entitlement reduction.
+
+        Examples
+        --------
+        import asyncio
+        import datetime
+
+        from basis_theory import AsyncBasisTheory
+
+        client = AsyncBasisTheory(
+            correlation_id="YOUR_CORRELATION_ID",
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            response = await client.events.list(
+                start_date=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                end_date=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                start="start",
+                size=1,
+                type="type",
+                trace_id="trace_id",
+            )
+            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(
+            start_date=start_date,
+            end_date=end_date,
+            start=start,
+            size=size,
+            type=type,
+            trace_id=trace_id,
+            request_options=request_options,
+        )