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

Author: stainless-app[bot]

.stats.yml

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

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClient.kt

@@ -24,6 +24,7 @@ import com.lithic.api.services.blocking.EventService
 import com.lithic.api.services.blocking.ExternalBankAccountService
 import com.lithic.api.services.blocking.ExternalPaymentService
 import com.lithic.api.services.blocking.FinancialAccountService
+import com.lithic.api.services.blocking.FraudService
 import com.lithic.api.services.blocking.FundingEventService
 import com.lithic.api.services.blocking.ManagementOperationService
 import com.lithic.api.services.blocking.PaymentService
@@ -127,6 +128,8 @@ interface LithicClient {
 
     fun fundingEvents(): FundingEventService
 
+    fun fraud(): FraudService
+
     /** Status of api */
     fun apiStatus(): ApiStatus = apiStatus(ClientApiStatusParams.none())
 
@@ -219,6 +222,8 @@ interface LithicClient {
 
         fun fundingEvents(): FundingEventService.WithRawResponse
 
+        fun fraud(): FraudService.WithRawResponse
+
         /**
          * Returns a raw HTTP response for `get /v1/status`, but is otherwise the same as
          * [LithicClient.apiStatus].

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsync.kt

@@ -23,6 +23,7 @@ import com.lithic.api.services.async.EventServiceAsync
 import com.lithic.api.services.async.ExternalBankAccountServiceAsync
 import com.lithic.api.services.async.ExternalPaymentServiceAsync
 import com.lithic.api.services.async.FinancialAccountServiceAsync
+import com.lithic.api.services.async.FraudServiceAsync
 import com.lithic.api.services.async.FundingEventServiceAsync
 import com.lithic.api.services.async.ManagementOperationServiceAsync
 import com.lithic.api.services.async.PaymentServiceAsync
@@ -127,6 +128,8 @@ interface LithicClientAsync {
 
     fun fundingEvents(): FundingEventServiceAsync
 
+    fun fraud(): FraudServiceAsync
+
     /** Status of api */
     fun apiStatus(): CompletableFuture<ApiStatus> = apiStatus(ClientApiStatusParams.none())
 
@@ -222,6 +225,8 @@ interface LithicClientAsync {
 
         fun fundingEvents(): FundingEventServiceAsync.WithRawResponse
 
+        fun fraud(): FraudServiceAsync.WithRawResponse
+
         /**
          * Returns a raw HTTP response for `get /v1/status`, but is otherwise the same as
          * [LithicClientAsync.apiStatus].

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientAsyncImpl.kt

@@ -49,6 +49,8 @@ import com.lithic.api.services.async.ExternalPaymentServiceAsync
 import com.lithic.api.services.async.ExternalPaymentServiceAsyncImpl
 import com.lithic.api.services.async.FinancialAccountServiceAsync
 import com.lithic.api.services.async.FinancialAccountServiceAsyncImpl
+import com.lithic.api.services.async.FraudServiceAsync
+import com.lithic.api.services.async.FraudServiceAsyncImpl
 import com.lithic.api.services.async.FundingEventServiceAsync
 import com.lithic.api.services.async.FundingEventServiceAsyncImpl
 import com.lithic.api.services.async.ManagementOperationServiceAsync
@@ -195,6 +197,10 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
         FundingEventServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
+    private val fraud: FraudServiceAsync by lazy {
+        FraudServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
+
     override fun sync(): LithicClient = sync
 
     override fun withRawResponse(): LithicClientAsync.WithRawResponse = withRawResponse
@@ -257,6 +263,8 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
     override fun fundingEvents(): FundingEventServiceAsync = fundingEvents
 
+    override fun fraud(): FraudServiceAsync = fraud
+
     override fun apiStatus(
         params: ClientApiStatusParams,
         requestOptions: RequestOptions,
@@ -376,6 +384,10 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
             FundingEventServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val fraud: FraudServiceAsync.WithRawResponse by lazy {
+            FraudServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
         ): LithicClientAsync.WithRawResponse =
@@ -443,6 +455,8 @@ class LithicClientAsyncImpl(private val clientOptions: ClientOptions) : LithicCl
 
         override fun fundingEvents(): FundingEventServiceAsync.WithRawResponse = fundingEvents
 
+        override fun fraud(): FraudServiceAsync.WithRawResponse = fraud
+
         private val apiStatusHandler: Handler<ApiStatus> =
             jsonHandler<ApiStatus>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
 

lithic-java-core/src/main/kotlin/com/lithic/api/client/LithicClientImpl.kt

@@ -49,6 +49,8 @@ import com.lithic.api.services.blocking.ExternalPaymentService
 import com.lithic.api.services.blocking.ExternalPaymentServiceImpl
 import com.lithic.api.services.blocking.FinancialAccountService
 import com.lithic.api.services.blocking.FinancialAccountServiceImpl
+import com.lithic.api.services.blocking.FraudService
+import com.lithic.api.services.blocking.FraudServiceImpl
 import com.lithic.api.services.blocking.FundingEventService
 import com.lithic.api.services.blocking.FundingEventServiceImpl
 import com.lithic.api.services.blocking.ManagementOperationService
@@ -180,6 +182,8 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
         FundingEventServiceImpl(clientOptionsWithUserAgent)
     }
 
+    private val fraud: FraudService by lazy { FraudServiceImpl(clientOptionsWithUserAgent) }
+
     override fun async(): LithicClientAsync = async
 
     override fun withRawResponse(): LithicClient.WithRawResponse = withRawResponse
@@ -241,6 +245,8 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
     override fun fundingEvents(): FundingEventService = fundingEvents
 
+    override fun fraud(): FraudService = fraud
+
     override fun apiStatus(
         params: ClientApiStatusParams,
         requestOptions: RequestOptions,
@@ -360,6 +366,10 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
             FundingEventServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val fraud: FraudService.WithRawResponse by lazy {
+            FraudServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
         ): LithicClient.WithRawResponse =
@@ -426,6 +436,8 @@ class LithicClientImpl(private val clientOptions: ClientOptions) : LithicClient
 
         override fun fundingEvents(): FundingEventService.WithRawResponse = fundingEvents
 
+        override fun fraud(): FraudService.WithRawResponse = fraud
+
         private val apiStatusHandler: Handler<ApiStatus> =
             jsonHandler<ApiStatus>(clientOptions.jsonMapper).withErrorHandler(errorHandler)
 

lithic-java-core/src/main/kotlin/com/lithic/api/models/AuthRuleV2BacktestCreateParams.kt

@@ -36,10 +36,10 @@ import kotlin.jvm.optionals.getOrNull
  * backtest reports on-demand through the
  * `/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
+ * 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.
  */

lithic-java-core/src/main/kotlin/com/lithic/api/models/AuthRuleV2ReportParams.kt

@@ -12,10 +12,11 @@ import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /**
- * Requests a performance report of an Auth rule to be asynchronously generated. Reports can only be
- * run on rules in draft or active mode and will included approved and declined statistics as well
- * as examples. The generated report will be delivered asynchronously through a webhook with
- * `event_type` = `auth_rules.performance_report.created`. See the docs on setting up
+ * This endpoint is deprecated and will be removed in the future. Requests a performance report of
+ * an Auth rule to be asynchronously generated. Reports can only be run on rules in draft or active
+ * mode and will included approved and declined statistics as well as examples. The generated report
+ * will be delivered asynchronously through a webhook with `event_type` =
+ * `auth_rules.performance_report.created`. See the docs on setting up
  * [webhook subscriptions](https://docs.lithic.com/docs/events-api).
  *
  * Reports are generated based on data collected by Lithic's processing system in the trailing week.
@@ -55,6 +56,7 @@ import kotlin.jvm.optionals.getOrNull
  * processing systems have processed the transaction, and when a transaction will be included in the
  * report.
  */
+@Deprecated("deprecated")
 class AuthRuleV2ReportParams
 private constructor(
     private val authRuleToken: String?,