noresponse 7.1.7 → 7.1.8

data/lib/no_response/models/shared/footprinttimeline.rb

@@ -0,0 +1,82 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # One identifier's dated footprint across every source: the first and last year any event was seen, the years between them, the latest year a source dated activity (omitted when none did), how many distinct sites and which kinds of evidence saw it.
+      class FootprintTimeline
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        field(
+          :first_seen_year,
+          ::Integer,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("first_seen_year"), required: true}}
+        )
+
+        field(
+          :last_seen_year,
+          ::Integer,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("last_seen_year"), required: true}}
+        )
+
+        field(
+          :span_years,
+          ::Integer,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("span_years"), required: true}}
+        )
+
+        field(
+          :sites,
+          ::Integer,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("sites"), required: true}}
+        )
+
+        field(
+          :families,
+          Crystalline::Array.new(Models::Shared::FootprintFamily),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("families"), required: true}}
+        )
+
+        field(
+          :last_active_year,
+          Crystalline::Nilable.new(::Integer),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("last_active_year")}}
+        )
+
+        sig {
+          params(
+            first_seen_year: ::Integer,
+            last_seen_year: ::Integer,
+            span_years: ::Integer,
+            sites: ::Integer,
+            families: T::Array[Models::Shared::FootprintFamily],
+            last_active_year: T.nilable(::Integer)
+          )
+            .void
+        }
+        def initialize(first_seen_year:, last_seen_year:, span_years:, sites:, families:, last_active_year: nil)
+          @first_seen_year = first_seen_year
+          @last_seen_year = last_seen_year
+          @span_years = span_years
+          @sites = sites
+          @families = families
+          @last_active_year = last_active_year
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          return false unless @first_seen_year == other.first_seen_year
+          return false unless @last_seen_year == other.last_seen_year
+          return false unless @span_years == other.span_years
+          return false unless @sites == other.sites
+          return false unless @families == other.families
+          return false unless @last_active_year == other.last_active_year
+          true
+        end
+      end
+    end
+  end
+end

data/lib/no_response/models/shared/footprinttimeline.rbi

@@ -0,0 +1,44 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::FootprintTimeline
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::FootprintTimeline
+  def first_seen_year
+  end
+
+  def first_seen_year=(str_)
+  end
+
+  def last_seen_year
+  end
+
+  def last_seen_year=(str_)
+  end
+
+  def span_years
+  end
+
+  def span_years=(str_)
+  end
+
+  def sites
+  end
+
+  def sites=(str_)
+  end
+
+  def families
+  end
+
+  def families=(str_)
+  end
+
+  def last_active_year
+  end
+
+  def last_active_year=(str_)
+  end
+end

data/lib/no_response/models/shared/identifier.rb

@@ -0,0 +1,19 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+
+      class Identifier
+        include ::Crystalline::Enum
+        enums do
+          EMAIL = new("email")
+          USERNAME = new("username")
+        end
+
+        open!
+      end
+    end
+  end
+end

data/lib/no_response/models/shared/identifier.rbi

@@ -0,0 +1,9 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::Identifier
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::Identifier
+end

data/lib/no_response/models/shared/impact.rb

@@ -0,0 +1,21 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+
+      class Impact
+        include ::Crystalline::Enum
+        enums do
+          NONE = new("none")
+          LOW = new("low")
+          MEDIUM = new("medium")
+          HIGH = new("high")
+        end
+
+        open!
+      end
+    end
+  end
+end

data/lib/no_response/models/shared/impact.rbi

@@ -0,0 +1,9 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::Impact
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::Impact
+end

data/lib/no_response/models/shared/risk.rb

@@ -4,7 +4,7 @@
 module NoResponse
   module Models
     module Shared
-      # The one risk decision for this event. score is 0 (safe) to 100 (risky): the sum of the weights of the reasons that fired, clamped to 0 to 100, from hand-set versioned weights. Every answer with a recommendation carries it, and the top-level recommendation equals risk.recommendation. It names no source or provider.
+      # The one risk decision for this event. score is 0 (safe) to 100 (risky), set by the reasons that fired under a hand-set, versioned heuristic policy. Each reason carries its direction and impact band; the policy's weights are not published. Every answer with a recommendation carries it, and the top-level recommendation equals risk.recommendation. It names no source or provider.
       class Risk
         extend T::Sig
         include Crystalline::MetadataFields
@@ -50,13 +50,13 @@ module NoResponse
             }
           }
         )
-        # Version of the hand-authored heuristic weights that produced the recommendation, for example 'risk-2026-10.7'. A workspace threshold override adds a +t<N> suffix, e.g. 'risk-2026-10.7+t3'.
+        # Version of the hand-authored heuristic policy that produced the recommendation, for example 'risk-2026-10.7'. A workspace threshold override adds a +t<N> suffix, e.g. 'risk-2026-10.7+t3'.
         field(
           :policy_version,
           ::String,
           {'format_json': {'letter_case': ::NoResponse::Utils.field_name("policy_version"), required: true}}
         )
-        # Every reason that fired, highest weight first. The weights sum to score before clamping.
+        # Every reason that fired: risk-raising reasons first, then neutral, then risk-lowering, each strongest impact band first and then by code. The policy's numeric weights are kept private, so a reason carries only its direction and impact band.
         field(
           :reasons,
           Crystalline::Array.new(Models::Shared::RiskReason),

data/lib/no_response/models/shared/riskdetails.rb

@@ -26,19 +26,27 @@ module NoResponse
           Crystalline::Nilable.new(Crystalline::Array.new(Models::Shared::RiskDetailsBreachName)),
           {'format_json': {'letter_case': ::NoResponse::Utils.field_name("breach_names")}}
         )
+        # The identity's dated footprint events, newest first, at most 100: the year and month, what happened (created, last_active, breached), the site, its category, the kind of evidence and the identifier it belongs to. No breach value: dates are coarsened to the month.
+        field(
+          :events,
+          Crystalline::Nilable.new(Crystalline::Array.new(Models::Shared::RiskDetailsEvent)),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("events")}}
+        )
 
         sig {
           params(
             phone_names: T.nilable(T::Array[Models::Shared::RiskDetailsPhoneName]),
             breaches: T.nilable(T::Array[Models::Shared::Breach]),
-            breach_names: T.nilable(T::Array[Models::Shared::RiskDetailsBreachName])
+            breach_names: T.nilable(T::Array[Models::Shared::RiskDetailsBreachName]),
+            events: T.nilable(T::Array[Models::Shared::RiskDetailsEvent])
           )
             .void
         }
-        def initialize(phone_names: nil, breaches: nil, breach_names: nil)
+        def initialize(phone_names: nil, breaches: nil, breach_names: nil, events: nil)
           @phone_names = phone_names
           @breaches = breaches
           @breach_names = breach_names
+          @events = events
         end
 
         sig { params(other: T.untyped).returns(T::Boolean) }
@@ -47,6 +55,7 @@ module NoResponse
           return false unless @phone_names == other.phone_names
           return false unless @breaches == other.breaches
           return false unless @breach_names == other.breach_names
+          return false unless @events == other.events
           true
         end
       end

data/lib/no_response/models/shared/riskdetails.rbi

@@ -23,4 +23,10 @@ class NoResponse::Models::Shared::RiskDetails
 
   def breach_names=(str_)
   end
+
+  def events
+  end
+
+  def events=(str_)
+  end
 end

data/lib/no_response/models/shared/riskdetailsevent.rb

@@ -0,0 +1,101 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+
+      class RiskDetailsEvent
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        field :year, ::Integer, {'format_json': {'letter_case': ::NoResponse::Utils.field_name("year"), required: true}}
+
+        field(
+          :kind,
+          Models::Shared::RiskDetailsEventKind,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("kind"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::RiskDetailsEventKind, false)
+            }
+          }
+        )
+
+        field :site, ::String, {'format_json': {'letter_case': ::NoResponse::Utils.field_name("site"), required: true}}
+
+        field(
+          :category,
+          ::String,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("category"), required: true}}
+        )
+        # The source-neutral kind of evidence: account_presence (an account found on a site), auth_provider (the account at your auth provider), breach (breach and credential tables), breach_abuse (abuse and fraud communities' tables) and code_hosting (a code hosting profile).
+        field(
+          :family,
+          Models::Shared::FootprintFamily,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("family"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::FootprintFamily, false)
+            }
+          }
+        )
+
+        field(
+          :identifier,
+          Models::Shared::Identifier,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("identifier"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::Identifier, false)
+            }
+          }
+        )
+
+        field(
+          :month,
+          Crystalline::Nilable.new(::Integer),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("month")}}
+        )
+
+        sig {
+          params(
+            year: ::Integer,
+            kind: Models::Shared::RiskDetailsEventKind,
+            site: ::String,
+            category: ::String,
+            family: Models::Shared::FootprintFamily,
+            identifier: Models::Shared::Identifier,
+            month: T.nilable(::Integer)
+          )
+            .void
+        }
+        def initialize(year:, kind:, site:, category:, family:, identifier:, month: nil)
+          @year = year
+          @kind = kind
+          @site = site
+          @category = category
+          @family = family
+          @identifier = identifier
+          @month = month
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          return false unless @year == other.year
+          return false unless @kind == other.kind
+          return false unless @site == other.site
+          return false unless @category == other.category
+          return false unless @family == other.family
+          return false unless @identifier == other.identifier
+          return false unless @month == other.month
+          true
+        end
+      end
+    end
+  end
+end

data/lib/no_response/models/shared/riskdetailsevent.rbi

@@ -0,0 +1,50 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::RiskDetailsEvent
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::RiskDetailsEvent
+  def year
+  end
+
+  def year=(str_)
+  end
+
+  def kind
+  end
+
+  def kind=(str_)
+  end
+
+  def site
+  end
+
+  def site=(str_)
+  end
+
+  def category
+  end
+
+  def category=(str_)
+  end
+
+  def family
+  end
+
+  def family=(str_)
+  end
+
+  def identifier
+  end
+
+  def identifier=(str_)
+  end
+
+  def month
+  end
+
+  def month=(str_)
+  end
+end

data/lib/no_response/models/shared/riskdetailseventkind.rb

@@ -0,0 +1,20 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+
+      class RiskDetailsEventKind
+        include ::Crystalline::Enum
+        enums do
+          CREATED = new("created")
+          LAST_ACTIVE = new("last_active")
+          BREACHED = new("breached")
+        end
+
+        open!
+      end
+    end
+  end
+end

data/lib/no_response/models/shared/riskdetailseventkind.rbi

@@ -0,0 +1,9 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::RiskDetailsEventKind
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::RiskDetailsEventKind
+end

data/lib/no_response/models/shared/riskreason.rb

@@ -4,7 +4,7 @@
 module NoResponse
   module Models
     module Shared
-
+      # One reason that fired. direction is whether it raises or lowers the score, or is neutral (informational, it moves nothing). impact is a coarse band of how much it moves the score: none for a neutral reason, otherwise low, medium or high.
       class RiskReason
         extend T::Sig
         include Crystalline::MetadataFields
@@ -23,9 +23,27 @@ module NoResponse
         )
 
         field(
-          :weight,
-          ::Integer,
-          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("weight"), required: true}}
+          :direction,
+          Models::Shared::Direction,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("direction"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::Direction, false)
+            }
+          }
+        )
+
+        field(
+          :impact,
+          Models::Shared::Impact,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("impact"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::Impact, false)
+            }
+          }
         )
         # The submitted identifier or client context field a reason concerns; absent when it concerns the whole assessment. Client context is a claimed hint, not a device fingerprint.
         field(
@@ -38,27 +56,45 @@ module NoResponse
             }
           }
         )
+        # Deprecated and always 0: the policy's weights are not published. It is sent so that SDK versions that require it keep reading reasons. Read direction and impact.
+        #
+        # @deprecated true: This will be removed in a future release, please migrate away from it as soon as possible.
+        field(
+          :weight,
+          Crystalline::Nilable.new(::Integer),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("weight")}}
+        )
 
         sig {
           params(
             code: Models::Shared::ReasonCode,
-            weight: ::Integer,
-            identifier: T.nilable(Models::Shared::ReasonIdentifier)
+            direction: Models::Shared::Direction,
+            impact: Models::Shared::Impact,
+            identifier: T.nilable(Models::Shared::ReasonIdentifier),
+            weight: T.nilable(::Integer)
           )
             .void
         }
-        def initialize(code:, weight:, identifier: nil)
+        def initialize(code:, direction:, impact:, identifier: nil, weight: 0)
           @code = code
-          @weight = weight
+          @direction = direction
+          @impact = impact
           @identifier = identifier
+          unless weight&.zero?
+            raise ArgumentError, "Invalid value for weight"
+          end
+
+          @weight = 0
         end
 
         sig { params(other: T.untyped).returns(T::Boolean) }
         def ==(other)
           return false unless other.is_a?(self.class)
           return false unless @code == other.code
-          return false unless @weight == other.weight
+          return false unless @direction == other.direction
+          return false unless @impact == other.impact
           return false unless @identifier == other.identifier
+          return false unless @weight == other.weight
           true
         end
       end

data/lib/no_response/models/shared/riskreason.rbi

@@ -12,10 +12,16 @@ class NoResponse::Models::Shared::RiskReason
   def code=(str_)
   end
 
-  def weight
+  def direction
   end
 
-  def weight=(str_)
+  def direction=(str_)
+  end
+
+  def impact
+  end
+
+  def impact=(str_)
   end
 
   def identifier
@@ -23,4 +29,10 @@ class NoResponse::Models::Shared::RiskReason
 
   def identifier=(str_)
   end
+
+  def weight
+  end
+
+  def weight=(str_)
+  end
 end

data/lib/no_response/models/shared/risksummary.rb

@@ -38,6 +38,12 @@ module NoResponse
           Crystalline::Nilable.new(Models::Shared::Consistency),
           {'format_json': {'letter_case': ::NoResponse::Utils.field_name("consistency")}}
         )
+        # How long and how widely the signup's email and username have existed, and how far independent sources agree on the person behind them, in years and counts only. families are the kinds of evidence that found either identifier. Omitted when nothing found them: a footprint lookup that failed makes no claim, and absence is no_digital_footprint's to state.
+        field(
+          :footprint,
+          Crystalline::Nilable.new(Models::Shared::Footprint),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("footprint")}}
+        )
 
         sig {
           params(
@@ -45,16 +51,18 @@ module NoResponse
             email: T.nilable(Models::Shared::RiskSummaryEmail),
             username: T.nilable(Models::Shared::RiskSummaryUsername),
             ip: T.nilable(Models::Shared::IpSummary),
-            consistency: T.nilable(Models::Shared::Consistency)
+            consistency: T.nilable(Models::Shared::Consistency),
+            footprint: T.nilable(Models::Shared::Footprint)
           )
             .void
         }
-        def initialize(phone: nil, email: nil, username: nil, ip: nil, consistency: nil)
+        def initialize(phone: nil, email: nil, username: nil, ip: nil, consistency: nil, footprint: nil)
           @phone = phone
           @email = email
           @username = username
           @ip = ip
           @consistency = consistency
+          @footprint = footprint
         end
 
         sig { params(other: T.untyped).returns(T::Boolean) }
@@ -65,6 +73,7 @@ module NoResponse
           return false unless @username == other.username
           return false unless @ip == other.ip
           return false unless @consistency == other.consistency
+          return false unless @footprint == other.footprint
           true
         end
       end

data/lib/no_response/models/shared/risksummary.rbi

@@ -35,4 +35,10 @@ class NoResponse::Models::Shared::RiskSummary
 
   def consistency=(str_)
   end
+
+  def footprint
+  end
+
+  def footprint=(str_)
+  end
 end

data/lib/no_response/models/shared.rb

@@ -16,6 +16,7 @@ module NoResponse
       autoload :AccountRiskChangedEvent, "no_response/models/shared/accountriskchangedevent.rb"
       autoload :AccountRiskReason, "no_response/models/shared/accountriskreason.rb"
       autoload :Admission, "no_response/models/shared/admission.rb"
+      autoload :Agreement, "no_response/models/shared/agreement.rb"
       autoload :Assessment, "no_response/models/shared/assessment.rb"
       autoload :AssessmentDeletion, "no_response/models/shared/assessmentdeletion.rb"
       autoload :AssessmentDeletionAccount, "no_response/models/shared/assessmentdeletionaccount.rb"
@@ -35,6 +36,7 @@ module NoResponse
       autoload :AssessmentUpdatedData, "no_response/models/shared/assessmentupdateddata.rb"
       autoload :AssessmentUpdatedEvent, "no_response/models/shared/assessmentupdatedevent.rb"
       autoload :AssuranceLevel, "no_response/models/shared/assurancelevel.rb"
+      autoload :AttributeAgreement, "no_response/models/shared/attributeagreement.rb"
       autoload :AuthContext, "no_response/models/shared/authcontext.rb"
       autoload :AuthContextMfa, "no_response/models/shared/authcontextmfa.rb"
       autoload :AuthenticationErrorCode, "no_response/models/shared/authenticationerrorcode.rb"
@@ -52,6 +54,7 @@ module NoResponse
       autoload :Country, "no_response/models/shared/country.rb"
       autoload :DefaultDepth, "no_response/models/shared/defaultdepth.rb"
       autoload :Depth, "no_response/models/shared/depth.rb"
+      autoload :Direction, "no_response/models/shared/direction.rb"
       autoload :EndpointVerification, "no_response/models/shared/endpointverification.rb"
       autoload :EndpointVerificationEvent, "no_response/models/shared/endpointverificationevent.rb"
       autoload :Enforcement, "no_response/models/shared/enforcement.rb"
@@ -66,9 +69,15 @@ module NoResponse
       autoload :Flow, "no_response/models/shared/flow.rb"
       autoload :FlowChange, "no_response/models/shared/flowchange.rb"
       autoload :FlowSettings, "no_response/models/shared/flowsettings.rb"
+      autoload :Footprint, "no_response/models/shared/footprint.rb"
+      autoload :FootprintCoherence, "no_response/models/shared/footprintcoherence.rb"
+      autoload :FootprintFamily, "no_response/models/shared/footprintfamily.rb"
+      autoload :FootprintTimeline, "no_response/models/shared/footprinttimeline.rb"
       autoload :Freshness, "no_response/models/shared/freshness.rb"
       autoload :HookPoint, "no_response/models/shared/hookpoint.rb"
+      autoload :Identifier, "no_response/models/shared/identifier.rb"
       autoload :IdentifierKind, "no_response/models/shared/identifierkind.rb"
+      autoload :Impact, "no_response/models/shared/impact.rb"
       autoload :IncompleteReason, "no_response/models/shared/incompletereason.rb"
       autoload :IncompleteSource, "no_response/models/shared/incompletesource.rb"
       autoload :Integration, "no_response/models/shared/integration.rb"
@@ -112,6 +121,8 @@ module NoResponse
       autoload :RiskCoverage, "no_response/models/shared/riskcoverage.rb"
       autoload :RiskDetails, "no_response/models/shared/riskdetails.rb"
       autoload :RiskDetailsBreachName, "no_response/models/shared/riskdetailsbreachname.rb"
+      autoload :RiskDetailsEvent, "no_response/models/shared/riskdetailsevent.rb"
+      autoload :RiskDetailsEventKind, "no_response/models/shared/riskdetailseventkind.rb"
       autoload :RiskDetailsPhoneName, "no_response/models/shared/riskdetailsphonename.rb"
       autoload :RiskReason, "no_response/models/shared/riskreason.rb"
       autoload :RiskSummary, "no_response/models/shared/risksummary.rb"