knockapi 0.6.1 → 1.1.0

data/rbi/knockapi/models/message_get_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageGetParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Knockapi::MessageGetParams, Knockapi::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: Knockapi::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: Knockapi::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/knockapi/models/message_list_activities_params.rbi

@@ -0,0 +1,82 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageListActivitiesParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Knockapi::MessageListActivitiesParams,
+            Knockapi::Internal::AnyHash
+          )
+        end
+
+      # The cursor to fetch entries after.
+      sig { returns(T.nilable(String)) }
+      attr_reader :after
+
+      sig { params(after: String).void }
+      attr_writer :after
+
+      # The cursor to fetch entries before.
+      sig { returns(T.nilable(String)) }
+      attr_reader :before
+
+      sig { params(before: String).void }
+      attr_writer :before
+
+      # The number of items per page.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page_size
+
+      sig { params(page_size: Integer).void }
+      attr_writer :page_size
+
+      # The trigger data to filter activities by.
+      sig { returns(T.nilable(String)) }
+      attr_reader :trigger_data
+
+      sig { params(trigger_data: String).void }
+      attr_writer :trigger_data
+
+      sig do
+        params(
+          after: String,
+          before: String,
+          page_size: Integer,
+          trigger_data: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # The number of items per page.
+        page_size: nil,
+        # The trigger data to filter activities by.
+        trigger_data: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            after: String,
+            before: String,
+            page_size: Integer,
+            trigger_data: String,
+            request_options: Knockapi::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/knockapi/models/message_list_delivery_logs_params.rbi

@@ -0,0 +1,71 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageListDeliveryLogsParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Knockapi::MessageListDeliveryLogsParams,
+            Knockapi::Internal::AnyHash
+          )
+        end
+
+      # The cursor to fetch entries after.
+      sig { returns(T.nilable(String)) }
+      attr_reader :after
+
+      sig { params(after: String).void }
+      attr_writer :after
+
+      # The cursor to fetch entries before.
+      sig { returns(T.nilable(String)) }
+      attr_reader :before
+
+      sig { params(before: String).void }
+      attr_writer :before
+
+      # The number of items per page.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page_size
+
+      sig { params(page_size: Integer).void }
+      attr_writer :page_size
+
+      sig do
+        params(
+          after: String,
+          before: String,
+          page_size: Integer,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # The number of items per page.
+        page_size: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            after: String,
+            before: String,
+            page_size: Integer,
+            request_options: Knockapi::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/knockapi/models/message_list_events_params.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageListEventsParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Knockapi::MessageListEventsParams, Knockapi::Internal::AnyHash)
+        end
+
+      # The cursor to fetch entries after.
+      sig { returns(T.nilable(String)) }
+      attr_reader :after
+
+      sig { params(after: String).void }
+      attr_writer :after
+
+      # The cursor to fetch entries before.
+      sig { returns(T.nilable(String)) }
+      attr_reader :before
+
+      sig { params(before: String).void }
+      attr_writer :before
+
+      # The number of items per page.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page_size
+
+      sig { params(page_size: Integer).void }
+      attr_writer :page_size
+
+      sig do
+        params(
+          after: String,
+          before: String,
+          page_size: Integer,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # The number of items per page.
+        page_size: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            after: String,
+            before: String,
+            page_size: Integer,
+            request_options: Knockapi::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/knockapi/models/message_list_params.rbi

@@ -0,0 +1,360 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageListParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Knockapi::MessageListParams, Knockapi::Internal::AnyHash)
+        end
+
+      # The cursor to fetch entries after.
+      sig { returns(T.nilable(String)) }
+      attr_reader :after
+
+      sig { params(after: String).void }
+      attr_writer :after
+
+      # The cursor to fetch entries before.
+      sig { returns(T.nilable(String)) }
+      attr_reader :before
+
+      sig { params(before: String).void }
+      attr_writer :before
+
+      # Limits the results to items with the corresponding channel ID.
+      sig { returns(T.nilable(String)) }
+      attr_reader :channel_id
+
+      sig { params(channel_id: String).void }
+      attr_writer :channel_id
+
+      # Limits the results to messages with the given engagement status.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[Knockapi::MessageListParams::EngagementStatus::OrSymbol]
+          )
+        )
+      end
+      attr_reader :engagement_status
+
+      sig do
+        params(
+          engagement_status:
+            T::Array[Knockapi::MessageListParams::EngagementStatus::OrSymbol]
+        ).void
+      end
+      attr_writer :engagement_status
+
+      sig { returns(T.nilable(Knockapi::MessageListParams::InsertedAt)) }
+      attr_reader :inserted_at
+
+      sig do
+        params(
+          inserted_at: Knockapi::MessageListParams::InsertedAt::OrHash
+        ).void
+      end
+      attr_writer :inserted_at
+
+      # Limits the results to only the message IDs given (max 50). Note: when using this
+      # option, the results will be subject to any other filters applied to the query.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :message_ids
+
+      sig { params(message_ids: T::Array[String]).void }
+      attr_writer :message_ids
+
+      # The number of items per page.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page_size
+
+      sig { params(page_size: Integer).void }
+      attr_writer :page_size
+
+      # Limits the results to messages triggered by the given workflow key.
+      sig { returns(T.nilable(String)) }
+      attr_reader :source
+
+      sig { params(source: String).void }
+      attr_writer :source
+
+      # Limits the results to messages with the given delivery status.
+      sig do
+        returns(
+          T.nilable(T::Array[Knockapi::MessageListParams::Status::OrSymbol])
+        )
+      end
+      attr_reader :status
+
+      sig do
+        params(
+          status: T::Array[Knockapi::MessageListParams::Status::OrSymbol]
+        ).void
+      end
+      attr_writer :status
+
+      # Limits the results to items with the corresponding tenant.
+      sig { returns(T.nilable(String)) }
+      attr_reader :tenant
+
+      sig { params(tenant: String).void }
+      attr_writer :tenant
+
+      # Limits the results to only messages that were generated with the given data. See
+      # [trigger data filtering](/api-reference/overview/trigger-data-filtering) for
+      # more information.
+      sig { returns(T.nilable(String)) }
+      attr_reader :trigger_data
+
+      sig { params(trigger_data: String).void }
+      attr_writer :trigger_data
+
+      # Limits the results to messages related to any of the provided categories.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :workflow_categories
+
+      sig { params(workflow_categories: T::Array[String]).void }
+      attr_writer :workflow_categories
+
+      # Limits the results to messages for a specific recipient's workflow run.
+      sig { returns(T.nilable(String)) }
+      attr_reader :workflow_recipient_run_id
+
+      sig { params(workflow_recipient_run_id: String).void }
+      attr_writer :workflow_recipient_run_id
+
+      # Limits the results to messages associated with the top-level workflow run ID
+      # returned by the workflow trigger request.
+      sig { returns(T.nilable(String)) }
+      attr_reader :workflow_run_id
+
+      sig { params(workflow_run_id: String).void }
+      attr_writer :workflow_run_id
+
+      sig do
+        params(
+          after: String,
+          before: String,
+          channel_id: String,
+          engagement_status:
+            T::Array[Knockapi::MessageListParams::EngagementStatus::OrSymbol],
+          inserted_at: Knockapi::MessageListParams::InsertedAt::OrHash,
+          message_ids: T::Array[String],
+          page_size: Integer,
+          source: String,
+          status: T::Array[Knockapi::MessageListParams::Status::OrSymbol],
+          tenant: String,
+          trigger_data: String,
+          workflow_categories: T::Array[String],
+          workflow_recipient_run_id: String,
+          workflow_run_id: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # Limits the results to items with the corresponding channel ID.
+        channel_id: nil,
+        # Limits the results to messages with the given engagement status.
+        engagement_status: nil,
+        inserted_at: nil,
+        # Limits the results to only the message IDs given (max 50). Note: when using this
+        # option, the results will be subject to any other filters applied to the query.
+        message_ids: nil,
+        # The number of items per page.
+        page_size: nil,
+        # Limits the results to messages triggered by the given workflow key.
+        source: nil,
+        # Limits the results to messages with the given delivery status.
+        status: nil,
+        # Limits the results to items with the corresponding tenant.
+        tenant: nil,
+        # Limits the results to only messages that were generated with the given data. See
+        # [trigger data filtering](/api-reference/overview/trigger-data-filtering) for
+        # more information.
+        trigger_data: nil,
+        # Limits the results to messages related to any of the provided categories.
+        workflow_categories: nil,
+        # Limits the results to messages for a specific recipient's workflow run.
+        workflow_recipient_run_id: nil,
+        # Limits the results to messages associated with the top-level workflow run ID
+        # returned by the workflow trigger request.
+        workflow_run_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            after: String,
+            before: String,
+            channel_id: String,
+            engagement_status:
+              T::Array[Knockapi::MessageListParams::EngagementStatus::OrSymbol],
+            inserted_at: Knockapi::MessageListParams::InsertedAt,
+            message_ids: T::Array[String],
+            page_size: Integer,
+            source: String,
+            status: T::Array[Knockapi::MessageListParams::Status::OrSymbol],
+            tenant: String,
+            trigger_data: String,
+            workflow_categories: T::Array[String],
+            workflow_recipient_run_id: String,
+            workflow_run_id: String,
+            request_options: Knockapi::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module EngagementStatus
+        extend Knockapi::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Knockapi::MessageListParams::EngagementStatus)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SEEN =
+          T.let(
+            :seen,
+            Knockapi::MessageListParams::EngagementStatus::TaggedSymbol
+          )
+        READ =
+          T.let(
+            :read,
+            Knockapi::MessageListParams::EngagementStatus::TaggedSymbol
+          )
+        INTERACTED =
+          T.let(
+            :interacted,
+            Knockapi::MessageListParams::EngagementStatus::TaggedSymbol
+          )
+        LINK_CLICKED =
+          T.let(
+            :link_clicked,
+            Knockapi::MessageListParams::EngagementStatus::TaggedSymbol
+          )
+        ARCHIVED =
+          T.let(
+            :archived,
+            Knockapi::MessageListParams::EngagementStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Knockapi::MessageListParams::EngagementStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class InsertedAt < Knockapi::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Knockapi::MessageListParams::InsertedAt,
+              Knockapi::Internal::AnyHash
+            )
+          end
+
+        # Limits the results to messages inserted after the given date.
+        sig { returns(T.nilable(String)) }
+        attr_reader :gt
+
+        sig { params(gt: String).void }
+        attr_writer :gt
+
+        # Limits the results to messages inserted after or on the given date.
+        sig { returns(T.nilable(String)) }
+        attr_reader :gte
+
+        sig { params(gte: String).void }
+        attr_writer :gte
+
+        # Limits the results to messages inserted before the given date.
+        sig { returns(T.nilable(String)) }
+        attr_reader :lt
+
+        sig { params(lt: String).void }
+        attr_writer :lt
+
+        # Limits the results to messages inserted before or on the given date.
+        sig { returns(T.nilable(String)) }
+        attr_reader :lte
+
+        sig { params(lte: String).void }
+        attr_writer :lte
+
+        sig do
+          params(gt: String, gte: String, lt: String, lte: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Limits the results to messages inserted after the given date.
+          gt: nil,
+          # Limits the results to messages inserted after or on the given date.
+          gte: nil,
+          # Limits the results to messages inserted before the given date.
+          lt: nil,
+          # Limits the results to messages inserted before or on the given date.
+          lte: nil
+        )
+        end
+
+        sig do
+          override.returns({ gt: String, gte: String, lt: String, lte: String })
+        end
+        def to_hash
+        end
+      end
+
+      module Status
+        extend Knockapi::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Knockapi::MessageListParams::Status) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        QUEUED =
+          T.let(:queued, Knockapi::MessageListParams::Status::TaggedSymbol)
+        SENT = T.let(:sent, Knockapi::MessageListParams::Status::TaggedSymbol)
+        DELIVERED =
+          T.let(:delivered, Knockapi::MessageListParams::Status::TaggedSymbol)
+        DELIVERY_ATTEMPTED =
+          T.let(
+            :delivery_attempted,
+            Knockapi::MessageListParams::Status::TaggedSymbol
+          )
+        UNDELIVERED =
+          T.let(:undelivered, Knockapi::MessageListParams::Status::TaggedSymbol)
+        NOT_SENT =
+          T.let(:not_sent, Knockapi::MessageListParams::Status::TaggedSymbol)
+        BOUNCED =
+          T.let(:bounced, Knockapi::MessageListParams::Status::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Knockapi::MessageListParams::Status::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/knockapi/models/message_mark_as_interacted_params.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageMarkAsInteractedParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Knockapi::MessageMarkAsInteractedParams,
+            Knockapi::Internal::AnyHash
+          )
+        end
+
+      # Metadata about the interaction.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :metadata
+
+      sig { params(metadata: T::Hash[Symbol, T.anything]).void }
+      attr_writer :metadata
+
+      sig do
+        params(
+          metadata: T::Hash[Symbol, T.anything],
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Metadata about the interaction.
+        metadata: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            metadata: T::Hash[Symbol, T.anything],
+            request_options: Knockapi::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/knockapi/models/message_mark_as_read_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageMarkAsReadParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Knockapi::MessageMarkAsReadParams, Knockapi::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: Knockapi::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: Knockapi::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/knockapi/models/message_mark_as_seen_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    class MessageMarkAsSeenParams < Knockapi::Internal::Type::BaseModel
+      extend Knockapi::Internal::Type::RequestParameters::Converter
+      include Knockapi::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Knockapi::MessageMarkAsSeenParams, Knockapi::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: Knockapi::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: Knockapi::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end