noresponse 2.0.18 → 2.1.0

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

@@ -0,0 +1,20 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::WebhookEndpointCreated
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::WebhookEndpointCreated
+  def endpoint
+  end
+
+  def endpoint=(str_)
+  end
+
+  def signing_secret
+  end
+
+  def signing_secret=(str_)
+  end
+end

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

@@ -0,0 +1,32 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # GET /v1/webhooks answer: every endpoint of the calling tenant, in every state, ordered by endpoint_id. A tenant holds at most 5, so there is no page.
+      class WebhookEndpointList
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        field(
+          :items,
+          Crystalline::Array.new(Models::Shared::WebhookEndpoint),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("items"), required: true}}
+        )
+
+        sig { params(items: T::Array[Models::Shared::WebhookEndpoint]).void }
+        def initialize(items:)
+          @items = items
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          return false unless @items == other.items
+          true
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::WebhookEndpointList
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::WebhookEndpointList
+  def items
+  end
+
+  def items=(str_)
+  end
+end

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

@@ -0,0 +1,42 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # POST /v1/webhooks body. The tenant is the API key that signs the request, so it is not a body member. The URL must be https on port 443 or 8443 with a DNS name, not an IP literal, and every address the name resolves to must be public.
+      class WebhookEndpointRequest
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # Where deliveries are sent: an https URL on port 443 or 8443, with a DNS host and no userinfo or fragment, at most 2048 characters.
+        field :url, ::String, {'format_json': {'letter_case': ::NoResponse::Utils.field_name("url"), required: true}}
+        # standard returns the consolidated risk response; detailed adds merged provider-neutral facts when the key has detailed scope. There is no raw mode.
+        field(
+          :response_mode,
+          Crystalline::Nilable.new(Models::Shared::ResponseMode),
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("response_mode"),
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::ResponseMode, true)
+            }
+          }
+        )
+
+        sig { params(url: ::String, response_mode: T.nilable(Models::Shared::ResponseMode)).void }
+        def initialize(url:, response_mode: nil)
+          @url = url
+          @response_mode = response_mode
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          return false unless @url == other.url
+          return false unless @response_mode == other.response_mode
+          true
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::WebhookEndpointRequest
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::WebhookEndpointRequest
+  def url
+  end
+
+  def url=(str_)
+  end
+
+  def response_mode
+  end
+
+  def response_mode=(str_)
+  end
+end

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

@@ -0,0 +1,20 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # WebhookEndpointState - unverified until the endpoint echoes an endpoint.verification challenge (send one with POST /v1/webhooks/{endpoint_id}/test); verified receives assessment.updated events; disabled after 72 hours of continuous delivery failure, and verified again by the same challenge.
+      class WebhookEndpointState
+        include ::Crystalline::Enum
+        enums do
+          UNVERIFIED = new("unverified")
+          VERIFIED = new("verified")
+          DISABLED = new("disabled")
+        end
+
+        open!
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,65 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # The 201 answer of POST /v1/webhooks/{endpoint_id}/rotate: the new signing secret, shown once, which signs every delivery from now on, and when the key it replaced stops verifying. Until then a receiver accepts both.
+      class WebhookKeyRotation
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # Opaque id of the endpoint registration.
+        field(
+          :endpoint_id,
+          ::String,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("endpoint_id"), required: true}}
+        )
+        # A newly issued signing key with its secret, shown only in this answer. A receiver verifies NR-Webhook-Signature with the secret's UTF-8 bytes as the HMAC-SHA256 key.
+        field(
+          :signing_secret,
+          Models::Shared::SigningSecret,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("signing_secret"), required: true}}
+        )
+        # The key that signed until this rotation.
+        field(
+          :previous_key_id,
+          ::String,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("previous_key_id"), required: true}}
+        )
+        # When the previous key stops verifying: 7 days after the rotation.
+        field(
+          :previous_key_expires_at,
+          ::String,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("previous_key_expires_at"), required: true}}
+        )
+
+        sig {
+          params(
+            endpoint_id: ::String,
+            signing_secret: Models::Shared::SigningSecret,
+            previous_key_id: ::String,
+            previous_key_expires_at: ::String
+          )
+            .void
+        }
+        def initialize(endpoint_id:, signing_secret:, previous_key_id:, previous_key_expires_at:)
+          @endpoint_id = endpoint_id
+          @signing_secret = signing_secret
+          @previous_key_id = previous_key_id
+          @previous_key_expires_at = previous_key_expires_at
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          return false unless @endpoint_id == other.endpoint_id
+          return false unless @signing_secret == other.signing_secret
+          return false unless @previous_key_id == other.previous_key_id
+          return false unless @previous_key_expires_at == other.previous_key_expires_at
+          true
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::WebhookKeyRotation
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::WebhookKeyRotation
+  def endpoint_id
+  end
+
+  def endpoint_id=(str_)
+  end
+
+  def signing_secret
+  end
+
+  def signing_secret=(str_)
+  end
+
+  def previous_key_id
+  end
+
+  def previous_key_id=(str_)
+  end
+
+  def previous_key_expires_at
+  end
+
+  def previous_key_expires_at=(str_)
+  end
+end

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

@@ -0,0 +1,23 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # POST /v1/webhooks/{endpoint_id}/rotate body: an empty object. The old key keeps verifying for 7 days.
+      class WebhookKeyRotationRequest
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        def initialize
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          true
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,86 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # The 202 answer of POST /v1/webhooks/{endpoint_id}/test: the event that was sent or queued.
+      class WebhookTest
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # The event id the receiver sees as NR-Webhook-Id and as the body's id.
+        field(
+          :delivery_id,
+          ::String,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("delivery_id"), required: true}}
+        )
+        # Opaque id of the endpoint registration.
+        field(
+          :endpoint_id,
+          ::String,
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("endpoint_id"), required: true}}
+        )
+        # endpoint.verification sends a fresh challenge now, in this call, and the endpoint is verified if it echoes it. assessment.updated queues an event whose data is a fixed example assessment, with test true, delivered and retried like any other; the endpoint must be verified.
+        field(
+          :event,
+          Models::Shared::WebhookTestRequestEvent,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("event"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::WebhookTestRequestEvent, false)
+            }
+          }
+        )
+        # unverified until the endpoint echoes an endpoint.verification challenge (send one with POST /v1/webhooks/{endpoint_id}/test); verified receives assessment.updated events; disabled after 72 hours of continuous delivery failure, and verified again by the same challenge.
+        field(
+          :state,
+          Models::Shared::WebhookEndpointState,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("state"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::WebhookEndpointState, false)
+            }
+          }
+        )
+        # endpoint.verification only: true when the endpoint echoed the challenge within 5 seconds. A false answer leaves the endpoint's state as it was.
+        field(
+          :verified,
+          Crystalline::Nilable.new(Crystalline::Boolean.new),
+          {'format_json': {'letter_case': ::NoResponse::Utils.field_name("verified")}}
+        )
+
+        sig {
+          params(
+            delivery_id: ::String,
+            endpoint_id: ::String,
+            event: Models::Shared::WebhookTestRequestEvent,
+            state: Models::Shared::WebhookEndpointState,
+            verified: T.nilable(T::Boolean)
+          )
+            .void
+        }
+        def initialize(delivery_id:, endpoint_id:, event:, state:, verified: nil)
+          @delivery_id = delivery_id
+          @endpoint_id = endpoint_id
+          @event = event
+          @state = state
+          @verified = verified
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          return false unless @delivery_id == other.delivery_id
+          return false unless @endpoint_id == other.endpoint_id
+          return false unless @event == other.event
+          return false unless @state == other.state
+          return false unless @verified == other.verified
+          true
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::WebhookTest
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::WebhookTest
+  def delivery_id
+  end
+
+  def delivery_id=(str_)
+  end
+
+  def endpoint_id
+  end
+
+  def endpoint_id=(str_)
+  end
+
+  def event
+  end
+
+  def event=(str_)
+  end
+
+  def state
+  end
+
+  def state=(str_)
+  end
+
+  def verified
+  end
+
+  def verified=(str_)
+  end
+end

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

@@ -0,0 +1,39 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # POST /v1/webhooks/{endpoint_id}/test body: which event to send.
+      class WebhookTestRequest
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # endpoint.verification sends a fresh challenge now, in this call, and the endpoint is verified if it echoes it. assessment.updated queues an event whose data is a fixed example assessment, with test true, delivered and retried like any other; the endpoint must be verified.
+        field(
+          :event,
+          Models::Shared::WebhookTestRequestEvent,
+          {
+            'format_json': {
+              'letter_case': ::NoResponse::Utils.field_name("event"),
+              required: true,
+              'decoder': ::NoResponse::Utils.open_enum_from_string(Models::Shared::WebhookTestRequestEvent, false)
+            }
+          }
+        )
+
+        sig { params(event: Models::Shared::WebhookTestRequestEvent).void }
+        def initialize(event:)
+          @event = event
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a?(self.class)
+          return false unless @event == other.event
+          true
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# typed: true
+# frozen_string_literal: true
+
+class NoResponse::Models::Shared::WebhookTestRequest
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+class NoResponse::Models::Shared::WebhookTestRequest
+  def event
+  end
+
+  def event=(str_)
+  end
+end

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

@@ -0,0 +1,19 @@
+# typed: true
+# frozen_string_literal: true
+
+module NoResponse
+  module Models
+    module Shared
+      # WebhookTestRequestEvent - endpoint.verification sends a fresh challenge now, in this call, and the endpoint is verified if it echoes it. assessment.updated queues an event whose data is a fixed example assessment, with test true, delivered and retried like any other; the endpoint must be verified.
+      class WebhookTestRequestEvent
+        include ::Crystalline::Enum
+        enums do
+          ENDPOINT_VERIFICATION = new("endpoint.verification")
+          ASSESSMENT_UPDATED = new("assessment.updated")
+        end
+
+        open!
+      end
+    end
+  end
+end

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

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

data/lib/no_response/models/shared.rb

@@ -5,6 +5,7 @@ module NoResponse
   module Models
     module Shared
       autoload :Assessment, "no_response/models/shared/assessment.rb"
+      autoload :AssessmentAuthContext, "no_response/models/shared/assessmentauthcontext.rb"
       autoload :AssessmentList, "no_response/models/shared/assessmentlist.rb"
       autoload :AssessmentOutcome, "no_response/models/shared/assessmentoutcome.rb"
       autoload :AssessmentOutcomeRequest, "no_response/models/shared/assessmentoutcomerequest.rb"
@@ -76,8 +77,20 @@ module NoResponse
       autoload :Security, "no_response/models/shared/security.rb"
       autoload :Signal, "no_response/models/shared/signal.rb"
       autoload :SignalOutcome, "no_response/models/shared/signaloutcome.rb"
+      autoload :SigningKey, "no_response/models/shared/signingkey.rb"
+      autoload :SigningSecret, "no_response/models/shared/signingsecret.rb"
       autoload :Status, "no_response/models/shared/status.rb"
       autoload :Transport, "no_response/models/shared/transport.rb"
+      autoload :WebhookEndpoint, "no_response/models/shared/webhookendpoint.rb"
+      autoload :WebhookEndpointCreated, "no_response/models/shared/webhookendpointcreated.rb"
+      autoload :WebhookEndpointList, "no_response/models/shared/webhookendpointlist.rb"
+      autoload :WebhookEndpointRequest, "no_response/models/shared/webhookendpointrequest.rb"
+      autoload :WebhookEndpointState, "no_response/models/shared/webhookendpointstate.rb"
+      autoload :WebhookKeyRotation, "no_response/models/shared/webhookkeyrotation.rb"
+      autoload :WebhookKeyRotationRequest, "no_response/models/shared/webhookkeyrotationrequest.rb"
+      autoload :WebhookTest, "no_response/models/shared/webhooktest.rb"
+      autoload :WebhookTestRequest, "no_response/models/shared/webhooktestrequest.rb"
+      autoload :WebhookTestRequestEvent, "no_response/models/shared/webhooktestrequestevent.rb"
       autoload :AlternateName, "no_response/models/shared/alternate_name.rb"
       autoload :AlternateNameUnion, "no_response/models/shared/alternate_name_union.rb"
       autoload :Email, "no_response/models/shared/email.rb"

data/lib/no_response/noresponseclient.rb

@@ -15,7 +15,7 @@ module NoResponse
   class NoResponseClient
     extend T::Sig
 
-    attr_accessor :assessments, :keys, :integrations
+    attr_accessor :assessments, :keys, :integrations, :webhook_endpoints
 
     # Instantiates the SDK, configuring it with the provided parameters.
     #
@@ -90,6 +90,7 @@ module NoResponse
       @assessments = Assessments.new(@sdk_configuration)
       @keys = Keys.new(@sdk_configuration)
       @integrations = Integrations.new(@sdk_configuration)
+      @webhook_endpoints = WebhookEndpoints.new(@sdk_configuration)
     end
 
     sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, T.any(String, T::Enum)])).returns(String) }

data/lib/no_response/sdkconfiguration.rb

@@ -88,13 +88,16 @@ module NoResponse
         @security_source = security_source
       elsif !api_key.nil?
         @security_source = -> { Models::Shared::Security.new(api_key: api_key) }
+      elsif !ENV.fetch("NORESPONSE_API_KEY", "").empty?
+        env_security = Models::Shared::Security.new(api_key: ENV.fetch("NORESPONSE_API_KEY"))
+        @security_source = -> { env_security }
       end
 
       @language = "ruby"
       @openapi_doc_version = "1"
-      @sdk_version = "2.0.18"
+      @sdk_version = "2.1.0"
       @gen_version = "internal"
-      @user_agent = "noresponse-sdk/ruby 2.0.18 internal 1 noresponse"
+      @user_agent = "noresponse-sdk/ruby 2.1.0 internal 1 noresponse"
     end
 
     sig { returns([String, T::Hash[Symbol, String]]) }