trycourier 4.10.0 → 4.10.2

data/rbi/courier/models/notification_template_response.rbi

@@ -0,0 +1,120 @@
+# typed: strong
+
+module Courier
+  module Models
+    class NotificationTemplateResponse < Courier::Models::NotificationTemplatePayload
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::NotificationTemplateResponse,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # The template ID.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Epoch milliseconds when the template was created.
+      sig { returns(Integer) }
+      attr_accessor :created
+
+      # User ID of the creator.
+      sig { returns(String) }
+      attr_accessor :creator
+
+      # The template state. Always uppercase.
+      sig do
+        returns(Courier::NotificationTemplateResponse::State::TaggedSymbol)
+      end
+      attr_accessor :state
+
+      # Epoch milliseconds of last update.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :updated
+
+      sig { params(updated: Integer).void }
+      attr_writer :updated
+
+      # User ID of the last updater.
+      sig { returns(T.nilable(String)) }
+      attr_reader :updater
+
+      sig { params(updater: String).void }
+      attr_writer :updater
+
+      # Response for GET /notifications/{id}, POST /notifications, and PUT
+      # /notifications/{id}. Returns all template fields at the top level.
+      sig do
+        params(
+          id: String,
+          created: Integer,
+          creator: String,
+          state: Courier::NotificationTemplateResponse::State::OrSymbol,
+          updated: Integer,
+          updater: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The template ID.
+        id:,
+        # Epoch milliseconds when the template was created.
+        created:,
+        # User ID of the creator.
+        creator:,
+        # The template state. Always uppercase.
+        state:,
+        # Epoch milliseconds of last update.
+        updated: nil,
+        # User ID of the last updater.
+        updater: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created: Integer,
+            creator: String,
+            state: Courier::NotificationTemplateResponse::State::TaggedSymbol,
+            updated: Integer,
+            updater: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The template state. Always uppercase.
+      module State
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::NotificationTemplateResponse::State)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DRAFT =
+          T.let(
+            :DRAFT,
+            Courier::NotificationTemplateResponse::State::TaggedSymbol
+          )
+        PUBLISHED =
+          T.let(
+            :PUBLISHED,
+            Courier::NotificationTemplateResponse::State::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Courier::NotificationTemplateResponse::State::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notification_template_update_request.rbi

@@ -11,8 +11,8 @@ module Courier
           )
         end
 
-      # Full document shape used in POST and PUT request bodies, and returned inside the
-      # GET response envelope.
+      # Core template fields used in POST and PUT request bodies (nested under a
+      # `notification` key) and returned at the top level in responses.
       sig { returns(Courier::NotificationTemplatePayload) }
       attr_reader :notification
 
@@ -46,8 +46,8 @@ module Courier
         ).returns(T.attached_class)
       end
       def self.new(
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after update. Case-insensitive input, normalized to uppercase in
         # the response. Defaults to "DRAFT".

data/rbi/courier/models/provider_update_params.rbi

@@ -14,7 +14,8 @@ module Courier
       sig { returns(String) }
       attr_accessor :id
 
-      # The provider key identifying the type.
+      # The provider key identifying the type. Required on every request because it
+      # selects the provider-specific settings schema for validation.
       sig { returns(String) }
       attr_accessor :provider
 
@@ -53,7 +54,8 @@ module Courier
       end
       def self.new(
         id:,
-        # The provider key identifying the type.
+        # The provider key identifying the type. Required on every request because it
+        # selects the provider-specific settings schema for validation.
         provider:,
         # Updated alias. Omit to clear.
         alias_: nil,

data/rbi/courier/models.rbi

@@ -266,17 +266,13 @@ module Courier
   NotificationTemplateCreateRequest =
     Courier::Models::NotificationTemplateCreateRequest
 
-  NotificationTemplateGetResponse =
-    Courier::Models::NotificationTemplateGetResponse
-
-  NotificationTemplateMutationResponse =
-    Courier::Models::NotificationTemplateMutationResponse
-
   NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   NotificationTemplatePublishRequest =
     Courier::Models::NotificationTemplatePublishRequest
 
+  NotificationTemplateResponse = Courier::Models::NotificationTemplateResponse
+
   NotificationTemplateState = Courier::Models::NotificationTemplateState
 
   NotificationTemplateSummary = Courier::Models::NotificationTemplateSummary
@@ -356,9 +352,6 @@ module Courier
 
   RoutingStrategyListResponse = Courier::Models::RoutingStrategyListResponse
 
-  RoutingStrategyMutationResponse =
-    Courier::Models::RoutingStrategyMutationResponse
-
   RoutingStrategyReplaceParams = Courier::Models::RoutingStrategyReplaceParams
 
   RoutingStrategyReplaceRequest = Courier::Models::RoutingStrategyReplaceRequest

data/rbi/courier/resources/notifications/checks.rbi

@@ -4,6 +4,7 @@ module Courier
   module Resources
     class Notifications
       class Checks
+        # Replace the checks for a notification template submission.
         sig do
           params(
             submission_id: String,
@@ -13,9 +14,9 @@ module Courier
           ).returns(Courier::Models::Notifications::CheckUpdateResponse)
         end
         def update(
-          # Path param
+          # Path param: Submission ID.
           submission_id,
-          # Path param
+          # Path param: Notification template ID.
           id:,
           # Body param
           checks:,
@@ -23,6 +24,7 @@ module Courier
         )
         end
 
+        # Retrieve the checks for a notification template submission.
         sig do
           params(
             submission_id: String,
@@ -30,9 +32,16 @@ module Courier
             request_options: Courier::RequestOptions::OrHash
           ).returns(Courier::Models::Notifications::CheckListResponse)
         end
-        def list(submission_id, id:, request_options: {})
+        def list(
+          # Submission ID.
+          submission_id,
+          # Notification template ID.
+          id:,
+          request_options: {}
+        )
         end
 
+        # Cancel a notification template submission.
         sig do
           params(
             submission_id: String,
@@ -40,7 +49,13 @@ module Courier
             request_options: Courier::RequestOptions::OrHash
           ).void
         end
-        def delete(submission_id, id:, request_options: {})
+        def delete(
+          # Submission ID.
+          submission_id,
+          # Notification template ID.
+          id:,
+          request_options: {}
+        )
         end
 
         # @api private

data/rbi/courier/resources/notifications.rbi

@@ -13,11 +13,11 @@ module Courier
           notification: Courier::NotificationTemplatePayload::OrHash,
           state: Courier::NotificationTemplateCreateRequest::State::OrSymbol,
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::NotificationTemplateMutationResponse)
+        ).returns(Courier::NotificationTemplateResponse)
       end
       def create(
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after creation. Case-insensitive input, normalized to uppercase
         # in the response. Defaults to "DRAFT".
@@ -33,7 +33,7 @@ module Courier
           id: String,
           version: String,
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::NotificationTemplateGetResponse)
+        ).returns(Courier::NotificationTemplateResponse)
       end
       def retrieve(
         # Template ID (nt\_ prefix).
@@ -211,13 +211,13 @@ module Courier
           notification: Courier::NotificationTemplatePayload::OrHash,
           state: Courier::NotificationTemplateUpdateRequest::State::OrSymbol,
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::NotificationTemplateMutationResponse)
+        ).returns(Courier::NotificationTemplateResponse)
       end
       def replace(
         # Template ID (nt\_ prefix).
         id,
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after update. Case-insensitive input, normalized to uppercase in
         # the response. Defaults to "DRAFT".

data/rbi/courier/resources/providers.rbi

@@ -47,9 +47,11 @@ module Courier
       )
       end
 
-      # Update an existing provider configuration. The `provider` key is required. All
-      # other fields are optional — omitted fields are cleared from the stored
-      # configuration (this is a full replacement, not a partial merge).
+      # Replace an existing provider configuration. The `provider` key is required and
+      # determines which provider-specific settings schema is applied. All other fields
+      # are optional — omitted fields are cleared from the stored configuration (this is
+      # a full replacement, not a partial merge). Changing the provider type for an
+      # existing configuration is not supported.
       sig do
         params(
           id: String,
@@ -63,7 +65,8 @@ module Courier
       def update(
         # A unique identifier of the provider configuration to update.
         id,
-        # The provider key identifying the type.
+        # The provider key identifying the type. Required on every request because it
+        # selects the provider-specific settings schema for validation.
         provider:,
         # Updated alias. Omit to clear.
         alias_: nil,

data/rbi/courier/resources/routing_strategies.rbi

@@ -15,7 +15,7 @@ module Courier
             T.nilable(T::Hash[Symbol, Courier::MessageProvidersType::OrHash]),
           tags: T.nilable(T::Array[String]),
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::RoutingStrategyMutationResponse)
+        ).returns(Courier::RoutingStrategyGetResponse)
       end
       def create(
         # Human-readable name for the routing strategy.
@@ -117,7 +117,7 @@ module Courier
             T.nilable(T::Hash[Symbol, Courier::MessageProvidersType::OrHash]),
           tags: T.nilable(T::Array[String]),
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::RoutingStrategyMutationResponse)
+        ).returns(Courier::RoutingStrategyGetResponse)
       end
       def replace(
         # Routing strategy ID (rs\_ prefix).

data/sig/courier/models/notification_list_response.rbs

@@ -33,10 +33,10 @@ module Courier
             id: String,
             created_at: Integer,
             event_ids: ::Array[String],
-            note: String,
             routing: Courier::MessageRouting,
             topic_id: String,
             updated_at: Integer,
+            note: String,
             tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?,
             title: String?
           }
@@ -48,14 +48,16 @@ module Courier
 
           attr_accessor event_ids: ::Array[String]
 
-          attr_accessor note: String
-
           attr_accessor routing: Courier::MessageRouting
 
           attr_accessor topic_id: String
 
           attr_accessor updated_at: Integer
 
+          attr_reader note: String?
+
+          def note=: (String) -> String
+
           attr_accessor tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?
 
           attr_accessor title: String?
@@ -64,10 +66,10 @@ module Courier
             id: String,
             created_at: Integer,
             event_ids: ::Array[String],
-            note: String,
             routing: Courier::MessageRouting,
             topic_id: String,
             updated_at: Integer,
+            ?note: String,
             ?tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?,
             ?title: String?
           ) -> void
@@ -76,10 +78,10 @@ module Courier
             id: String,
             created_at: Integer,
             event_ids: ::Array[String],
-            note: String,
             routing: Courier::MessageRouting,
             topic_id: String,
             updated_at: Integer,
+            note: String,
             tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?,
             title: String?
           }

data/sig/courier/models/notification_template_response.rbs

@@ -0,0 +1,70 @@
+module Courier
+  module Models
+    type notification_template_response =
+      {
+        id: String,
+        created: Integer,
+        creator: String,
+        state: Courier::Models::NotificationTemplateResponse::state,
+        updated: Integer,
+        updater: String
+      }
+
+    class NotificationTemplateResponse < Courier::Models::NotificationTemplatePayload
+      def id: -> String
+
+      def id=: (String _) -> String
+
+      def created: -> Integer
+
+      def created=: (Integer _) -> Integer
+
+      def creator: -> String
+
+      def creator=: (String _) -> String
+
+      def state: -> Courier::Models::NotificationTemplateResponse::state
+
+      def state=: (
+        Courier::Models::NotificationTemplateResponse::state _
+      ) -> Courier::Models::NotificationTemplateResponse::state
+
+      def updated: -> Integer?
+
+      def updated=: (Integer _) -> Integer
+
+      def updater: -> String?
+
+      def updater=: (String _) -> String
+
+      def initialize: (
+        id: String,
+        created: Integer,
+        creator: String,
+        state: Courier::Models::NotificationTemplateResponse::state,
+        ?updated: Integer,
+        ?updater: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        created: Integer,
+        creator: String,
+        state: Courier::Models::NotificationTemplateResponse::state,
+        updated: Integer,
+        updater: String
+      }
+
+      type state = :DRAFT | :PUBLISHED
+
+      module State
+        extend Courier::Internal::Type::Enum
+
+        DRAFT: :DRAFT
+        PUBLISHED: :PUBLISHED
+
+        def self?.values: -> ::Array[Courier::Models::NotificationTemplateResponse::state]
+      end
+    end
+  end
+end

data/sig/courier/models.rbs

@@ -255,14 +255,12 @@ module Courier
 
   class NotificationTemplateCreateRequest = Courier::Models::NotificationTemplateCreateRequest
 
-  class NotificationTemplateGetResponse = Courier::Models::NotificationTemplateGetResponse
-
-  class NotificationTemplateMutationResponse = Courier::Models::NotificationTemplateMutationResponse
-
   class NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   class NotificationTemplatePublishRequest = Courier::Models::NotificationTemplatePublishRequest
 
+  class NotificationTemplateResponse = Courier::Models::NotificationTemplateResponse
+
   module NotificationTemplateState = Courier::Models::NotificationTemplateState
 
   class NotificationTemplateSummary = Courier::Models::NotificationTemplateSummary
@@ -337,8 +335,6 @@ module Courier
 
   class RoutingStrategyListResponse = Courier::Models::RoutingStrategyListResponse
 
-  class RoutingStrategyMutationResponse = Courier::Models::RoutingStrategyMutationResponse
-
   class RoutingStrategyReplaceParams = Courier::Models::RoutingStrategyReplaceParams
 
   class RoutingStrategyReplaceRequest = Courier::Models::RoutingStrategyReplaceRequest

data/sig/courier/resources/notifications.rbs

@@ -7,13 +7,13 @@ module Courier
         notification: Courier::NotificationTemplatePayload,
         ?state: Courier::Models::NotificationTemplateCreateRequest::state,
         ?request_options: Courier::request_opts
-      ) -> Courier::NotificationTemplateMutationResponse
+      ) -> Courier::NotificationTemplateResponse
 
       def retrieve: (
         String id,
         ?version: String,
         ?request_options: Courier::request_opts
-      ) -> Courier::NotificationTemplateGetResponse
+      ) -> Courier::NotificationTemplateResponse
 
       def list: (
         ?cursor: String?,
@@ -70,7 +70,7 @@ module Courier
         notification: Courier::NotificationTemplatePayload,
         ?state: Courier::Models::NotificationTemplateUpdateRequest::state,
         ?request_options: Courier::request_opts
-      ) -> Courier::NotificationTemplateMutationResponse
+      ) -> Courier::NotificationTemplateResponse
 
       def retrieve_content: (
         String id,

data/sig/courier/resources/routing_strategies.rbs

@@ -9,7 +9,7 @@ module Courier
         ?providers: Courier::Models::message_providers?,
         ?tags: ::Array[String]?,
         ?request_options: Courier::request_opts
-      ) -> Courier::RoutingStrategyMutationResponse
+      ) -> Courier::RoutingStrategyGetResponse
 
       def retrieve: (
         String id,
@@ -40,7 +40,7 @@ module Courier
         ?providers: Courier::Models::message_providers?,
         ?tags: ::Array[String]?,
         ?request_options: Courier::request_opts
-      ) -> Courier::RoutingStrategyMutationResponse
+      ) -> Courier::RoutingStrategyGetResponse
 
       def initialize: (client: Courier::Client) -> void
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 4.10.0
+  version: 4.10.2
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-08 00:00:00.000000000 Z
+date: 2026-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -219,10 +219,9 @@ files:
 - lib/courier/models/notification_retrieve_content_response.rb
 - lib/courier/models/notification_retrieve_params.rb
 - lib/courier/models/notification_template_create_request.rb
-- lib/courier/models/notification_template_get_response.rb
-- lib/courier/models/notification_template_mutation_response.rb
 - lib/courier/models/notification_template_payload.rb
 - lib/courier/models/notification_template_publish_request.rb
+- lib/courier/models/notification_template_response.rb
 - lib/courier/models/notification_template_state.rb
 - lib/courier/models/notification_template_summary.rb
 - lib/courier/models/notification_template_update_request.rb
@@ -275,7 +274,6 @@ files:
 - lib/courier/models/routing_strategy_list_notifications_params.rb
 - lib/courier/models/routing_strategy_list_params.rb
 - lib/courier/models/routing_strategy_list_response.rb
-- lib/courier/models/routing_strategy_mutation_response.rb
 - lib/courier/models/routing_strategy_replace_params.rb
 - lib/courier/models/routing_strategy_replace_request.rb
 - lib/courier/models/routing_strategy_retrieve_params.rb
@@ -560,10 +558,9 @@ files:
 - rbi/courier/models/notification_retrieve_content_response.rbi
 - rbi/courier/models/notification_retrieve_params.rbi
 - rbi/courier/models/notification_template_create_request.rbi
-- rbi/courier/models/notification_template_get_response.rbi
-- rbi/courier/models/notification_template_mutation_response.rbi
 - rbi/courier/models/notification_template_payload.rbi
 - rbi/courier/models/notification_template_publish_request.rbi
+- rbi/courier/models/notification_template_response.rbi
 - rbi/courier/models/notification_template_state.rbi
 - rbi/courier/models/notification_template_summary.rbi
 - rbi/courier/models/notification_template_update_request.rbi
@@ -616,7 +613,6 @@ files:
 - rbi/courier/models/routing_strategy_list_notifications_params.rbi
 - rbi/courier/models/routing_strategy_list_params.rbi
 - rbi/courier/models/routing_strategy_list_response.rbi
-- rbi/courier/models/routing_strategy_mutation_response.rbi
 - rbi/courier/models/routing_strategy_replace_params.rbi
 - rbi/courier/models/routing_strategy_replace_request.rbi
 - rbi/courier/models/routing_strategy_retrieve_params.rbi
@@ -900,10 +896,9 @@ files:
 - sig/courier/models/notification_retrieve_content_response.rbs
 - sig/courier/models/notification_retrieve_params.rbs
 - sig/courier/models/notification_template_create_request.rbs
-- sig/courier/models/notification_template_get_response.rbs
-- sig/courier/models/notification_template_mutation_response.rbs
 - sig/courier/models/notification_template_payload.rbs
 - sig/courier/models/notification_template_publish_request.rbs
+- sig/courier/models/notification_template_response.rbs
 - sig/courier/models/notification_template_state.rbs
 - sig/courier/models/notification_template_summary.rbs
 - sig/courier/models/notification_template_update_request.rbs
@@ -956,7 +951,6 @@ files:
 - sig/courier/models/routing_strategy_list_notifications_params.rbs
 - sig/courier/models/routing_strategy_list_params.rbs
 - sig/courier/models/routing_strategy_list_response.rbs
-- sig/courier/models/routing_strategy_mutation_response.rbs
 - sig/courier/models/routing_strategy_replace_params.rbs
 - sig/courier/models/routing_strategy_replace_request.rbs
 - sig/courier/models/routing_strategy_retrieve_params.rbs