trycourier 4.18.0 → 4.18.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8dd821714bcedfb9a48185d8a9c04f669568f2fdd560bcbd58a7c21acf43be3
-  data.tar.gz: c8730971ee6d6fbb0e38a4f3a6a213c0a9fed7aca628d5ebc3e490c8c585d362
+  metadata.gz: ce3813405deb188367bed5849b23a16ea329a497b654278d0a18b2f992b15bec
+  data.tar.gz: dd921945bf22141d5505b42420046cd6447a77b033f9866714c8f6fa7692e240
 SHA512:
-  metadata.gz: 1c3bdee713e6ac20200c2c35ac993a34a07b52b3e4c1bc9422e0074aeffe344b39962d7703463de38d80f00ba1ecc56e5ea839654ac0a45c6c51400fc996849b
-  data.tar.gz: 07535c3b636a1462811bd7f00685dbc3738c3ce589cc0f963baf898a2895f543c48a8e12e39135c6bebccdbabc3fb85388dea03af2aff3d0bcf6758c4ef2309e
+  metadata.gz: 9174a2e66c46289020fe6d1837690667a7fc1918b7035a18f964be0b46b55eb41cee98a5f8befd8c5acae02b07030e47d0c49e6fd50114be096565850981c849
+  data.tar.gz: 48a7ccea6a0357ae2c452a7f9e727daf41b4675a884eb7c03dc1cf20b18a052bae53b022357f69a1e3841ab4ad38662ccca5b026beea8e5261dd44238f69291e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.18.1 (2026-07-07)
+
+Full Changelog: [v4.18.0...v4.18.1](https://github.com/trycourier/courier-ruby/compare/v4.18.0...v4.18.1)
+
+### Documentation
+
+* **openapi:** document audiences filter combinator (SUP-686) ([fdf42fe](https://github.com/trycourier/courier-ruby/commit/fdf42fecbd77058dbba53a198942efa509bbc1a1))
+
 ## 4.18.0 (2026-07-06)
 
 Full Changelog: [v4.17.1...v4.18.0](https://github.com/trycourier/courier-ruby/compare/v4.17.1...v4.18.0)

data/lib/courier/models/audience.rb

@@ -39,7 +39,8 @@ module Courier
       optional :filter, -> { Courier::AudienceFilterConfig }, nil?: true
 
       # @!attribute operator
-      #   The logical operator (AND/OR) for the top-level filter
+      #   The logical operator (AND/OR) combining the top-level `filter.filters`.
+      #   Convenience alias for `filter.operator`.
       #
       #   @return [Symbol, Courier::Models::Audience::Operator, nil]
       optional :operator, enum: -> { Courier::Audience::Operator }
@@ -60,9 +61,10 @@ module Courier
       #
       #   @param filter [Courier::Models::AudienceFilterConfig, nil] Filter configuration for audience membership containing an array of filter rules
       #
-      #   @param operator [Symbol, Courier::Models::Audience::Operator] The logical operator (AND/OR) for the top-level filter
+      #   @param operator [Symbol, Courier::Models::Audience::Operator] The logical operator (AND/OR) combining the top-level `filter.filters`. Convenie
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`.
       #
       # @see Courier::Models::Audience#operator
       module Operator

data/lib/courier/models/audience_filter_config.rb

@@ -9,10 +9,38 @@ module Courier
       #   @return [Array<Courier::Models::FilterConfig>]
       required :filters, -> { Courier::Internal::Type::ArrayOf[Courier::FilterConfig] }
 
-      # @!method initialize(filters:)
+      # @!attribute operator
+      #   The logical operator (AND/OR) combining the rules in `filters`. Required when
+      #   `filters` contains more than one rule. If omitted, the top-level `operator`
+      #   field on the request is used instead.
+      #
+      #   @return [Symbol, Courier::Models::AudienceFilterConfig::Operator, nil]
+      optional :operator, enum: -> { Courier::AudienceFilterConfig::Operator }
+
+      # @!method initialize(filters:, operator: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::AudienceFilterConfig} for more details.
+      #
       #   Filter configuration for audience membership containing an array of filter rules
       #
       #   @param filters [Array<Courier::Models::FilterConfig>] Array of filter rules (single conditions or nested groups)
+      #
+      #   @param operator [Symbol, Courier::Models::AudienceFilterConfig::Operator] The logical operator (AND/OR) combining the rules in `filters`. Required when `f
+
+      # The logical operator (AND/OR) combining the rules in `filters`. Required when
+      # `filters` contains more than one rule. If omitted, the top-level `operator`
+      # field on the request is used instead.
+      #
+      # @see Courier::Models::AudienceFilterConfig#operator
+      module Operator
+        extend Courier::Internal::Type::Enum
+
+        AND = :AND
+        OR = :OR
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/courier/models/audience_update_params.rb

@@ -31,7 +31,9 @@ module Courier
       optional :name, String, nil?: true
 
       # @!attribute operator
-      #   The logical operator (AND/OR) for the top-level filter
+      #   The logical operator (AND/OR) combining the top-level `filter.filters`.
+      #   Convenience alias for `filter.operator`: if set, it is applied to the top-level
+      #   filter group. Prefer setting `operator` directly inside `filter`.
       #
       #   @return [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil]
       optional :operator, enum: -> { Courier::AudienceUpdateParams::Operator }, nil?: true
@@ -48,11 +50,13 @@ module Courier
       #
       #   @param name [String, nil] The name of the audience
       #
-      #   @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) for the top-level filter
+      #   @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) combining the top-level `filter.filters`. Convenie
       #
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`: if set, it is applied to the top-level
+      # filter group. Prefer setting `operator` directly inside `filter`.
       module Operator
         extend Courier::Internal::Type::Enum
 

data/lib/courier/resources/audiences.rb

@@ -38,7 +38,7 @@ module Courier
       #
       # @param name [String, nil] The name of the audience
       #
-      # @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) for the top-level filter
+      # @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) combining the top-level `filter.filters`. Convenie
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/courier/version.rb

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

data/rbi/courier/models/audience.rbi

@@ -33,7 +33,8 @@ module Courier
       end
       attr_writer :filter
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`.
       sig { returns(T.nilable(Courier::Audience::Operator::TaggedSymbol)) }
       attr_reader :operator
 
@@ -62,7 +63,8 @@ module Courier
         updated_at:,
         # Filter configuration for audience membership containing an array of filter rules
         filter: nil,
-        # The logical operator (AND/OR) for the top-level filter
+        # The logical operator (AND/OR) combining the top-level `filter.filters`.
+        # Convenience alias for `filter.operator`.
         operator: nil
       )
       end
@@ -83,7 +85,8 @@ module Courier
       def to_hash
       end
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`.
       module Operator
         extend Courier::Internal::Type::Enum
 

data/rbi/courier/models/audience_filter_config.rbi

@@ -12,21 +12,70 @@ module Courier
       sig { returns(T::Array[Courier::FilterConfig]) }
       attr_accessor :filters
 
+      # The logical operator (AND/OR) combining the rules in `filters`. Required when
+      # `filters` contains more than one rule. If omitted, the top-level `operator`
+      # field on the request is used instead.
+      sig do
+        returns(T.nilable(Courier::AudienceFilterConfig::Operator::OrSymbol))
+      end
+      attr_reader :operator
+
+      sig do
+        params(operator: Courier::AudienceFilterConfig::Operator::OrSymbol).void
+      end
+      attr_writer :operator
+
       # Filter configuration for audience membership containing an array of filter rules
       sig do
-        params(filters: T::Array[Courier::FilterConfig::OrHash]).returns(
-          T.attached_class
-        )
+        params(
+          filters: T::Array[Courier::FilterConfig::OrHash],
+          operator: Courier::AudienceFilterConfig::Operator::OrSymbol
+        ).returns(T.attached_class)
       end
       def self.new(
         # Array of filter rules (single conditions or nested groups)
-        filters:
+        filters:,
+        # The logical operator (AND/OR) combining the rules in `filters`. Required when
+        # `filters` contains more than one rule. If omitted, the top-level `operator`
+        # field on the request is used instead.
+        operator: nil
       )
       end
 
-      sig { override.returns({ filters: T::Array[Courier::FilterConfig] }) }
+      sig do
+        override.returns(
+          {
+            filters: T::Array[Courier::FilterConfig],
+            operator: Courier::AudienceFilterConfig::Operator::OrSymbol
+          }
+        )
+      end
       def to_hash
       end
+
+      # The logical operator (AND/OR) combining the rules in `filters`. Required when
+      # `filters` contains more than one rule. If omitted, the top-level `operator`
+      # field on the request is used instead.
+      module Operator
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::AudienceFilterConfig::Operator)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AND = T.let(:AND, Courier::AudienceFilterConfig::Operator::TaggedSymbol)
+        OR = T.let(:OR, Courier::AudienceFilterConfig::Operator::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Courier::AudienceFilterConfig::Operator::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/courier/models/audience_update_params.rbi

@@ -31,7 +31,9 @@ module Courier
       sig { returns(T.nilable(String)) }
       attr_accessor :name
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`: if set, it is applied to the top-level
+      # filter group. Prefer setting `operator` directly inside `filter`.
       sig do
         returns(T.nilable(Courier::AudienceUpdateParams::Operator::OrSymbol))
       end
@@ -56,7 +58,9 @@ module Courier
         filter: nil,
         # The name of the audience
         name: nil,
-        # The logical operator (AND/OR) for the top-level filter
+        # The logical operator (AND/OR) combining the top-level `filter.filters`.
+        # Convenience alias for `filter.operator`: if set, it is applied to the top-level
+        # filter group. Prefer setting `operator` directly inside `filter`.
         operator: nil,
         request_options: {}
       )
@@ -78,7 +82,9 @@ module Courier
       def to_hash
       end
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`: if set, it is applied to the top-level
+      # filter group. Prefer setting `operator` directly inside `filter`.
       module Operator
         extend Courier::Internal::Type::Enum
 

data/rbi/courier/resources/audiences.rbi

@@ -38,7 +38,9 @@ module Courier
         filter: nil,
         # The name of the audience
         name: nil,
-        # The logical operator (AND/OR) for the top-level filter
+        # The logical operator (AND/OR) combining the top-level `filter.filters`.
+        # Convenience alias for `filter.operator`: if set, it is applied to the top-level
+        # filter group. Prefer setting `operator` directly inside `filter`.
         operator: nil,
         request_options: {}
       )

data/sig/courier/models/audience_filter_config.rbs

@@ -1,13 +1,40 @@
 module Courier
   module Models
-    type audience_filter_config = { filters: ::Array[Courier::FilterConfig] }
+    type audience_filter_config =
+      {
+        filters: ::Array[Courier::FilterConfig],
+        operator: Courier::Models::AudienceFilterConfig::operator
+      }
 
     class AudienceFilterConfig < Courier::Internal::Type::BaseModel
       attr_accessor filters: ::Array[Courier::FilterConfig]
 
-      def initialize: (filters: ::Array[Courier::FilterConfig]) -> void
+      attr_reader operator: Courier::Models::AudienceFilterConfig::operator?
 
-      def to_hash: -> { filters: ::Array[Courier::FilterConfig] }
+      def operator=: (
+        Courier::Models::AudienceFilterConfig::operator
+      ) -> Courier::Models::AudienceFilterConfig::operator
+
+      def initialize: (
+        filters: ::Array[Courier::FilterConfig],
+        ?operator: Courier::Models::AudienceFilterConfig::operator
+      ) -> void
+
+      def to_hash: -> {
+        filters: ::Array[Courier::FilterConfig],
+        operator: Courier::Models::AudienceFilterConfig::operator
+      }
+
+      type operator = :AND | :OR
+
+      module Operator
+        extend Courier::Internal::Type::Enum
+
+        AND: :AND
+        OR: :OR
+
+        def self?.values: -> ::Array[Courier::Models::AudienceFilterConfig::operator]
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 4.18.0
+  version: 4.18.1
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-06 00:00:00.000000000 Z
+date: 2026-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi