trycourier 4.9.0 → 4.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3402c91918996a99ee5f6847167c87f49ca1d0a711da6de88c1ab620ea1ca58c
-  data.tar.gz: cc72a6efa7d4c23d88069a482f153da899680bcebc0a418e85361e759441fe52
+  metadata.gz: 0f858f38c4f9b150bb7ae15d41485742e215ee802b55ebf66eaa03f2fbd1ac02
+  data.tar.gz: 42e013bd3562dfcce1b12bd980c02f481cd7f8c5290d364e16a3a395d957569b
 SHA512:
-  metadata.gz: bea7a9fa2457eca3c876aa38a6bbb492fec8f965b06e4b2e1a8ae3df10454cfe08aa04536546e392a36c03341a54bf7103a8444c6de9dd97c1cdc35abba942f6
-  data.tar.gz: 10913c571258c67c3ce10362794e30d2a742b117cde9f4ddbe02a8eabf7c568be4bb64871169ece92b2fe443a3480471adab6c506ac41b7a172579740827b3a0
+  metadata.gz: 91849f5ef3635836ff2976f9bbcad8f337464d89aea6728e377a3c39b45db79116cb2bf13b0946f3d1ed98fa8f584b8e8a38fa0cd52b6cc186563e203c2ad583
+  data.tar.gz: 4dcd5c0b990e1e4e121078106637462a3894d5d8b5350bf1074e1101f695d7782e63691144d1255e680b4feeb1c15c91e3ac04bf9eb499593e4914828ce9e088

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 4.10.1 (2026-04-13)
+
+Full Changelog: [v4.10.0...v4.10.1](https://github.com/trycourier/courier-ruby/compare/v4.10.0...v4.10.1)
+
+### Bug Fixes
+
+* multipart encoding for file arrays ([6f54534](https://github.com/trycourier/courier-ruby/commit/6f545347ec738929c45b89476d4fc02aa185760b))
+* **types:** correct notifications/routing_strategies return types, remove mutation models ([8020a8f](https://github.com/trycourier/courier-ruby/commit/8020a8fa2015d5f5b4c4703a4354acd3283193bc))
+
+## 4.10.0 (2026-04-08)
+
+Full Changelog: [v4.9.0...v4.10.0](https://github.com/trycourier/courier-ruby/compare/v4.9.0...v4.10.0)
+
+### Features
+
+* **api:** add list_notifications method to routing_strategies ([ce8f121](https://github.com/trycourier/courier-ruby/commit/ce8f1217d52377144e053e51497310e71fef1dea))
+* **api:** add put_content/put_element/put_locale, remove draft resource, update retrieve_content ([ecb21e4](https://github.com/trycourier/courier-ruby/commit/ecb21e4913ec80513471153abab2e75d80afffb5))
+
 ## 4.9.0 (2026-04-01)
 
 Full Changelog: [v4.8.0...v4.9.0](https://github.com/trycourier/courier-ruby/compare/v4.8.0...v4.9.0)

data/lib/courier/internal/util.rb

@@ -610,6 +610,7 @@ module Courier
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -619,7 +620,7 @@ module Courier
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || Courier::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -635,6 +636,7 @@ module Courier
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private

data/lib/courier/models/associated_notification_list_response.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#list_notifications
+    class AssociatedNotificationListResponse < Courier::Internal::Type::BaseModel
+      # @!attribute paging
+      #
+      #   @return [Courier::Models::Paging]
+      required :paging, -> { Courier::Paging }
+
+      # @!attribute results
+      #
+      #   @return [Array<Courier::Models::NotificationTemplateSummary>]
+      required :results, -> { Courier::Internal::Type::ArrayOf[Courier::NotificationTemplateSummary] }
+
+      # @!method initialize(paging:, results:)
+      #   Paginated list of notification templates associated with a routing strategy.
+      #
+      #   @param paging [Courier::Models::Paging]
+      #   @param results [Array<Courier::Models::NotificationTemplateSummary>]
+    end
+  end
+end

data/lib/courier/models/element_with_checksums.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class ElementWithChecksums < Courier::Internal::Type::BaseModel
+      # @!attribute checksum
+      #   MD5 hash of translatable content.
+      #
+      #   @return [String]
+      required :checksum, String
+
+      # @!attribute type
+      #   Element type (text, meta, action, etc.).
+      #
+      #   @return [String]
+      required :type, String
+
+      # @!attribute id
+      #
+      #   @return [String, nil]
+      optional :id, String
+
+      # @!attribute elements
+      #   Nested child elements (for group-type elements).
+      #
+      #   @return [Array<Courier::Models::ElementWithChecksums>, nil]
+      optional :elements, -> { Courier::Internal::Type::ArrayOf[Courier::ElementWithChecksums] }
+
+      # @!attribute locales
+      #   Locale-specific content with checksums.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::ElementWithChecksums::Locale}, nil]
+      optional :locales, -> { Courier::Internal::Type::HashOf[Courier::ElementWithChecksums::Locale] }
+
+      # @!method initialize(checksum:, type:, id: nil, elements: nil, locales: nil)
+      #   An element with its content checksum and optional nested elements and locale
+      #   checksums.
+      #
+      #   @param checksum [String] MD5 hash of translatable content.
+      #
+      #   @param type [String] Element type (text, meta, action, etc.).
+      #
+      #   @param id [String]
+      #
+      #   @param elements [Array<Courier::Models::ElementWithChecksums>] Nested child elements (for group-type elements).
+      #
+      #   @param locales [Hash{Symbol=>Courier::Models::ElementWithChecksums::Locale}] Locale-specific content with checksums.
+
+      class Locale < Courier::Internal::Type::BaseModel
+        # @!attribute checksum
+        #
+        #   @return [String]
+        required :checksum, String
+
+        # @!method initialize(checksum:)
+        #   @param checksum [String]
+      end
+    end
+  end
+end

data/lib/courier/models/notification_content_get_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationContentGetResponse < Courier::Internal::Type::BaseModel
+      # @!attribute elements
+      #
+      #   @return [Array<Courier::Models::ElementWithChecksums>]
+      required :elements, -> { Courier::Internal::Type::ArrayOf[Courier::ElementWithChecksums] }
+
+      # @!attribute version
+      #   Content version identifier.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(elements:, version:)
+      #   Elemental content response for V2 templates. Contains versioned elements with
+      #   content checksums.
+      #
+      #   @param elements [Array<Courier::Models::ElementWithChecksums>]
+      #
+      #   @param version [String] Content version identifier.
+    end
+  end
+end

data/lib/courier/models/notification_content_mutation_response.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#put_content
+    class NotificationContentMutationResponse < Courier::Internal::Type::BaseModel
+      # @!attribute id
+      #   Template ID.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute elements
+      #
+      #   @return [Array<Courier::Models::NotificationContentMutationResponse::Element>]
+      required :elements,
+               -> { Courier::Internal::Type::ArrayOf[Courier::NotificationContentMutationResponse::Element] }
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState]
+      required :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!attribute version
+      #   Content version identifier.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(id:, elements:, state:, version:)
+      #   Shared mutation response for `PUT` content, `PUT` element, and `PUT` locale
+      #   operations. Contains the template ID, content version, per-element checksums,
+      #   and resulting state.
+      #
+      #   @param id [String] Template ID.
+      #
+      #   @param elements [Array<Courier::Models::NotificationContentMutationResponse::Element>]
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+      #
+      #   @param version [String] Content version identifier.
+
+      class Element < Courier::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute checksum
+        #
+        #   @return [String]
+        required :checksum, String
+
+        # @!method initialize(id:, checksum:)
+        #   @param id [String]
+        #   @param checksum [String]
+      end
+    end
+  end
+end

data/lib/courier/models/notification_content_put_request.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationContentPutRequest < Courier::Internal::Type::BaseModel
+      # @!attribute content
+      #   Elemental content payload. The server defaults `version` when omitted.
+      #
+      #   @return [Courier::Models::NotificationContentPutRequest::Content]
+      required :content, -> { Courier::NotificationContentPutRequest::Content }
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState, nil]
+      optional :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!method initialize(content:, state: nil)
+      #   Request body for replacing the elemental content of a notification template.
+      #
+      #   @param content [Courier::Models::NotificationContentPutRequest::Content] Elemental content payload. The server defaults `version` when omitted.
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+
+      # @see Courier::Models::NotificationContentPutRequest#content
+      class Content < Courier::Internal::Type::BaseModel
+        # @!attribute elements
+        #
+        #   @return [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType, Courier::Models::ElementalHTMLNodeWithType>]
+        required :elements, -> { Courier::Internal::Type::ArrayOf[union: Courier::ElementalNode] }
+
+        # @!attribute version
+        #   Content version identifier (e.g., `2022-01-01`). Optional; server defaults when
+        #   omitted.
+        #
+        #   @return [String, nil]
+        optional :version, String
+
+        # @!method initialize(elements:, version: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::NotificationContentPutRequest::Content} for more details.
+        #
+        #   Elemental content payload. The server defaults `version` when omitted.
+        #
+        #   @param elements [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType, Courier::Models::ElementalHTMLNodeWithType>]
+        #
+        #   @param version [String] Content version identifier (e.g., `2022-01-01`). Optional; server defaults when
+      end
+    end
+  end
+end

data/lib/courier/models/notification_element_put_request.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationElementPutRequest < Courier::Internal::Type::BaseModel
+      # @!attribute type
+      #   Element type (text, meta, action, image, etc.).
+      #
+      #   @return [String]
+      required :type, String
+
+      # @!attribute channels
+      #
+      #   @return [Array<String>, nil]
+      optional :channels, Courier::Internal::Type::ArrayOf[String]
+
+      # @!attribute data
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :data, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]
+
+      # @!attribute if_
+      #
+      #   @return [String, nil]
+      optional :if_, String, api_name: :if
+
+      # @!attribute loop_
+      #
+      #   @return [String, nil]
+      optional :loop_, String, api_name: :loop
+
+      # @!attribute ref
+      #
+      #   @return [String, nil]
+      optional :ref, String
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState, nil]
+      optional :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!method initialize(type:, channels: nil, data: nil, if_: nil, loop_: nil, ref: nil, state: nil)
+      #   Request body for updating a single element. Additional type-specific fields are
+      #   allowed.
+      #
+      #   @param type [String] Element type (text, meta, action, image, etc.).
+      #
+      #   @param channels [Array<String>]
+      #
+      #   @param data [Hash{Symbol=>Object}]
+      #
+      #   @param if_ [String]
+      #
+      #   @param loop_ [String]
+      #
+      #   @param ref [String]
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+    end
+  end
+end

data/lib/courier/models/notification_get_content.rb

@@ -2,7 +2,6 @@
 
 module Courier
   module Models
-    # @see Courier::Resources::Notifications#retrieve_content
     class NotificationGetContent < Courier::Internal::Type::BaseModel
       # @!attribute blocks
       #

data/lib/courier/models/notification_locale_put_request.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationLocalePutRequest < Courier::Internal::Type::BaseModel
+      # @!attribute elements
+      #   Elements with locale-specific content overrides.
+      #
+      #   @return [Array<Courier::Models::NotificationLocalePutRequest::Element>]
+      required :elements,
+               -> { Courier::Internal::Type::ArrayOf[Courier::NotificationLocalePutRequest::Element] }
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState, nil]
+      optional :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!method initialize(elements:, state: nil)
+      #   Request body for setting locale-specific content overrides. Each element
+      #   override must include the target element ID.
+      #
+      #   @param elements [Array<Courier::Models::NotificationLocalePutRequest::Element>] Elements with locale-specific content overrides.
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+
+      class Element < Courier::Internal::Type::BaseModel
+        # @!attribute id
+        #   Target element ID.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:)
+        #   @param id [String] Target element ID.
+      end
+    end
+  end
+end

data/lib/courier/models/notification_put_content_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#put_content
+    class NotificationPutContentParams < Courier::Models::NotificationContentPutRequest
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/notification_put_element_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#put_element
+    class NotificationPutElementParams < Courier::Models::NotificationElementPutRequest
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute element_id
+      #
+      #   @return [String]
+      required :element_id, String
+
+      # @!method initialize(id:, element_id:, request_options: {})
+      #   @param id [String]
+      #   @param element_id [String]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/notification_put_locale_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#put_locale
+    class NotificationPutLocaleParams < Courier::Models::NotificationLocalePutRequest
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute locale_id
+      #
+      #   @return [String]
+      required :locale_id, String
+
+      # @!method initialize(id:, locale_id:, request_options: {})
+      #   @param id [String]
+      #   @param locale_id [String]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/notification_retrieve_content_params.rb

@@ -12,8 +12,21 @@ module Courier
       #   @return [String]
       required :id, String
 
-      # @!method initialize(id:, request_options: {})
+      # @!attribute version
+      #   Accepts `draft`, `published`, or a version string (e.g., `v001`). Defaults to
+      #   `published`.
+      #
+      #   @return [String, nil]
+      optional :version, String
+
+      # @!method initialize(id:, version: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::NotificationRetrieveContentParams} for more details.
+      #
       #   @param id [String]
+      #
+      #   @param version [String] Accepts `draft`, `published`, or a version string (e.g., `v001`). Defaults to `p
+      #
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/notification_retrieve_content_response.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # Elemental content response for V2 templates. Contains versioned elements with
+    # content checksums.
+    #
+    # @see Courier::Resources::Notifications#retrieve_content
+    module NotificationRetrieveContentResponse
+      extend Courier::Internal::Type::Union
+
+      # Elemental content response for V2 templates. Contains versioned elements with content checksums.
+      variant -> { Courier::NotificationContentGetResponse }
+
+      variant -> { Courier::NotificationGetContent }
+
+      # @!method self.variants
+      #   @return [Array(Courier::Models::NotificationContentGetResponse, Courier::Models::NotificationGetContent)]
+    end
+  end
+end

data/lib/courier/models/notification_template_get_response.rb

@@ -2,7 +2,7 @@
 
 module Courier
   module Models
-    # @see Courier::Resources::Notifications#retrieve
+    # @see Courier::Resources::Notifications#create
     class NotificationTemplateGetResponse < Courier::Internal::Type::BaseModel
       # @!attribute created
       #   Epoch milliseconds when the template was created.

data/lib/courier/models/notification_template_state.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # Template state. Defaults to `DRAFT`.
+    module NotificationTemplateState
+      extend Courier::Internal::Type::Enum
+
+      DRAFT = :DRAFT
+      PUBLISHED = :PUBLISHED
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/courier/models/provider_update_params.rb

@@ -13,7 +13,8 @@ module Courier
       required :id, String
 
       # @!attribute provider
-      #   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.
       #
       #   @return [String]
       required :provider, String
@@ -44,7 +45,7 @@ module Courier
       #
       #   @param id [String]
       #
-      #   @param provider [String] The provider key identifying the type.
+      #   @param provider [String] The provider key identifying the type. Required on every request because it sele
       #
       #   @param alias_ [String] Updated alias. Omit to clear.
       #

data/lib/courier/models/routing_strategy_get_response.rb

@@ -2,7 +2,7 @@
 
 module Courier
   module Models
-    # @see Courier::Resources::RoutingStrategies#retrieve
+    # @see Courier::Resources::RoutingStrategies#create
     class RoutingStrategyGetResponse < Courier::Internal::Type::BaseModel
       # @!attribute id
       #   The routing strategy ID (rs\_ prefix).

data/lib/courier/models/routing_strategy_list_notifications_params.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#list_notifications
+    class RoutingStrategyListNotificationsParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute cursor
+      #   Opaque pagination cursor from a previous response. Omit for the first page.
+      #
+      #   @return [String, nil]
+      optional :cursor, String, nil?: true
+
+      # @!attribute limit
+      #   Maximum number of results per page. Default 20, max 100.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(id:, cursor: nil, limit: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param cursor [String, nil] Opaque pagination cursor from a previous response. Omit for the first page.
+      #
+      #   @param limit [Integer] Maximum number of results per page. Default 20, max 100.
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end