feat(api): add action_counts to rule performance reports and code to authorization actions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 184
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-a45946df228eec554b3cd2491f658bd5a45cb91509da0a9f92d50468ea88072f.yml
-openapi_spec_hash: 24c7c13e1e7385cab5442ca66091ffc6
-config_hash: 50031f78031362c2e4900222b9ce7ada
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-b29a4bd5ca21348ef426162cbd1fa21070f695572626e4e6faabfa14af38f0b0.yml
+openapi_spec_hash: e7c285d6b7006d040ecb50a9d0d2fc17
+config_hash: fb5070d41fcabdedbc084b83964b592a

api.md

@@ -96,6 +96,7 @@ Types:
 from lithic.types.auth_rules import (
     AuthRule,
     AuthRuleCondition,
+    BacktestStats,
     Conditional3DSActionParameters,
     ConditionalACHActionParameters,
     ConditionalAttribute,
@@ -106,7 +107,7 @@ from lithic.types.auth_rules import (
     ConditionalValue,
     EventStream,
     MerchantLockParameters,
-    RuleStats,
+    ReportStats,
     VelocityLimitParams,
     VelocityLimitPeriod,
     V2ListResultsResponse,

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

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Any, List, Union, Optional, cast
-from datetime import date
+from datetime import date, datetime
 from typing_extensions import Literal, overload
 
 import httpx
@@ -634,6 +634,8 @@ def list_results(
         self,
         *,
         auth_rule_token: str | Omit = omit,
+        begin: Union[str, datetime] | Omit = omit,
+        end: Union[str, datetime] | Omit = omit,
         ending_before: str | Omit = omit,
         event_token: str | Omit = omit,
         has_actions: bool | Omit = omit,
@@ -658,6 +660,12 @@ def list_results(
         Args:
           auth_rule_token: Filter by Auth Rule token
 
+          begin: Date string in RFC 3339 format. Only events evaluated after the specified time
+              will be included. UTC time zone.
+
+          end: Date string in RFC 3339 format. Only events evaluated before the specified time
+              will be included. UTC time zone.
+
           ending_before: A cursor representing an item's token before which a page of results should end.
               Used to retrieve the previous page of results before this item.
 
@@ -690,6 +698,8 @@ def list_results(
                 query=maybe_transform(
                     {
                         "auth_rule_token": auth_rule_token,
+                        "begin": begin,
+                        "end": end,
                         "ending_before": ending_before,
                         "event_token": event_token,
                         "has_actions": has_actions,
@@ -1442,6 +1452,8 @@ def list_results(
         self,
         *,
         auth_rule_token: str | Omit = omit,
+        begin: Union[str, datetime] | Omit = omit,
+        end: Union[str, datetime] | Omit = omit,
         ending_before: str | Omit = omit,
         event_token: str | Omit = omit,
         has_actions: bool | Omit = omit,
@@ -1466,6 +1478,12 @@ def list_results(
         Args:
           auth_rule_token: Filter by Auth Rule token
 
+          begin: Date string in RFC 3339 format. Only events evaluated after the specified time
+              will be included. UTC time zone.
+
+          end: Date string in RFC 3339 format. Only events evaluated before the specified time
+              will be included. UTC time zone.
+
           ending_before: A cursor representing an item's token before which a page of results should end.
               Used to retrieve the previous page of results before this item.
 
@@ -1498,6 +1516,8 @@ def list_results(
                 query=maybe_transform(
                     {
                         "auth_rule_token": auth_rule_token,
+                        "begin": begin,
+                        "end": end,
                         "ending_before": ending_before,
                         "event_token": event_token,
                         "has_actions": has_actions,

src/lithic/types/auth_rules/__init__.py

@@ -3,8 +3,9 @@
 from __future__ import annotations
 
 from .auth_rule import AuthRule as AuthRule
-from .rule_stats import RuleStats as RuleStats
 from .event_stream import EventStream as EventStream
+from .report_stats import ReportStats as ReportStats
+from .backtest_stats import BacktestStats as BacktestStats
 from .v2_list_params import V2ListParams as V2ListParams
 from .v2_draft_params import V2DraftParams as V2DraftParams
 from .v2_create_params import V2CreateParams as V2CreateParams

src/lithic/types/auth_rules/rule_stats.py …ithic/types/auth_rules/backtest_stats.pysrc/lithic/types/auth_rules/rule_stats.py renamed to src/lithic/types/auth_rules/backtest_stats.py src/lithic/types/auth_rules/rule_stats.py renamed to src/lithic/types/auth_rules/backtest_stats.py

@@ -6,13 +6,10 @@
 
 from ..._models import BaseModel
 
-__all__ = ["RuleStats", "Example"]
+__all__ = ["BacktestStats", "Example"]
 
 
 class Example(BaseModel):
-    approved: Optional[bool] = None
-    """Whether the rule would have approved the request."""
-
     decision: Optional[Literal["APPROVED", "DECLINED", "CHALLENGED"]] = None
     """The decision made by the rule for this event."""
 
@@ -23,26 +20,26 @@ class Example(BaseModel):
     """The timestamp of the event."""
 
 
-class RuleStats(BaseModel):
+class BacktestStats(BaseModel):
     approved: Optional[int] = None
     """
     The total number of historical transactions approved by this rule during the
-    relevant period, or the number of transactions that would have been approved if
+    backtest period, or the number of transactions that would have been approved if
     the rule was evaluated in shadow mode.
     """
 
     challenged: Optional[int] = None
     """
     The total number of historical transactions challenged by this rule during the
-    relevant period, or the number of transactions that would have been challenged
+    backtest period, or the number of transactions that would have been challenged
     if the rule was evaluated in shadow mode. Currently applicable only for 3DS Auth
     Rules.
     """
 
     declined: Optional[int] = None
     """
     The total number of historical transactions declined by this rule during the
-    relevant period, or the number of transactions that would have been declined if
+    backtest period, or the number of transactions that would have been declined if
     the rule was evaluated in shadow mode.
     """
 

src/lithic/types/auth_rules/conditional_ach_action_parameters.py

@@ -7,10 +7,10 @@
 from .conditional_value import ConditionalValue
 from .conditional_operation import ConditionalOperation
 
-__all__ = ["ConditionalACHActionParameters", "Action", "ActionApproveAction", "ActionReturnAction", "Condition"]
+__all__ = ["ConditionalACHActionParameters", "Action", "ActionApproveActionACH", "ActionReturnAction", "Condition"]
 
 
-class ActionApproveAction(BaseModel):
+class ActionApproveActionACH(BaseModel):
     type: Literal["APPROVE"]
     """Approve the ACH transaction"""
 
@@ -98,7 +98,7 @@ class ActionReturnAction(BaseModel):
     """Return the ACH transaction"""
 
 
-Action: TypeAlias = Union[ActionApproveAction, ActionReturnAction]
+Action: TypeAlias = Union[ActionApproveActionACH, ActionReturnAction]
 
 
 class Condition(BaseModel):

src/lithic/types/auth_rules/conditional_ach_action_parameters_param.py

@@ -9,10 +9,10 @@
 from .conditional_operation import ConditionalOperation
 from .conditional_value_param import ConditionalValueParam
 
-__all__ = ["ConditionalACHActionParametersParam", "Action", "ActionApproveAction", "ActionReturnAction", "Condition"]
+__all__ = ["ConditionalACHActionParametersParam", "Action", "ActionApproveActionACH", "ActionReturnAction", "Condition"]
 
 
-class ActionApproveAction(TypedDict, total=False):
+class ActionApproveActionACH(TypedDict, total=False):
     type: Required[Literal["APPROVE"]]
     """Approve the ACH transaction"""
 
@@ -102,7 +102,7 @@ class ActionReturnAction(TypedDict, total=False):
     """Return the ACH transaction"""
 
 
-Action: TypeAlias = Union[ActionApproveAction, ActionReturnAction]
+Action: TypeAlias = Union[ActionApproveActionACH, ActionReturnAction]
 
 
 class Condition(TypedDict, total=False):

src/lithic/types/auth_rules/conditional_tokenization_action_parameters.py

@@ -10,13 +10,13 @@
 __all__ = [
     "ConditionalTokenizationActionParameters",
     "Action",
-    "ActionDeclineAction",
+    "ActionDeclineActionTokenization",
     "ActionRequireTfaAction",
     "Condition",
 ]
 
 
-class ActionDeclineAction(BaseModel):
+class ActionDeclineActionTokenization(BaseModel):
     type: Literal["DECLINE"]
     """Decline the tokenization request"""
 
@@ -66,7 +66,7 @@ class ActionRequireTfaAction(BaseModel):
     """Reason code for requiring two-factor authentication"""
 
 
-Action: TypeAlias = Union[ActionDeclineAction, ActionRequireTfaAction]
+Action: TypeAlias = Union[ActionDeclineActionTokenization, ActionRequireTfaAction]
 
 
 class Condition(BaseModel):

src/lithic/types/auth_rules/conditional_tokenization_action_parameters_param.py

@@ -12,13 +12,13 @@
 __all__ = [
     "ConditionalTokenizationActionParametersParam",
     "Action",
-    "ActionDeclineAction",
+    "ActionDeclineActionTokenization",
     "ActionRequireTfaAction",
     "Condition",
 ]
 
 
-class ActionDeclineAction(TypedDict, total=False):
+class ActionDeclineActionTokenization(TypedDict, total=False):
     type: Required[Literal["DECLINE"]]
     """Decline the tokenization request"""
 
@@ -64,7 +64,7 @@ class ActionRequireTfaAction(TypedDict, total=False):
     """Reason code for requiring two-factor authentication"""
 
 
-Action: TypeAlias = Union[ActionDeclineAction, ActionRequireTfaAction]
+Action: TypeAlias = Union[ActionDeclineActionTokenization, ActionRequireTfaAction]
 
 
 class Condition(TypedDict, total=False):