trycourier 4.16.0 → 4.17.1

data/rbi/courier/models/workspace_preference_topic_create_request.rbi

@@ -0,0 +1,186 @@
+# typed: strong
+
+module Courier
+  module Models
+    class WorkspacePreferenceTopicCreateRequest < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::WorkspacePreferenceTopicCreateRequest,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # The default subscription status applied when a recipient has not set their own.
+      sig do
+        returns(
+          Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus::OrSymbol
+        )
+      end
+      attr_accessor :default_status
+
+      # Human-readable name for the preference topic.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # Preference controls a recipient may customize for this topic. Defaults to empty
+      # if omitted.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[
+              Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::OrSymbol
+            ]
+          )
+        )
+      end
+      attr_accessor :allowed_preferences
+
+      # Whether to include a list-unsubscribe header on emails for this topic.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_accessor :include_unsubscribe_header
+
+      # Default channels delivered for this topic. Defaults to empty if omitted.
+      sig do
+        returns(T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]))
+      end
+      attr_accessor :routing_options
+
+      # Arbitrary metadata associated with the topic.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :topic_data
+
+      # Request body for creating a preference topic.
+      sig do
+        params(
+          default_status:
+            Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus::OrSymbol,
+          name: String,
+          allowed_preferences:
+            T.nilable(
+              T::Array[
+                Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::OrSymbol
+              ]
+            ),
+          include_unsubscribe_header: T.nilable(T::Boolean),
+          routing_options:
+            T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
+          topic_data: T.nilable(T::Hash[Symbol, T.anything])
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The default subscription status applied when a recipient has not set their own.
+        default_status:,
+        # Human-readable name for the preference topic.
+        name:,
+        # Preference controls a recipient may customize for this topic. Defaults to empty
+        # if omitted.
+        allowed_preferences: nil,
+        # Whether to include a list-unsubscribe header on emails for this topic.
+        include_unsubscribe_header: nil,
+        # Default channels delivered for this topic. Defaults to empty if omitted.
+        routing_options: nil,
+        # Arbitrary metadata associated with the topic.
+        topic_data: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            default_status:
+              Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus::OrSymbol,
+            name: String,
+            allowed_preferences:
+              T.nilable(
+                T::Array[
+                  Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::OrSymbol
+                ]
+              ),
+            include_unsubscribe_header: T.nilable(T::Boolean),
+            routing_options:
+              T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
+            topic_data: T.nilable(T::Hash[Symbol, T.anything])
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The default subscription status applied when a recipient has not set their own.
+      module DefaultStatus
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        OPTED_OUT =
+          T.let(
+            :OPTED_OUT,
+            Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus::TaggedSymbol
+          )
+        OPTED_IN =
+          T.let(
+            :OPTED_IN,
+            Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus::TaggedSymbol
+          )
+        REQUIRED =
+          T.let(
+            :REQUIRED,
+            Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::WorkspacePreferenceTopicCreateRequest::DefaultStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # A preference control a recipient may customize for a topic.
+      module AllowedPreference
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SNOOZE =
+          T.let(
+            :snooze,
+            Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::TaggedSymbol
+          )
+        CHANNEL_PREFERENCES =
+          T.let(
+            :channel_preferences,
+            Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/workspace_preference_topic_get_response.rbi

@@ -0,0 +1,215 @@
+# typed: strong
+
+module Courier
+  module Models
+    class WorkspacePreferenceTopicGetResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::WorkspacePreferenceTopicGetResponse,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # The preference topic id.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Preference controls a recipient may customize. May be empty.
+      sig do
+        returns(
+          T::Array[
+            Courier::WorkspacePreferenceTopicGetResponse::AllowedPreference::TaggedSymbol
+          ]
+        )
+      end
+      attr_accessor :allowed_preferences
+
+      # ISO-8601 timestamp of when the topic was created.
+      sig { returns(String) }
+      attr_accessor :created
+
+      # The default subscription status applied when a recipient has not set their own.
+      sig do
+        returns(
+          Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus::TaggedSymbol
+        )
+      end
+      attr_accessor :default_status
+
+      # Whether a list-unsubscribe header is included on emails for this topic.
+      sig { returns(T::Boolean) }
+      attr_accessor :include_unsubscribe_header
+
+      # Human-readable name.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # Default channels delivered for this topic. May be empty.
+      sig { returns(T::Array[Courier::ChannelClassification::TaggedSymbol]) }
+      attr_accessor :routing_options
+
+      # Arbitrary metadata associated with the topic.
+      sig { returns(T::Hash[Symbol, T.anything]) }
+      attr_accessor :topic_data
+
+      # ISO-8601 timestamp of the last update.
+      sig { returns(String) }
+      attr_accessor :updated
+
+      # Id of the creator.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :creator
+
+      # Id of the last updater.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :updater
+
+      # A subscription preference topic in your workspace.
+      sig do
+        params(
+          id: String,
+          allowed_preferences:
+            T::Array[
+              Courier::WorkspacePreferenceTopicGetResponse::AllowedPreference::OrSymbol
+            ],
+          created: String,
+          default_status:
+            Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus::OrSymbol,
+          include_unsubscribe_header: T::Boolean,
+          name: String,
+          routing_options: T::Array[Courier::ChannelClassification::OrSymbol],
+          topic_data: T::Hash[Symbol, T.anything],
+          updated: String,
+          creator: T.nilable(String),
+          updater: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The preference topic id.
+        id:,
+        # Preference controls a recipient may customize. May be empty.
+        allowed_preferences:,
+        # ISO-8601 timestamp of when the topic was created.
+        created:,
+        # The default subscription status applied when a recipient has not set their own.
+        default_status:,
+        # Whether a list-unsubscribe header is included on emails for this topic.
+        include_unsubscribe_header:,
+        # Human-readable name.
+        name:,
+        # Default channels delivered for this topic. May be empty.
+        routing_options:,
+        # Arbitrary metadata associated with the topic.
+        topic_data:,
+        # ISO-8601 timestamp of the last update.
+        updated:,
+        # Id of the creator.
+        creator: nil,
+        # Id of the last updater.
+        updater: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            allowed_preferences:
+              T::Array[
+                Courier::WorkspacePreferenceTopicGetResponse::AllowedPreference::TaggedSymbol
+              ],
+            created: String,
+            default_status:
+              Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus::TaggedSymbol,
+            include_unsubscribe_header: T::Boolean,
+            name: String,
+            routing_options:
+              T::Array[Courier::ChannelClassification::TaggedSymbol],
+            topic_data: T::Hash[Symbol, T.anything],
+            updated: String,
+            creator: T.nilable(String),
+            updater: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # A preference control a recipient may customize for a topic.
+      module AllowedPreference
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Courier::WorkspacePreferenceTopicGetResponse::AllowedPreference
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SNOOZE =
+          T.let(
+            :snooze,
+            Courier::WorkspacePreferenceTopicGetResponse::AllowedPreference::TaggedSymbol
+          )
+        CHANNEL_PREFERENCES =
+          T.let(
+            :channel_preferences,
+            Courier::WorkspacePreferenceTopicGetResponse::AllowedPreference::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::WorkspacePreferenceTopicGetResponse::AllowedPreference::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The default subscription status applied when a recipient has not set their own.
+      module DefaultStatus
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        OPTED_OUT =
+          T.let(
+            :OPTED_OUT,
+            Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus::TaggedSymbol
+          )
+        OPTED_IN =
+          T.let(
+            :OPTED_IN,
+            Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus::TaggedSymbol
+          )
+        REQUIRED =
+          T.let(
+            :REQUIRED,
+            Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::WorkspacePreferenceTopicGetResponse::DefaultStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/workspace_preference_topic_list_response.rbi

@@ -0,0 +1,36 @@
+# typed: strong
+
+module Courier
+  module Models
+    class WorkspacePreferenceTopicListResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::WorkspacePreferenceTopicListResponse,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Array[Courier::WorkspacePreferenceTopicGetResponse]) }
+      attr_accessor :results
+
+      # Topics contained in a workspace preference.
+      sig do
+        params(
+          results:
+            T::Array[Courier::WorkspacePreferenceTopicGetResponse::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(results:)
+      end
+
+      sig do
+        override.returns(
+          { results: T::Array[Courier::WorkspacePreferenceTopicGetResponse] }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/workspace_preference_topic_replace_request.rbi

@@ -0,0 +1,185 @@
+# typed: strong
+
+module Courier
+  module Models
+    class WorkspacePreferenceTopicReplaceRequest < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::WorkspacePreferenceTopicReplaceRequest,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # The default subscription status applied when a recipient has not set their own.
+      sig do
+        returns(
+          Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus::OrSymbol
+        )
+      end
+      attr_accessor :default_status
+
+      # Human-readable name for the preference topic.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # Preference controls a recipient may customize. Omit to clear.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[
+              Courier::WorkspacePreferenceTopicReplaceRequest::AllowedPreference::OrSymbol
+            ]
+          )
+        )
+      end
+      attr_accessor :allowed_preferences
+
+      # Whether to include a list-unsubscribe header on emails for this topic.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_accessor :include_unsubscribe_header
+
+      # Default channels delivered for this topic. Omit to clear.
+      sig do
+        returns(T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]))
+      end
+      attr_accessor :routing_options
+
+      # Arbitrary metadata associated with the topic. Omit to clear.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :topic_data
+
+      # Request body for replacing a preference topic. Full document replacement;
+      # missing optional fields are cleared.
+      sig do
+        params(
+          default_status:
+            Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus::OrSymbol,
+          name: String,
+          allowed_preferences:
+            T.nilable(
+              T::Array[
+                Courier::WorkspacePreferenceTopicReplaceRequest::AllowedPreference::OrSymbol
+              ]
+            ),
+          include_unsubscribe_header: T.nilable(T::Boolean),
+          routing_options:
+            T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
+          topic_data: T.nilable(T::Hash[Symbol, T.anything])
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The default subscription status applied when a recipient has not set their own.
+        default_status:,
+        # Human-readable name for the preference topic.
+        name:,
+        # Preference controls a recipient may customize. Omit to clear.
+        allowed_preferences: nil,
+        # Whether to include a list-unsubscribe header on emails for this topic.
+        include_unsubscribe_header: nil,
+        # Default channels delivered for this topic. Omit to clear.
+        routing_options: nil,
+        # Arbitrary metadata associated with the topic. Omit to clear.
+        topic_data: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            default_status:
+              Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus::OrSymbol,
+            name: String,
+            allowed_preferences:
+              T.nilable(
+                T::Array[
+                  Courier::WorkspacePreferenceTopicReplaceRequest::AllowedPreference::OrSymbol
+                ]
+              ),
+            include_unsubscribe_header: T.nilable(T::Boolean),
+            routing_options:
+              T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
+            topic_data: T.nilable(T::Hash[Symbol, T.anything])
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The default subscription status applied when a recipient has not set their own.
+      module DefaultStatus
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        OPTED_OUT =
+          T.let(
+            :OPTED_OUT,
+            Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus::TaggedSymbol
+          )
+        OPTED_IN =
+          T.let(
+            :OPTED_IN,
+            Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus::TaggedSymbol
+          )
+        REQUIRED =
+          T.let(
+            :REQUIRED,
+            Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::WorkspacePreferenceTopicReplaceRequest::DefaultStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # A preference control a recipient may customize for a topic.
+      module AllowedPreference
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Courier::WorkspacePreferenceTopicReplaceRequest::AllowedPreference
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SNOOZE =
+          T.let(
+            :snooze,
+            Courier::WorkspacePreferenceTopicReplaceRequest::AllowedPreference::TaggedSymbol
+          )
+        CHANNEL_PREFERENCES =
+          T.let(
+            :channel_preferences,
+            Courier::WorkspacePreferenceTopicReplaceRequest::AllowedPreference::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::WorkspacePreferenceTopicReplaceRequest::AllowedPreference::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/workspace_preferences/topic_archive_params.rbi

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

data/rbi/courier/models/workspace_preferences/topic_create_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Courier
+  module Models
+    module WorkspacePreferences
+      class TopicCreateParams < Courier::Models::WorkspacePreferenceTopicCreateRequest
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::WorkspacePreferences::TopicCreateParams,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :section_id
+
+        sig do
+          params(
+            section_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(section_id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            { section_id: String, request_options: Courier::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end