trycourier 4.18.1 → 4.19.0

data/rbi/courier/models/users/preference_bulk_replace_params.rbi

@@ -0,0 +1,188 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Users
+      class PreferenceBulkReplaceParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Users::PreferenceBulkReplaceParams,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :user_id
+
+        # The complete set of topic overrides for the user. Up to 50 topics may be
+        # provided. Any existing override not listed here is reset to its topic default;
+        # an empty array resets every existing override.
+        sig do
+          returns(T::Array[Courier::Users::PreferenceBulkReplaceParams::Topic])
+        end
+        attr_accessor :topics
+
+        # Update the preferences of a user for this specific tenant context.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :tenant_id
+
+        sig do
+          params(
+            user_id: String,
+            topics:
+              T::Array[
+                Courier::Users::PreferenceBulkReplaceParams::Topic::OrHash
+              ],
+            tenant_id: T.nilable(String),
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          user_id:,
+          # The complete set of topic overrides for the user. Up to 50 topics may be
+          # provided. Any existing override not listed here is reset to its topic default;
+          # an empty array resets every existing override.
+          topics:,
+          # Update the preferences of a user for this specific tenant context.
+          tenant_id: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              user_id: String,
+              topics:
+                T::Array[Courier::Users::PreferenceBulkReplaceParams::Topic],
+              tenant_id: T.nilable(String),
+              request_options: Courier::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Topic < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Users::PreferenceBulkReplaceParams::Topic,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          # The subscription status to apply for this topic.
+          sig do
+            returns(
+              Courier::Users::PreferenceBulkReplaceParams::Topic::Status::OrSymbol
+            )
+          end
+          attr_accessor :status
+
+          # A unique identifier associated with a subscription topic.
+          sig { returns(String) }
+          attr_accessor :topic_id
+
+          # The channels a user has chosen to receive notifications through for this topic.
+          sig do
+            returns(
+              T.nilable(T::Array[Courier::ChannelClassification::OrSymbol])
+            )
+          end
+          attr_reader :custom_routing
+
+          sig do
+            params(
+              custom_routing: T::Array[Courier::ChannelClassification::OrSymbol]
+            ).void
+          end
+          attr_writer :custom_routing
+
+          # Whether the recipient has chosen specific delivery channels for this topic.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :has_custom_routing
+
+          sig { params(has_custom_routing: T::Boolean).void }
+          attr_writer :has_custom_routing
+
+          sig do
+            params(
+              status:
+                Courier::Users::PreferenceBulkReplaceParams::Topic::Status::OrSymbol,
+              topic_id: String,
+              custom_routing:
+                T::Array[Courier::ChannelClassification::OrSymbol],
+              has_custom_routing: T::Boolean
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The subscription status to apply for this topic.
+            status:,
+            # A unique identifier associated with a subscription topic.
+            topic_id:,
+            # The channels a user has chosen to receive notifications through for this topic.
+            custom_routing: nil,
+            # Whether the recipient has chosen specific delivery channels for this topic.
+            has_custom_routing: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                status:
+                  Courier::Users::PreferenceBulkReplaceParams::Topic::Status::OrSymbol,
+                topic_id: String,
+                custom_routing:
+                  T::Array[Courier::ChannelClassification::OrSymbol],
+                has_custom_routing: T::Boolean
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The subscription status to apply for this topic.
+          module Status
+            extend Courier::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Courier::Users::PreferenceBulkReplaceParams::Topic::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            OPTED_IN =
+              T.let(
+                :OPTED_IN,
+                Courier::Users::PreferenceBulkReplaceParams::Topic::Status::TaggedSymbol
+              )
+            OPTED_OUT =
+              T.let(
+                :OPTED_OUT,
+                Courier::Users::PreferenceBulkReplaceParams::Topic::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Courier::Users::PreferenceBulkReplaceParams::Topic::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/users/preference_bulk_replace_response.rbi

@@ -0,0 +1,50 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Users
+      class PreferenceBulkReplaceResponse < Courier::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Models::Users::PreferenceBulkReplaceResponse,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        # The ids of the overrides that were reset to their topic default.
+        sig { returns(T::Array[String]) }
+        attr_accessor :deleted
+
+        # The complete resulting set of topic overrides for the user.
+        sig { returns(T::Array[Courier::Users::BulkPreferenceTopic]) }
+        attr_accessor :items
+
+        sig do
+          params(
+            deleted: T::Array[String],
+            items: T::Array[Courier::Users::BulkPreferenceTopic::OrHash]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The ids of the overrides that were reset to their topic default.
+          deleted:,
+          # The complete resulting set of topic overrides for the user.
+          items:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              deleted: T::Array[String],
+              items: T::Array[Courier::Users::BulkPreferenceTopic]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/users/preference_bulk_update_params.rbi

@@ -0,0 +1,186 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Users
+      class PreferenceBulkUpdateParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Users::PreferenceBulkUpdateParams,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :user_id
+
+        # The topics to create or update. Between 1 and 50 topics may be provided in a
+        # single request.
+        sig do
+          returns(T::Array[Courier::Users::PreferenceBulkUpdateParams::Topic])
+        end
+        attr_accessor :topics
+
+        # Update the preferences of a user for this specific tenant context.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :tenant_id
+
+        sig do
+          params(
+            user_id: String,
+            topics:
+              T::Array[
+                Courier::Users::PreferenceBulkUpdateParams::Topic::OrHash
+              ],
+            tenant_id: T.nilable(String),
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          user_id:,
+          # The topics to create or update. Between 1 and 50 topics may be provided in a
+          # single request.
+          topics:,
+          # Update the preferences of a user for this specific tenant context.
+          tenant_id: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              user_id: String,
+              topics:
+                T::Array[Courier::Users::PreferenceBulkUpdateParams::Topic],
+              tenant_id: T.nilable(String),
+              request_options: Courier::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Topic < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Users::PreferenceBulkUpdateParams::Topic,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          # The subscription status to apply for this topic.
+          sig do
+            returns(
+              Courier::Users::PreferenceBulkUpdateParams::Topic::Status::OrSymbol
+            )
+          end
+          attr_accessor :status
+
+          # A unique identifier associated with a subscription topic.
+          sig { returns(String) }
+          attr_accessor :topic_id
+
+          # The channels a user has chosen to receive notifications through for this topic.
+          sig do
+            returns(
+              T.nilable(T::Array[Courier::ChannelClassification::OrSymbol])
+            )
+          end
+          attr_reader :custom_routing
+
+          sig do
+            params(
+              custom_routing: T::Array[Courier::ChannelClassification::OrSymbol]
+            ).void
+          end
+          attr_writer :custom_routing
+
+          # Whether the recipient has chosen specific delivery channels for this topic.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :has_custom_routing
+
+          sig { params(has_custom_routing: T::Boolean).void }
+          attr_writer :has_custom_routing
+
+          sig do
+            params(
+              status:
+                Courier::Users::PreferenceBulkUpdateParams::Topic::Status::OrSymbol,
+              topic_id: String,
+              custom_routing:
+                T::Array[Courier::ChannelClassification::OrSymbol],
+              has_custom_routing: T::Boolean
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The subscription status to apply for this topic.
+            status:,
+            # A unique identifier associated with a subscription topic.
+            topic_id:,
+            # The channels a user has chosen to receive notifications through for this topic.
+            custom_routing: nil,
+            # Whether the recipient has chosen specific delivery channels for this topic.
+            has_custom_routing: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                status:
+                  Courier::Users::PreferenceBulkUpdateParams::Topic::Status::OrSymbol,
+                topic_id: String,
+                custom_routing:
+                  T::Array[Courier::ChannelClassification::OrSymbol],
+                has_custom_routing: T::Boolean
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The subscription status to apply for this topic.
+          module Status
+            extend Courier::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Courier::Users::PreferenceBulkUpdateParams::Topic::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            OPTED_IN =
+              T.let(
+                :OPTED_IN,
+                Courier::Users::PreferenceBulkUpdateParams::Topic::Status::TaggedSymbol
+              )
+            OPTED_OUT =
+              T.let(
+                :OPTED_OUT,
+                Courier::Users::PreferenceBulkUpdateParams::Topic::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Courier::Users::PreferenceBulkUpdateParams::Topic::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/users/preference_bulk_update_response.rbi

@@ -0,0 +1,94 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Users
+      class PreferenceBulkUpdateResponse < Courier::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Models::Users::PreferenceBulkUpdateResponse,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        # The topics that could not be applied, each with a reason.
+        sig do
+          returns(
+            T::Array[
+              Courier::Models::Users::PreferenceBulkUpdateResponse::Error
+            ]
+          )
+        end
+        attr_accessor :errors
+
+        # The topics that were successfully created or updated.
+        sig { returns(T::Array[Courier::Users::BulkPreferenceTopic]) }
+        attr_accessor :items
+
+        sig do
+          params(
+            errors:
+              T::Array[
+                Courier::Models::Users::PreferenceBulkUpdateResponse::Error::OrHash
+              ],
+            items: T::Array[Courier::Users::BulkPreferenceTopic::OrHash]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The topics that could not be applied, each with a reason.
+          errors:,
+          # The topics that were successfully created or updated.
+          items:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              errors:
+                T::Array[
+                  Courier::Models::Users::PreferenceBulkUpdateResponse::Error
+                ],
+              items: T::Array[Courier::Users::BulkPreferenceTopic]
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Error < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Models::Users::PreferenceBulkUpdateResponse::Error,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          # A human-readable explanation of why the topic could not be applied.
+          sig { returns(String) }
+          attr_accessor :reason
+
+          sig { returns(String) }
+          attr_accessor :topic_id
+
+          # A single topic that could not be applied in a bulk preference request.
+          sig do
+            params(reason: String, topic_id: String).returns(T.attached_class)
+          end
+          def self.new(
+            # A human-readable explanation of why the topic could not be applied.
+            reason:,
+            topic_id:
+          )
+          end
+
+          sig { override.returns({ reason: String, topic_id: String }) }
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/workspace_preference_create_request.rbi

@@ -15,6 +15,10 @@ module Courier
       sig { returns(String) }
       attr_accessor :name
 
+      # Optional description shown under the section on the hosted preferences page.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :description
+
       # Whether the workspace preference defines custom routing for its topics.
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :has_custom_routing
@@ -29,6 +33,7 @@ module Courier
       sig do
         params(
           name: String,
+          description: T.nilable(String),
           has_custom_routing: T.nilable(T::Boolean),
           routing_options:
             T.nilable(T::Array[Courier::ChannelClassification::OrSymbol])
@@ -37,6 +42,8 @@ module Courier
       def self.new(
         # Human-readable name for the workspace preference.
         name:,
+        # Optional description shown under the section on the hosted preferences page.
+        description: nil,
         # Whether the workspace preference defines custom routing for its topics.
         has_custom_routing: nil,
         # Default channels for the workspace preference. Defaults to empty if omitted.
@@ -48,6 +55,7 @@ module Courier
         override.returns(
           {
             name: String,
+            description: T.nilable(String),
             has_custom_routing: T.nilable(T::Boolean),
             routing_options:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol])

data/rbi/courier/models/workspace_preference_get_response.rbi

@@ -39,6 +39,10 @@ module Courier
       sig { returns(T.nilable(String)) }
       attr_accessor :creator
 
+      # Optional description shown under the section on the hosted preferences page.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :description
+
       # ISO-8601 timestamp of the last update.
       sig { returns(T.nilable(String)) }
       attr_accessor :updated
@@ -58,6 +62,7 @@ module Courier
           topics:
             T::Array[Courier::WorkspacePreferenceTopicGetResponse::OrHash],
           creator: T.nilable(String),
+          description: T.nilable(String),
           updated: T.nilable(String),
           updater: T.nilable(String)
         ).returns(T.attached_class)
@@ -77,6 +82,8 @@ module Courier
         topics:,
         # Id of the creator.
         creator: nil,
+        # Optional description shown under the section on the hosted preferences page.
+        description: nil,
         # ISO-8601 timestamp of the last update.
         updated: nil,
         # Id of the last updater.
@@ -95,6 +102,7 @@ module Courier
               T::Array[Courier::ChannelClassification::TaggedSymbol],
             topics: T::Array[Courier::WorkspacePreferenceTopicGetResponse],
             creator: T.nilable(String),
+            description: T.nilable(String),
             updated: T.nilable(String),
             updater: T.nilable(String)
           }

data/rbi/courier/models/workspace_preference_publish_params.rbi

@@ -2,7 +2,7 @@
 
 module Courier
   module Models
-    class WorkspacePreferencePublishParams < Courier::Internal::Type::BaseModel
+    class WorkspacePreferencePublishParams < Courier::Models::PublishPreferencesRequest
       extend Courier::Internal::Type::RequestParameters::Converter
       include Courier::Internal::Type::RequestParameters
 

data/rbi/courier/models/workspace_preference_replace_request.rbi

@@ -15,6 +15,11 @@ module Courier
       sig { returns(String) }
       attr_accessor :name
 
+      # Optional description shown under the section on the hosted preferences page.
+      # Omit to clear.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :description
+
       # Whether the workspace preference defines custom routing for its topics.
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :has_custom_routing
@@ -30,6 +35,7 @@ module Courier
       sig do
         params(
           name: String,
+          description: T.nilable(String),
           has_custom_routing: T.nilable(T::Boolean),
           routing_options:
             T.nilable(T::Array[Courier::ChannelClassification::OrSymbol])
@@ -38,6 +44,9 @@ module Courier
       def self.new(
         # Human-readable name for the workspace preference.
         name:,
+        # Optional description shown under the section on the hosted preferences page.
+        # Omit to clear.
+        description: nil,
         # Whether the workspace preference defines custom routing for its topics.
         has_custom_routing: nil,
         # Default channels for the workspace preference. Omit to clear.
@@ -49,6 +58,7 @@ module Courier
         override.returns(
           {
             name: String,
+            description: T.nilable(String),
             has_custom_routing: T.nilable(T::Boolean),
             routing_options:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol])

data/rbi/courier/models/workspace_preference_topic_create_request.rbi

@@ -36,6 +36,10 @@ module Courier
       end
       attr_accessor :allowed_preferences
 
+      # Optional description shown under the topic on the hosted preferences page.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :description
+
       # Whether to include a list-unsubscribe header on emails for this topic.
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :include_unsubscribe_header
@@ -62,6 +66,7 @@ module Courier
                 Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::OrSymbol
               ]
             ),
+          description: T.nilable(String),
           include_unsubscribe_header: T.nilable(T::Boolean),
           routing_options:
             T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
@@ -76,6 +81,8 @@ module Courier
         # Preference controls a recipient may customize for this topic. Defaults to empty
         # if omitted.
         allowed_preferences: nil,
+        # Optional description shown under the topic on the hosted preferences page.
+        description: 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.
@@ -97,6 +104,7 @@ module Courier
                   Courier::WorkspacePreferenceTopicCreateRequest::AllowedPreference::OrSymbol
                 ]
               ),
+            description: T.nilable(String),
             include_unsubscribe_header: T.nilable(T::Boolean),
             routing_options:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),