stytch 10.41.0 → 10.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 772200fdaff7982e55a0c81c0800899f68d4d5883cc70c69fdddd9eb0a980239
-  data.tar.gz: 56d73d13e822be0a613f1cf9449e1ba68bb8e86c4b91068e8b947cf7cf560379
+  metadata.gz: a9ec5299338703e2955b430042eb3abf11dca6474be1478e91faca5ecc5b7196
+  data.tar.gz: eaa3ad45194052e3a5a1734b5192d670ec04302b7b5194ec8a2128553ca4e8b0
 SHA512:
-  metadata.gz: e6887efb099ca71afc2c00a9a40a9be303dffadb7f9abd0144873de5b4270ca79bc35fb8f98e44e64019a59e1dc8a2800b6269a12beabd905b471fc6d7c012b4
-  data.tar.gz: 3ff2c30dec6127429eb20b2751b807a534930471d08960ffee21acb5b2c8356db664ee125c9cc8e84bb22b34fc15d9bc551f8943d355c4814f340bbf0948ef67
+  metadata.gz: f48a0d7fcc636ca833de1895bc5f0594a9d8559196a0b4a7b0992b67465e75578aacace17be36a908fa6fd417d84a29a07f00cdafa13472ee43301b03321437d
+  data.tar.gz: da2f334d10213ff40aedaa934215e2b2c2cae6d2e9931db4c01f3ac8fa54a1ce10e40560d12eaacaa2ca162b632bc58fc494ef846c03e8207d95136094b843e2

data/lib/stytch/fraud.rb

@@ -11,7 +11,7 @@ require_relative 'request_helper'
 module Stytch
   class Fraud
     include Stytch::RequestHelper
-    attr_reader :fingerprint, :rules, :verdict_reasons
+    attr_reader :fingerprint, :rules, :verdict_reasons, :email
 
     def initialize(connection)
       @connection = connection
@@ -19,6 +19,7 @@ module Stytch
       @fingerprint = Stytch::Fraud::Fingerprint.new(@connection)
       @rules = Stytch::Fraud::Rules.new(@connection)
       @verdict_reasons = Stytch::Fraud::VerdictReasons.new(@connection)
+      @email = Stytch::Fraud::Email.new(@connection)
     end
 
     class Fingerprint
@@ -336,5 +337,59 @@ module Stytch
         post_request('/v1/verdict_reasons/list', request, headers)
       end
     end
+
+    class Email
+      include Stytch::RequestHelper
+
+      def initialize(connection)
+        @connection = connection
+      end
+
+      # Get risk information for a specific email address.
+      # The response will contain a recommended action (`ALLOW`, `BLOCK`, or `CHALLENGE`) and a more granular `risk_score`.
+      # You can also check the `address_information` and `domain_information` fields for more information about the email address and email domain.
+      #
+      # This feature is in beta. Reach out to us [here](mailto:fraud-team@stytch.com?subject=Email_Intelligence_Early_Access) if you'd like to request early access.
+      #
+      # == Parameters:
+      # email_address::
+      #   The email address to check.
+      #   The type of this field is +String+.
+      #
+      # == Returns:
+      # An object with the following fields:
+      # request_id::
+      #   Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.
+      #   The type of this field is +String+.
+      # address_information::
+      #   Information about the email address.
+      #   The type of this field is +AddressInformation+ (+object+).
+      # domain_information::
+      #   Information about the email domain.
+      #   The type of this field is +DomainInformation+ (+object+).
+      # action::
+      #   The suggested action based on the attributes of the email address. The available actions are:
+      #   * `ALLOW` - This email is most likely safe to send to and not fraudulent.
+      #   * `BLOCK` - This email is invalid or exhibits signs of fraud. We recommend blocking the end user.
+      #   * `CHALLENGE` - This email has some potentially fraudulent attributes. We recommend increased friction such as 2FA or other forms of extended user verification before allowing the privileged action to proceed.
+      #
+      #   The type of this field is +RiskResponseAction+ (string enum).
+      # risk_score::
+      #   A score from 0 to 100 indicating how risky the email is. 100 is the most risky.
+      #   The type of this field is +Integer+.
+      # status_code::
+      #   The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.
+      #   The type of this field is +Integer+.
+      def risk(
+        email_address:
+      )
+        headers = {}
+        request = {
+          email_address: email_address
+        }
+
+        post_request('/v1/email/risk', request, headers)
+      end
+    end
   end
 end

data/lib/stytch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stytch
-  VERSION = '10.41.0'
+  VERSION = '10.42.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stytch
 version: !ruby/object:Gem::Version
-  version: 10.41.0
+  version: 10.42.0
 platform: ruby
 authors:
 - stytch
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-16 00:00:00.000000000 Z
+date: 2026-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday