feat(client): adds support for on-demand Auth Rule Performance Reports

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 161
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-67859c948e3b903a317f4bd14135c7ee44254d2760068117bab34b7c4058be71.yml
-openapi_spec_hash: 23a4716c6168e96f040ac8575582d075
-config_hash: 227ad54062905d4ae964b24cef0505b0
+configured_endpoints: 164
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-a0d3bcd9c54616729a7e43847e3134205e0695d78f357cc7a25c2775b588dbbd.yml
+openapi_spec_hash: 36c423c286ca426f7510b27fadbdd66f
+config_hash: 56632a1c934324aa46c1e5c610c2de85

api.md

@@ -83,6 +83,7 @@ from lithic.types.auth_rules import (
     AuthRuleCondition,
     ConditionalAttribute,
     ConditionalBlockParameters,
+    RuleStats,
     VelocityLimitParams,
     VelocityLimitParamsPeriodWindow,
     V2CreateResponse,
@@ -93,6 +94,7 @@ from lithic.types.auth_rules import (
     V2DraftResponse,
     V2PromoteResponse,
     V2ReportResponse,
+    V2RetrieveReportResponse,
 )
 ```
 
@@ -107,6 +109,7 @@ Methods:
 - <code title="post /v2/auth_rules/{auth_rule_token}/draft">client.auth_rules.v2.<a href="./src/lithic/resources/auth_rules/v2/v2.py">draft</a>(auth_rule_token, \*\*<a href="src/lithic/types/auth_rules/v2_draft_params.py">params</a>) -> <a href="./src/lithic/types/auth_rules/v2_draft_response.py">V2DraftResponse</a></code>
 - <code title="post /v2/auth_rules/{auth_rule_token}/promote">client.auth_rules.v2.<a href="./src/lithic/resources/auth_rules/v2/v2.py">promote</a>(auth_rule_token) -> <a href="./src/lithic/types/auth_rules/v2_promote_response.py">V2PromoteResponse</a></code>
 - <code title="post /v2/auth_rules/{auth_rule_token}/report">client.auth_rules.v2.<a href="./src/lithic/resources/auth_rules/v2/v2.py">report</a>(auth_rule_token) -> <a href="./src/lithic/types/auth_rules/v2_report_response.py">V2ReportResponse</a></code>
+- <code title="get /v2/auth_rules/{auth_rule_token}/report">client.auth_rules.v2.<a href="./src/lithic/resources/auth_rules/v2/v2.py">retrieve_report</a>(auth_rule_token, \*\*<a href="src/lithic/types/auth_rules/v2_retrieve_report_params.py">params</a>) -> <a href="./src/lithic/types/auth_rules/v2_retrieve_report_response.py">V2RetrieveReportResponse</a></code>
 
 ### Backtests
 
@@ -723,3 +726,18 @@ Methods:
 - <code title="get /v1/funding_events/{funding_event_token}">client.funding_events.<a href="./src/lithic/resources/funding_events.py">retrieve</a>(funding_event_token) -> <a href="./src/lithic/types/funding_event_retrieve_response.py">FundingEventRetrieveResponse</a></code>
 - <code title="get /v1/funding_events">client.funding_events.<a href="./src/lithic/resources/funding_events.py">list</a>(\*\*<a href="src/lithic/types/funding_event_list_params.py">params</a>) -> <a href="./src/lithic/types/funding_event_list_response.py">SyncCursorPage[FundingEventListResponse]</a></code>
 - <code title="get /v1/funding_events/{funding_event_token}/details">client.funding_events.<a href="./src/lithic/resources/funding_events.py">retrieve_details</a>(funding_event_token) -> <a href="./src/lithic/types/funding_event_retrieve_details_response.py">FundingEventRetrieveDetailsResponse</a></code>
+
+# Fraud
+
+## Transactions
+
+Types:
+
+```python
+from lithic.types.fraud import TransactionRetrieveResponse, TransactionReportResponse
+```
+
+Methods:
+
+- <code title="get /v1/fraud/transactions/{transaction_token}">client.fraud.transactions.<a href="./src/lithic/resources/fraud/transactions.py">retrieve</a>(transaction_token) -> <a href="./src/lithic/types/fraud/transaction_retrieve_response.py">TransactionRetrieveResponse</a></code>
+- <code title="post /v1/fraud/transactions/{transaction_token}">client.fraud.transactions.<a href="./src/lithic/resources/fraud/transactions.py">report</a>(transaction_token, \*\*<a href="src/lithic/types/fraud/transaction_report_params.py">params</a>) -> <a href="./src/lithic/types/fraud/transaction_report_response.py">TransactionReportResponse</a></code>

src/lithic/_client.py

@@ -39,6 +39,7 @@
 if TYPE_CHECKING:
     from .resources import (
         cards,
+        fraud,
         events,
         reports,
         accounts,
@@ -69,6 +70,7 @@
     from .resources.disputes import Disputes, AsyncDisputes
     from .resources.payments import Payments, AsyncPayments
     from .resources.cards.cards import Cards, AsyncCards
+    from .resources.fraud.fraud import Fraud, AsyncFraud
     from .resources.card_programs import CardPrograms, AsyncCardPrograms
     from .resources.events.events import Events, AsyncEvents
     from .resources.tokenizations import Tokenizations, AsyncTokenizations
@@ -345,6 +347,12 @@ def funding_events(self) -> FundingEvents:
 
         return FundingEvents(self)
 
+    @cached_property
+    def fraud(self) -> Fraud:
+        from .resources.fraud import Fraud
+
+        return Fraud(self)
+
     @cached_property
     def with_raw_response(self) -> LithicWithRawResponse:
         return LithicWithRawResponse(self)
@@ -719,6 +727,12 @@ def funding_events(self) -> AsyncFundingEvents:
 
         return AsyncFundingEvents(self)
 
+    @cached_property
+    def fraud(self) -> AsyncFraud:
+        from .resources.fraud import AsyncFraud
+
+        return AsyncFraud(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncLithicWithRawResponse:
         return AsyncLithicWithRawResponse(self)
@@ -1016,6 +1030,12 @@ def funding_events(self) -> funding_events.FundingEventsWithRawResponse:
 
         return FundingEventsWithRawResponse(self._client.funding_events)
 
+    @cached_property
+    def fraud(self) -> fraud.FraudWithRawResponse:
+        from .resources.fraud import FraudWithRawResponse
+
+        return FraudWithRawResponse(self._client.fraud)
+
 
 class AsyncLithicWithRawResponse:
     _client: AsyncLithic
@@ -1177,6 +1197,12 @@ def funding_events(self) -> funding_events.AsyncFundingEventsWithRawResponse:
 
         return AsyncFundingEventsWithRawResponse(self._client.funding_events)
 
+    @cached_property
+    def fraud(self) -> fraud.AsyncFraudWithRawResponse:
+        from .resources.fraud import AsyncFraudWithRawResponse
+
+        return AsyncFraudWithRawResponse(self._client.fraud)
+
 
 class LithicWithStreamedResponse:
     _client: Lithic
@@ -1338,6 +1364,12 @@ def funding_events(self) -> funding_events.FundingEventsWithStreamingResponse:
 
         return FundingEventsWithStreamingResponse(self._client.funding_events)
 
+    @cached_property
+    def fraud(self) -> fraud.FraudWithStreamingResponse:
+        from .resources.fraud import FraudWithStreamingResponse
+
+        return FraudWithStreamingResponse(self._client.fraud)
+
 
 class AsyncLithicWithStreamedResponse:
     _client: AsyncLithic
@@ -1499,6 +1531,12 @@ def funding_events(self) -> funding_events.AsyncFundingEventsWithStreamingRespon
 
         return AsyncFundingEventsWithStreamingResponse(self._client.funding_events)
 
+    @cached_property
+    def fraud(self) -> fraud.AsyncFraudWithStreamingResponse:
+        from .resources.fraud import AsyncFraudWithStreamingResponse
+
+        return AsyncFraudWithStreamingResponse(self._client.fraud)
+
 
 Client = Lithic
 

src/lithic/resources/__init__.py

@@ -8,6 +8,14 @@
     CardsWithStreamingResponse,
     AsyncCardsWithStreamingResponse,
 )
+from .fraud import (
+    Fraud,
+    AsyncFraud,
+    FraudWithRawResponse,
+    AsyncFraudWithRawResponse,
+    FraudWithStreamingResponse,
+    AsyncFraudWithStreamingResponse,
+)
 from .events import (
     Events,
     AsyncEvents,
@@ -352,4 +360,10 @@
     "AsyncFundingEventsWithRawResponse",
     "FundingEventsWithStreamingResponse",
     "AsyncFundingEventsWithStreamingResponse",
+    "Fraud",
+    "AsyncFraud",
+    "FraudWithRawResponse",
+    "AsyncFraudWithRawResponse",
+    "FraudWithStreamingResponse",
+    "AsyncFraudWithStreamingResponse",
 ]

src/lithic/resources/auth_rules/v2/backtests.py

@@ -72,13 +72,14 @@ def create(
         `/v2/auth_rules/{auth_rule_token}/backtests/{auth_rule_backtest_token}`
         endpoint.
 
-        Lithic currently supports backtesting for `CONDITIONAL_BLOCK` rules. Backtesting
-        for `VELOCITY_LIMIT` rules is generally not supported. In specific cases (i.e.
-        where Lithic has pre-calculated the requested velocity metrics for historical
-        transactions), a backtest may be feasible. However, such cases are uncommon and
-        customers should not anticipate support for velocity backtests under most
-        configurations. If a historical transaction does not feature the required inputs
-        to evaluate the rule, then it will not be included in the final backtest report.
+        Lithic currently supports backtesting for `CONDITIONAL_BLOCK` /
+        `CONDITIONAL_3DS_ACTION` rules. Backtesting for `VELOCITY_LIMIT` rules is
+        generally not supported. In specific cases (i.e. where Lithic has pre-calculated
+        the requested velocity metrics for historical transactions), a backtest may be
+        feasible. However, such cases are uncommon and customers should not anticipate
+        support for velocity backtests under most configurations. If a historical
+        transaction does not feature the required inputs to evaluate the rule, then it
+        will not be included in the final backtest report.
 
         Args:
           end: The end time of the backtest.
@@ -217,13 +218,14 @@ async def create(
         `/v2/auth_rules/{auth_rule_token}/backtests/{auth_rule_backtest_token}`
         endpoint.
 
-        Lithic currently supports backtesting for `CONDITIONAL_BLOCK` rules. Backtesting
-        for `VELOCITY_LIMIT` rules is generally not supported. In specific cases (i.e.
-        where Lithic has pre-calculated the requested velocity metrics for historical
-        transactions), a backtest may be feasible. However, such cases are uncommon and
-        customers should not anticipate support for velocity backtests under most
-        configurations. If a historical transaction does not feature the required inputs
-        to evaluate the rule, then it will not be included in the final backtest report.
+        Lithic currently supports backtesting for `CONDITIONAL_BLOCK` /
+        `CONDITIONAL_3DS_ACTION` rules. Backtesting for `VELOCITY_LIMIT` rules is
+        generally not supported. In specific cases (i.e. where Lithic has pre-calculated
+        the requested velocity metrics for historical transactions), a backtest may be
+        feasible. However, such cases are uncommon and customers should not anticipate
+        support for velocity backtests under most configurations. If a historical
+        transaction does not feature the required inputs to evaluate the rule, then it
+        will not be included in the final backtest report.
 
         Args:
           end: The end time of the backtest.