trycourier 6.3.0 → 6.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93e2579390eb091bbda837c472c4554b06267a4e1dfb01b3b7cc63098f4a0d19
-  data.tar.gz: 2c0beb4dfe94f8d7cf39d222fd1ffb8cd9e3dc54e334e86546ac31d9919b286e
+  metadata.gz: 77a40579016778bf7fd2be413c80a59a514bda2c1a2a6de1f6c1649cd6f28ce4
+  data.tar.gz: 071bdbb767a79675af2f55eaaeec7ad23ef5bac415f5d9f9eac2311407ae2a2a
 SHA512:
-  metadata.gz: 7a321f3202f3ca7858c453483d0fa0e537433a7c73afadd8cccc30d213fb18f6bb02f54db13a373a608e6f29595d0bf34bf3623b4086525da19773745e1c9a21
-  data.tar.gz: 33ef6a817cc05de26e64963c146c7ede6f8842ed1175949ba81ada5937261b0986ba9006522fd74e4dbf4cf5c0d5863021ab0e9e53ad5c3a839b35f7dc1f746f
+  metadata.gz: 0c5d00663ef98a7494db3b618a08b2f9a103355077cfa7e77def4b9f63686c46bbdbb487d7e9184507bb7b5a95bfb739c38864884736aeca01a56a3fd18069db
+  data.tar.gz: 2c2acf11904f5f0234aefbb0f5867ebef9e39787fe16aa5238495e1e221adf39087e62a1d6cd5db185c5810d701feeb7c64434e735830af86657915b02b2a448

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [6.4.0](https://github.com/trycourier/courier-ruby/compare/v6.3.0...v6.4.0) (2026-08-28)
+
+
+### Features
+
+* **api:** document channel on journey send nodes [C-20309] ([#138](https://github.com/trycourier/courier-ruby/issues/138)) ([f758237](https://github.com/trycourier/courier-ruby/commit/f75823779abef7a0df0d9927d3aae98696eff79a))
+
 ## [6.3.0](https://github.com/trycourier/courier-ruby/compare/v6.2.0...v6.3.0) (2026-08-27)
 
 

data/README.md

@@ -9,7 +9,7 @@ Add the gem to your `Gemfile`:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "trycourier", "~> 6.3.0"
+gem "trycourier", "~> 6.4.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/courier/models/journey_send_node.rb

@@ -18,6 +18,15 @@ module Courier
       #   @return [String, nil]
       optional :id, String
 
+      # @!attribute channel
+      #   The channel this node sends through. Optional — when omitted, the field is
+      #   absent from the node, including on `GET`; nodes created before this field
+      #   existed have it unset. Setting it makes the node's channel explicit to any
+      #   client reading the journey.
+      #
+      #   @return [Symbol, Courier::Models::JourneySendNode::Channel, nil]
+      optional :channel, enum: -> { Courier::JourneySendNode::Channel }
+
       # @!attribute conditions
       #   Condition spec for a journey node. Accepts a single condition atom, an AND/OR
       #   group, or an AND/OR nested group. Omit the `conditions` property entirely to
@@ -34,7 +43,7 @@ module Courier
       #   @return [Courier::Models::JourneyExperiment, nil]
       optional :experiment, -> { Courier::JourneyExperiment }
 
-      # @!method initialize(message:, type:, id: nil, conditions: nil, experiment: nil)
+      # @!method initialize(message:, type:, id: nil, channel: nil, conditions: nil, experiment: nil)
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::JourneySendNode} for more details.
       #
@@ -50,6 +59,8 @@ module Courier
       #
       #   @param id [String]
       #
+      #   @param channel [Symbol, Courier::Models::JourneySendNode::Channel] The channel this node sends through. Optional — when omitted, the field is absen
+      #
       #   @param conditions [Array<String>, Courier::Models::JourneyConditionGroup, Courier::Models::JourneyConditionNestedGroup] Condition spec for a journey node. Accepts a single condition atom, an AND/OR gr
       #
       #   @param experiment [Courier::Models::JourneyExperiment] A/B experiment config for a send node. The recipient is deterministically bucket
@@ -211,6 +222,26 @@ module Courier
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # The channel this node sends through. Optional — when omitted, the field is
+      # absent from the node, including on `GET`; nodes created before this field
+      # existed have it unset. Setting it makes the node's channel explicit to any
+      # client reading the journey.
+      #
+      # @see Courier::Models::JourneySendNode#channel
+      module Channel
+        extend Courier::Internal::Type::Enum
+
+        EMAIL = :email
+        SMS = :sms
+        PUSH = :push
+        INBOX = :inbox
+        SLACK = :slack
+        MSTEAMS = :msteams
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/courier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "6.3.0"
+  VERSION = "6.4.0"
 end

data/rbi/courier/models/journey_send_node.rbi

@@ -23,6 +23,16 @@ module Courier
       sig { params(id: String).void }
       attr_writer :id
 
+      # The channel this node sends through. Optional — when omitted, the field is
+      # absent from the node, including on `GET`; nodes created before this field
+      # existed have it unset. Setting it makes the node's channel explicit to any
+      # client reading the journey.
+      sig { returns(T.nilable(Courier::JourneySendNode::Channel::OrSymbol)) }
+      attr_reader :channel
+
+      sig { params(channel: Courier::JourneySendNode::Channel::OrSymbol).void }
+      attr_writer :channel
+
       # Condition spec for a journey node. Accepts a single condition atom, an AND/OR
       # group, or an AND/OR nested group. Omit the `conditions` property entirely to
       # express "no conditions".
@@ -70,6 +80,7 @@ module Courier
           message: Courier::JourneySendNode::Message::OrHash,
           type: Courier::JourneySendNode::Type::OrSymbol,
           id: String,
+          channel: Courier::JourneySendNode::Channel::OrSymbol,
           conditions:
             T.any(
               T::Array[String],
@@ -83,6 +94,11 @@ module Courier
         message:,
         type:,
         id: nil,
+        # The channel this node sends through. Optional — when omitted, the field is
+        # absent from the node, including on `GET`; nodes created before this field
+        # existed have it unset. Setting it makes the node's channel explicit to any
+        # client reading the journey.
+        channel: nil,
         # Condition spec for a journey node. Accepts a single condition atom, an AND/OR
         # group, or an AND/OR nested group. Omit the `conditions` property entirely to
         # express "no conditions".
@@ -100,6 +116,7 @@ module Courier
             message: Courier::JourneySendNode::Message,
             type: Courier::JourneySendNode::Type::OrSymbol,
             id: String,
+            channel: Courier::JourneySendNode::Channel::OrSymbol,
             conditions:
               T.any(
                 T::Array[String],
@@ -417,6 +434,34 @@ module Courier
         def self.values
         end
       end
+
+      # The channel this node sends through. Optional — when omitted, the field is
+      # absent from the node, including on `GET`; nodes created before this field
+      # existed have it unset. Setting it makes the node's channel explicit to any
+      # client reading the journey.
+      module Channel
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Courier::JourneySendNode::Channel) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        EMAIL = T.let(:email, Courier::JourneySendNode::Channel::TaggedSymbol)
+        SMS = T.let(:sms, Courier::JourneySendNode::Channel::TaggedSymbol)
+        PUSH = T.let(:push, Courier::JourneySendNode::Channel::TaggedSymbol)
+        INBOX = T.let(:inbox, Courier::JourneySendNode::Channel::TaggedSymbol)
+        SLACK = T.let(:slack, Courier::JourneySendNode::Channel::TaggedSymbol)
+        MSTEAMS =
+          T.let(:msteams, Courier::JourneySendNode::Channel::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Courier::JourneySendNode::Channel::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/sig/courier/models/journey_send_node.rbs

@@ -5,6 +5,7 @@ module Courier
         message: Courier::JourneySendNode::Message,
         type: Courier::Models::JourneySendNode::type_,
         id: String,
+        channel: Courier::Models::JourneySendNode::channel,
         conditions: Courier::Models::journey_conditions_field,
         experiment: Courier::JourneyExperiment
       }
@@ -18,6 +19,12 @@ module Courier
 
       def id=: (String) -> String
 
+      attr_reader channel: Courier::Models::JourneySendNode::channel?
+
+      def channel=: (
+        Courier::Models::JourneySendNode::channel
+      ) -> Courier::Models::JourneySendNode::channel
+
       attr_reader conditions: Courier::Models::journey_conditions_field?
 
       def conditions=: (
@@ -34,6 +41,7 @@ module Courier
         message: Courier::JourneySendNode::Message,
         type: Courier::Models::JourneySendNode::type_,
         ?id: String,
+        ?channel: Courier::Models::JourneySendNode::channel,
         ?conditions: Courier::Models::journey_conditions_field,
         ?experiment: Courier::JourneyExperiment
       ) -> void
@@ -42,6 +50,7 @@ module Courier
         message: Courier::JourneySendNode::Message,
         type: Courier::Models::JourneySendNode::type_,
         id: String,
+        channel: Courier::Models::JourneySendNode::channel,
         conditions: Courier::Models::journey_conditions_field,
         experiment: Courier::JourneyExperiment
       }
@@ -183,6 +192,21 @@ module Courier
 
         def self?.values: -> ::Array[Courier::Models::JourneySendNode::type_]
       end
+
+      type channel = :email | :sms | :push | :inbox | :slack | :msteams
+
+      module Channel
+        extend Courier::Internal::Type::Enum
+
+        EMAIL: :email
+        SMS: :sms
+        PUSH: :push
+        INBOX: :inbox
+        SLACK: :slack
+        MSTEAMS: :msteams
+
+        def self?.values: -> ::Array[Courier::Models::JourneySendNode::channel]
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 6.3.0
+  version: 6.4.0
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-27 00:00:00.000000000 Z
+date: 2026-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi