context.dev 2.14.0 → 2.16.0

data/rbi/context_dev/models/webhooks/delivery.rbi

@@ -0,0 +1,471 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    module Webhooks
+      class Delivery < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(ContextDev::Webhooks::Delivery, ContextDev::Internal::AnyHash)
+          end
+
+        # Delivery ID.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Event creation time.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Last successful delivery time, or null if never delivered.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :delivered_at
+
+        # Webhook event type.
+        sig { returns(ContextDev::Webhooks::Delivery::Event::TaggedSymbol) }
+        attr_accessor :event
+
+        # Stable event ID for deduplicating received webhooks.
+        sig { returns(String) }
+        attr_accessor :event_id
+
+        # Latest attempt, or null if none.
+        sig { returns(T.nilable(ContextDev::Webhooks::Attempt)) }
+        attr_reader :last_attempt
+
+        sig do
+          params(
+            last_attempt: T.nilable(ContextDev::Webhooks::Attempt::OrHash)
+          ).void
+        end
+        attr_writer :last_attempt
+
+        # Latest delivery error, or null if none.
+        sig { returns(T.nilable(ContextDev::Webhooks::Delivery::LastError)) }
+        attr_reader :last_error
+
+        sig do
+          params(
+            last_error:
+              T.nilable(ContextDev::Webhooks::Delivery::LastError::OrHash)
+          ).void
+        end
+        attr_writer :last_error
+
+        # Next scheduled attempt, or null if none.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :next_attempt_at
+
+        # Webhook retry settings. Use {} for the default schedule.
+        sig { returns(ContextDev::RetryConfig) }
+        attr_reader :retry_
+
+        sig { params(retry_: ContextDev::RetryConfig::OrHash).void }
+        attr_writer :retry_
+
+        # Manual retry deadline, seven days after event creation.
+        sig { returns(Time) }
+        attr_accessor :retry_expires_at
+
+        # Batch or monitor run that produced the event.
+        sig { returns(ContextDev::Webhooks::Delivery::Source::Variants) }
+        attr_accessor :source
+
+        # Current delivery status.
+        sig { returns(ContextDev::Webhooks::Delivery::Status::TaggedSymbol) }
+        attr_accessor :status
+
+        # Webhook destination URL.
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            id: String,
+            created_at: Time,
+            delivered_at: T.nilable(Time),
+            event: ContextDev::Webhooks::Delivery::Event::OrSymbol,
+            event_id: String,
+            last_attempt: T.nilable(ContextDev::Webhooks::Attempt::OrHash),
+            last_error:
+              T.nilable(ContextDev::Webhooks::Delivery::LastError::OrHash),
+            next_attempt_at: T.nilable(Time),
+            retry_: ContextDev::RetryConfig::OrHash,
+            retry_expires_at: Time,
+            source:
+              T.any(
+                ContextDev::Webhooks::Delivery::Source::Batch::OrHash,
+                ContextDev::Webhooks::Delivery::Source::Monitor::OrHash
+              ),
+            status: ContextDev::Webhooks::Delivery::Status::OrSymbol,
+            url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Delivery ID.
+          id:,
+          # Event creation time.
+          created_at:,
+          # Last successful delivery time, or null if never delivered.
+          delivered_at:,
+          # Webhook event type.
+          event:,
+          # Stable event ID for deduplicating received webhooks.
+          event_id:,
+          # Latest attempt, or null if none.
+          last_attempt:,
+          # Latest delivery error, or null if none.
+          last_error:,
+          # Next scheduled attempt, or null if none.
+          next_attempt_at:,
+          # Webhook retry settings. Use {} for the default schedule.
+          retry_:,
+          # Manual retry deadline, seven days after event creation.
+          retry_expires_at:,
+          # Batch or monitor run that produced the event.
+          source:,
+          # Current delivery status.
+          status:,
+          # Webhook destination URL.
+          url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              delivered_at: T.nilable(Time),
+              event: ContextDev::Webhooks::Delivery::Event::TaggedSymbol,
+              event_id: String,
+              last_attempt: T.nilable(ContextDev::Webhooks::Attempt),
+              last_error: T.nilable(ContextDev::Webhooks::Delivery::LastError),
+              next_attempt_at: T.nilable(Time),
+              retry_: ContextDev::RetryConfig,
+              retry_expires_at: Time,
+              source: ContextDev::Webhooks::Delivery::Source::Variants,
+              status: ContextDev::Webhooks::Delivery::Status::TaggedSymbol,
+              url: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Webhook event type.
+        module Event
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::Webhooks::Delivery::Event)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          BATCH_COMPLETED =
+            T.let(
+              :"batch.completed",
+              ContextDev::Webhooks::Delivery::Event::TaggedSymbol
+            )
+          BATCH_FAILED =
+            T.let(
+              :"batch.failed",
+              ContextDev::Webhooks::Delivery::Event::TaggedSymbol
+            )
+          BATCH_CANCELLED =
+            T.let(
+              :"batch.cancelled",
+              ContextDev::Webhooks::Delivery::Event::TaggedSymbol
+            )
+          CHANGE_DETECTED =
+            T.let(
+              :"change.detected",
+              ContextDev::Webhooks::Delivery::Event::TaggedSymbol
+            )
+          RUN_COMPLETED =
+            T.let(
+              :"run.completed",
+              ContextDev::Webhooks::Delivery::Event::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[ContextDev::Webhooks::Delivery::Event::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class LastError < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Webhooks::Delivery::LastError,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Error code.
+          sig { returns(String) }
+          attr_accessor :code
+
+          # Error details.
+          sig { returns(String) }
+          attr_accessor :message
+
+          # Latest delivery error, or null if none.
+          sig do
+            params(code: String, message: String).returns(T.attached_class)
+          end
+          def self.new(
+            # Error code.
+            code:,
+            # Error details.
+            message:
+          )
+          end
+
+          sig { override.returns({ code: String, message: String }) }
+          def to_hash
+          end
+        end
+
+        # Batch or monitor run that produced the event.
+        module Source
+          extend ContextDev::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                ContextDev::Webhooks::Delivery::Source::Batch,
+                ContextDev::Webhooks::Delivery::Source::Monitor
+              )
+            end
+
+          class Batch < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Webhooks::Delivery::Source::Batch,
+                  ContextDev::Internal::AnyHash
+                )
+              end
+
+            # Batch ID.
+            sig { returns(String) }
+            attr_accessor :batch_id
+
+            # Delivery source.
+            sig do
+              returns(
+                ContextDev::Webhooks::Delivery::Source::Batch::Type::TaggedSymbol
+              )
+            end
+            attr_accessor :type
+
+            sig do
+              params(
+                batch_id: String,
+                type:
+                  ContextDev::Webhooks::Delivery::Source::Batch::Type::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Batch ID.
+              batch_id:,
+              # Delivery source.
+              type:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  batch_id: String,
+                  type:
+                    ContextDev::Webhooks::Delivery::Source::Batch::Type::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Delivery source.
+            module Type
+              extend ContextDev::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    ContextDev::Webhooks::Delivery::Source::Batch::Type
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              BATCH =
+                T.let(
+                  :batch,
+                  ContextDev::Webhooks::Delivery::Source::Batch::Type::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    ContextDev::Webhooks::Delivery::Source::Batch::Type::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          class Monitor < ContextDev::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  ContextDev::Webhooks::Delivery::Source::Monitor,
+                  ContextDev::Internal::AnyHash
+                )
+              end
+
+            # Monitor ID.
+            sig { returns(String) }
+            attr_accessor :monitor_id
+
+            # Monitor run ID.
+            sig { returns(String) }
+            attr_accessor :run_id
+
+            # Delivery source.
+            sig do
+              returns(
+                ContextDev::Webhooks::Delivery::Source::Monitor::Type::TaggedSymbol
+              )
+            end
+            attr_accessor :type
+
+            sig do
+              params(
+                monitor_id: String,
+                run_id: String,
+                type:
+                  ContextDev::Webhooks::Delivery::Source::Monitor::Type::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Monitor ID.
+              monitor_id:,
+              # Monitor run ID.
+              run_id:,
+              # Delivery source.
+              type:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  monitor_id: String,
+                  run_id: String,
+                  type:
+                    ContextDev::Webhooks::Delivery::Source::Monitor::Type::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Delivery source.
+            module Type
+              extend ContextDev::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    ContextDev::Webhooks::Delivery::Source::Monitor::Type
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              MONITOR =
+                T.let(
+                  :monitor,
+                  ContextDev::Webhooks::Delivery::Source::Monitor::Type::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    ContextDev::Webhooks::Delivery::Source::Monitor::Type::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          sig do
+            override.returns(
+              T::Array[ContextDev::Webhooks::Delivery::Source::Variants]
+            )
+          end
+          def self.variants
+          end
+        end
+
+        # Current delivery status.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::Webhooks::Delivery::Status)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PENDING =
+            T.let(
+              :pending,
+              ContextDev::Webhooks::Delivery::Status::TaggedSymbol
+            )
+          DELIVERING =
+            T.let(
+              :delivering,
+              ContextDev::Webhooks::Delivery::Status::TaggedSymbol
+            )
+          RETRYING =
+            T.let(
+              :retrying,
+              ContextDev::Webhooks::Delivery::Status::TaggedSymbol
+            )
+          DELIVERED =
+            T.let(
+              :delivered,
+              ContextDev::Webhooks::Delivery::Status::TaggedSymbol
+            )
+          FAILED =
+            T.let(:failed, ContextDev::Webhooks::Delivery::Status::TaggedSymbol)
+          CANCELLED =
+            T.let(
+              :cancelled,
+              ContextDev::Webhooks::Delivery::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[ContextDev::Webhooks::Delivery::Status::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models/webhooks/delivery_list_attempts_params.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    module Webhooks
+      class DeliveryListAttemptsParams < ContextDev::Internal::Type::BaseModel
+        extend ContextDev::Internal::Type::RequestParameters::Converter
+        include ContextDev::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Webhooks::DeliveryListAttemptsParams,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Delivery ID.
+        sig { returns(String) }
+        attr_accessor :delivery_id
+
+        # The next_cursor from the previous response.
+        sig { returns(T.nilable(String)) }
+        attr_reader :cursor
+
+        sig { params(cursor: String).void }
+        attr_writer :cursor
+
+        # Number of attempts to return.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :limit
+
+        sig { params(limit: Integer).void }
+        attr_writer :limit
+
+        # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+        # characters.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :tags
+
+        sig { params(tags: T::Array[String]).void }
+        attr_writer :tags
+
+        sig do
+          params(
+            delivery_id: String,
+            cursor: String,
+            limit: Integer,
+            tags: T::Array[String],
+            request_options: ContextDev::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Delivery ID.
+          delivery_id:,
+          # The next_cursor from the previous response.
+          cursor: nil,
+          # Number of attempts to return.
+          limit: nil,
+          # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+          # characters.
+          tags: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              delivery_id: String,
+              cursor: String,
+              limit: Integer,
+              tags: T::Array[String],
+              request_options: ContextDev::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models/webhooks/delivery_list_attempts_response.rbi

@@ -0,0 +1,133 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    module Webhooks
+      class DeliveryListAttemptsResponse < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::Webhooks::DeliveryListAttemptsResponse,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Delivery attempts.
+        sig { returns(T::Array[ContextDev::Webhooks::Attempt]) }
+        attr_accessor :data
+
+        # Whether more attempts are available.
+        sig { returns(T::Boolean) }
+        attr_accessor :has_more
+
+        # Next page cursor, or null on the last page.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :next_cursor
+
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        sig { returns(String) }
+        attr_accessor :request_id
+
+        # Credit usage, included whenever a valid API key is provided.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata
+            )
+          )
+        end
+        attr_reader :key_metadata
+
+        sig do
+          params(
+            key_metadata:
+              ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata::OrHash
+          ).void
+        end
+        attr_writer :key_metadata
+
+        sig do
+          params(
+            data: T::Array[ContextDev::Webhooks::Attempt::OrHash],
+            has_more: T::Boolean,
+            next_cursor: T.nilable(String),
+            request_id: String,
+            key_metadata:
+              ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Delivery attempts.
+          data:,
+          # Whether more attempts are available.
+          has_more:,
+          # Next page cursor, or null on the last page.
+          next_cursor:,
+          # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+          # it when contacting support about a failed request.
+          request_id:,
+          # Credit usage, included whenever a valid API key is provided.
+          key_metadata: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              data: T::Array[ContextDev::Webhooks::Attempt],
+              has_more: T::Boolean,
+              next_cursor: T.nilable(String),
+              request_id: String,
+              key_metadata:
+                ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class KeyMetadata < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Credits used by this request.
+          sig { returns(Integer) }
+          attr_accessor :credits_consumed
+
+          # Credits remaining for your organization.
+          sig { returns(Integer) }
+          attr_accessor :credits_remaining
+
+          # Credit usage, included whenever a valid API key is provided.
+          sig do
+            params(
+              credits_consumed: Integer,
+              credits_remaining: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Credits used by this request.
+            credits_consumed:,
+            # Credits remaining for your organization.
+            credits_remaining:
+          )
+          end
+
+          sig do
+            override.returns(
+              { credits_consumed: Integer, credits_remaining: Integer }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end