knockapi 1.10.3 → 1.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 247db1a9c4387aa27502f288b58a3db837203123f8986c2a39cd11c53da8b62d
-  data.tar.gz: 797f6bc3a516d4ad8be7dfdfc040a5805e61b251b85ed0fb7426e77593ce3859
+  metadata.gz: d12a329bbc605a270487388dd768fdaf32d6ea55a9beaecb84be75032db59e4a
+  data.tar.gz: 7c2208d2f1b89d5416d5a4e02e6c5257dfcde6ed07228d59cffb5bb054d1b9b0
 SHA512:
-  metadata.gz: 514637c1db0be816f3e9913bc3a9cc138eebee03aedba7628ffdc290c5ab4b241a4cc1ebf0ac856c875a5382f313c0e3b2d1f6d5dd9352b957384d195d4749a4
-  data.tar.gz: 3e0acf187a631fa5a55f3e4401f54d204ac51f6d97a2f9ec7d6ed3d5e3082bf737f48724b5a3285437ecbf6cb829cf6f1a32cdbb746338976c9a6da8730b766b
+  metadata.gz: 1a72efe89eace5b0d29ce990709293ce186536c8c530f6ec8545a51c4f2f449d6b17d32b2711b619f752191efd8246d1f1f006a3ae7e539948581928e8e68924
+  data.tar.gz: 0e538e699dd375eff82b2ee5e8addf6e05496fca38f54266f28ef6fed6054a656f8ca2fe0ff763f0031d6c56dc69d5e6a12226eef1a8902dea0c8b7f20cf538c

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.11.1 (2025-08-19)
+
+Full Changelog: [v1.11.0...v1.11.1](https://github.com/knocklabs/knock-ruby/compare/v1.11.0...v1.11.1)
+
+### Bug Fixes
+
+* bump sorbet version and fix new type errors from the breaking change ([0194974](https://github.com/knocklabs/knock-ruby/commit/0194974b049c8c69ce3749f1bc8086b724a39272))
+
+## 1.11.0 (2025-08-15)
+
+Full Changelog: [v1.10.3...v1.11.0](https://github.com/knocklabs/knock-ruby/compare/v1.10.3...v1.11.0)
+
+### Features
+
+* **api:** api update ([d0ce3fe](https://github.com/knocklabs/knock-ruby/commit/d0ce3fe4004f9f5b663d88f6eea02c1def7a26fa))
+
 ## 1.10.3 (2025-08-12)
 
 Full Changelog: [v1.10.2...v1.10.3](https://github.com/knocklabs/knock-ruby/compare/v1.10.2...v1.10.3)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "knockapi", "~> 1.10.3"
+gem "knockapi", "~> 1.11.1"
 ```
 
 <!-- x-release-please-end -->
@@ -225,25 +225,25 @@ knock.workflows.trigger("dinosaurs-loose", **params)
 Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-# :exclude
-puts(Knockapi::Users::FeedListItemsParams::Archived::EXCLUDE)
+# :merge
+puts(Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::MERGE)
 
-# Revealed type: `T.all(Knockapi::Users::FeedListItemsParams::Archived, Symbol)`
-T.reveal_type(Knockapi::Users::FeedListItemsParams::Archived::EXCLUDE)
+# Revealed type: `T.all(Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy, Symbol)`
+T.reveal_type(Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::MERGE)
 ```
 
 Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
 
 ```ruby
 # Using the enum constants preserves the tagged type information:
-knock.users.feeds.list_items(
-  archived: Knockapi::Users::FeedListItemsParams::Archived::EXCLUDE,
+knock.users.set_preferences(
+  _persistence_strategy: Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::MERGE,
   # …
 )
 
 # Literal values are also permissible:
-knock.users.feeds.list_items(
-  archived: :exclude,
+knock.users.set_preferences(
+  _persistence_strategy: :merge,
   # …
 )
 ```

data/lib/knockapi/internal/transport/pooled_net_requester.rb

@@ -193,15 +193,7 @@ module Knockapi
         end
 
         define_sorbet_constant!(:Request) do
-          T.type_alias do
-            {
-              method: Symbol,
-              url: URI::Generic,
-              headers: T::Hash[String, String],
-              body: T.anything,
-              deadline: Float
-            }
-          end
+          T.type_alias { {method: Symbol, url: URI::Generic, headers: T::Hash[String, String], body: T.anything, deadline: Float} }
         end
       end
     end

data/lib/knockapi/internal/type/base_model.rb

@@ -64,14 +64,7 @@ module Knockapi
             setter = :"#{name_sym}="
             api_name = info.fetch(:api_name, name_sym)
             nilable = info.fetch(:nil?, false)
-            const = if required && !nilable
-              info.fetch(
-                :const,
-                Knockapi::Internal::OMIT
-              )
-            else
-              Knockapi::Internal::OMIT
-            end
+            const = required && !nilable ? info.fetch(:const, Knockapi::Internal::OMIT) : Knockapi::Internal::OMIT
 
             [name_sym, setter].each { undef_method(_1) } if known_fields.key?(name_sym)
 

data/lib/knockapi/internal/util.rb

@@ -244,7 +244,7 @@ module Knockapi
         #
         # @return [String]
         def uri_origin(uri)
-          "#{uri.scheme}://#{uri.host}#{uri.port == uri.default_port ? '' : ":#{uri.port}"}"
+          "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
         # @api private

data/lib/knockapi/models/audience_remove_members_params.rb

@@ -11,10 +11,7 @@ module Knockapi
       #   A list of audience members to remove.
       #
       #   @return [Array<Knockapi::Models::AudienceRemoveMembersParams::Member>]
-      required :members,
-               -> {
-                 Knockapi::Internal::Type::ArrayOf[Knockapi::AudienceRemoveMembersParams::Member]
-               }
+      required :members, -> { Knockapi::Internal::Type::ArrayOf[Knockapi::AudienceRemoveMembersParams::Member] }
 
       # @!method initialize(members:, request_options: {})
       #   @param members [Array<Knockapi::Models::AudienceRemoveMembersParams::Member>] A list of audience members to remove.

data/lib/knockapi/models/channels/bulk_update_message_status_params.rb

@@ -18,10 +18,7 @@ module Knockapi
         #   Limits the results to messages with the given delivery status.
         #
         #   @return [Symbol, Knockapi::Models::Channels::BulkUpdateMessageStatusParams::DeliveryStatus, nil]
-        optional :delivery_status,
-                 enum: -> {
-                   Knockapi::Channels::BulkUpdateMessageStatusParams::DeliveryStatus
-                 }
+        optional :delivery_status, enum: -> { Knockapi::Channels::BulkUpdateMessageStatusParams::DeliveryStatus }
 
         # @!attribute engagement_status
         #   Limits the results to messages with the given engagement status.

data/lib/knockapi/models/object_list_messages_params.rb

@@ -30,9 +30,7 @@ module Knockapi
       #
       #   @return [Array<Symbol, Knockapi::Models::ObjectListMessagesParams::EngagementStatus>, nil]
       optional :engagement_status,
-               -> {
-                 Knockapi::Internal::Type::ArrayOf[enum: Knockapi::ObjectListMessagesParams::EngagementStatus]
-               }
+               -> { Knockapi::Internal::Type::ArrayOf[enum: Knockapi::ObjectListMessagesParams::EngagementStatus] }
 
       # @!attribute inserted_at
       #

data/lib/knockapi/models/object_list_subscriptions_params.rb

@@ -24,9 +24,7 @@ module Knockapi
       #
       #   @return [Array<Symbol, Knockapi::Models::ObjectListSubscriptionsParams::Include>, nil]
       optional :include,
-               -> {
-                 Knockapi::Internal::Type::ArrayOf[enum: Knockapi::ObjectListSubscriptionsParams::Include]
-               }
+               -> { Knockapi::Internal::Type::ArrayOf[enum: Knockapi::ObjectListSubscriptionsParams::Include] }
 
       # @!attribute mode
       #   Mode of the request. `recipient` to list the objects that the provided object is

data/lib/knockapi/models/object_set_params.rb

@@ -12,9 +12,7 @@ module Knockapi
       #
       #   @return [Hash{Symbol=>Knockapi::Models::Recipients::PushChannelData, Knockapi::Models::Recipients::OneSignalChannelData, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil]
       optional :channel_data,
-               -> {
-                 Knockapi::Internal::Type::HashOf[union: Knockapi::Recipients::InlineChannelDataRequestItem]
-               }
+               -> { Knockapi::Internal::Type::HashOf[union: Knockapi::Recipients::InlineChannelDataRequestItem] }
 
       # @!attribute locale
       #   The locale of the object. Used for
@@ -29,10 +27,7 @@ module Knockapi
       #   rather than replacing them.
       #
       #   @return [Hash{Symbol=>Knockapi::Models::Recipients::PreferenceSetRequest}, nil]
-      optional :preferences,
-               -> {
-                 Knockapi::Internal::Type::HashOf[Knockapi::Recipients::PreferenceSetRequest]
-               }
+      optional :preferences, -> { Knockapi::Internal::Type::HashOf[Knockapi::Recipients::PreferenceSetRequest] }
 
       # @!attribute timezone
       #   The timezone of the object. Must be a

data/lib/knockapi/models/objects/bulk_add_subscriptions_params.rb

@@ -13,9 +13,7 @@ module Knockapi
         #
         #   @return [Array<Knockapi::Models::Objects::BulkAddSubscriptionsParams::Subscription>]
         required :subscriptions,
-                 -> {
-                   Knockapi::Internal::Type::ArrayOf[Knockapi::Objects::BulkAddSubscriptionsParams::Subscription]
-                 }
+                 -> { Knockapi::Internal::Type::ArrayOf[Knockapi::Objects::BulkAddSubscriptionsParams::Subscription] }
 
         # @!method initialize(subscriptions:, request_options: {})
         #   @param subscriptions [Array<Knockapi::Models::Objects::BulkAddSubscriptionsParams::Subscription>] A list of subscriptions.

data/lib/knockapi/models/recipients/discord_channel_data.rb

@@ -9,9 +9,7 @@ module Knockapi
         #
         #   @return [Array<Knockapi::Models::Recipients::DiscordChannelData::Connection::DiscordChannelConnection, Knockapi::Models::Recipients::DiscordChannelData::Connection::DiscordIncomingWebhookConnection>]
         required :connections,
-                 -> {
-                   Knockapi::Internal::Type::ArrayOf[union: Knockapi::Recipients::DiscordChannelData::Connection]
-                 }
+                 -> { Knockapi::Internal::Type::ArrayOf[union: Knockapi::Recipients::DiscordChannelData::Connection] }
 
         # @!method initialize(connections:)
         #   Discord channel data.
@@ -27,9 +25,7 @@ module Knockapi
           variant -> { Knockapi::Recipients::DiscordChannelData::Connection::DiscordChannelConnection }
 
           # Discord incoming webhook connection.
-          variant -> {
-            Knockapi::Recipients::DiscordChannelData::Connection::DiscordIncomingWebhookConnection
-          }
+          variant -> { Knockapi::Recipients::DiscordChannelData::Connection::DiscordIncomingWebhookConnection }
 
           class DiscordChannelConnection < Knockapi::Internal::Type::BaseModel
             # @!attribute channel_id
@@ -50,9 +46,7 @@ module Knockapi
             #
             #   @return [Knockapi::Models::Recipients::DiscordChannelData::Connection::DiscordIncomingWebhookConnection::IncomingWebhook]
             required :incoming_webhook,
-                     -> {
-                       Knockapi::Recipients::DiscordChannelData::Connection::DiscordIncomingWebhookConnection::IncomingWebhook
-                     }
+                     -> { Knockapi::Recipients::DiscordChannelData::Connection::DiscordIncomingWebhookConnection::IncomingWebhook }
 
             # @!method initialize(incoming_webhook:)
             #   Discord incoming webhook connection.

data/lib/knockapi/models/recipients/ms_teams_channel_data.rb

@@ -9,9 +9,7 @@ module Knockapi
         #
         #   @return [Array<Knockapi::Models::Recipients::MsTeamsChannelData::Connection::MsTeamsTokenConnection, Knockapi::Models::Recipients::MsTeamsChannelData::Connection::MsTeamsIncomingWebhookConnection>]
         required :connections,
-                 -> {
-                   Knockapi::Internal::Type::ArrayOf[union: Knockapi::Recipients::MsTeamsChannelData::Connection]
-                 }
+                 -> { Knockapi::Internal::Type::ArrayOf[union: Knockapi::Recipients::MsTeamsChannelData::Connection] }
 
         # @!attribute ms_teams_tenant_id
         #   Microsoft Teams tenant ID.
@@ -34,9 +32,7 @@ module Knockapi
           variant -> { Knockapi::Recipients::MsTeamsChannelData::Connection::MsTeamsTokenConnection }
 
           # Microsoft Teams incoming webhook connection.
-          variant -> {
-            Knockapi::Recipients::MsTeamsChannelData::Connection::MsTeamsIncomingWebhookConnection
-          }
+          variant -> { Knockapi::Recipients::MsTeamsChannelData::Connection::MsTeamsIncomingWebhookConnection }
 
           class MsTeamsTokenConnection < Knockapi::Internal::Type::BaseModel
             # @!attribute ms_teams_channel_id
@@ -81,9 +77,7 @@ module Knockapi
             #
             #   @return [Knockapi::Models::Recipients::MsTeamsChannelData::Connection::MsTeamsIncomingWebhookConnection::IncomingWebhook]
             required :incoming_webhook,
-                     -> {
-                       Knockapi::Recipients::MsTeamsChannelData::Connection::MsTeamsIncomingWebhookConnection::IncomingWebhook
-                     }
+                     -> { Knockapi::Recipients::MsTeamsChannelData::Connection::MsTeamsIncomingWebhookConnection::IncomingWebhook }
 
             # @!method initialize(incoming_webhook:)
             #   Microsoft Teams incoming webhook connection.

data/lib/knockapi/models/recipients/preference_set.rb

@@ -60,9 +60,7 @@ module Knockapi
           variant Knockapi::Internal::Type::Boolean
 
           # The settings object for a workflow or category, where you can specify channel types or conditions.
-          variant -> {
-            Knockapi::Recipients::PreferenceSet::Category::PreferenceSetWorkflowCategorySettingObject
-          }
+          variant -> { Knockapi::Recipients::PreferenceSet::Category::PreferenceSetWorkflowCategorySettingObject }
 
           class PreferenceSetWorkflowCategorySettingObject < Knockapi::Internal::Type::BaseModel
             # @!attribute channel_types
@@ -97,9 +95,7 @@ module Knockapi
           variant Knockapi::Internal::Type::Boolean
 
           # The settings object for a workflow or category, where you can specify channel types or conditions.
-          variant -> {
-            Knockapi::Recipients::PreferenceSet::Workflow::PreferenceSetWorkflowCategorySettingObject
-          }
+          variant -> { Knockapi::Recipients::PreferenceSet::Workflow::PreferenceSetWorkflowCategorySettingObject }
 
           class PreferenceSetWorkflowCategorySettingObject < Knockapi::Internal::Type::BaseModel
             # @!attribute channel_types

data/lib/knockapi/models/recipients/preference_set_request.rb

@@ -4,6 +4,15 @@ module Knockapi
   module Models
     module Recipients
       class PreferenceSetRequest < Knockapi::Internal::Type::BaseModel
+        # @!attribute _persistence_strategy
+        #   Controls how the preference set is persisted. 'replace' will completely replace
+        #   the preference set, 'merge' will merge with existing preferences.
+        #
+        #   @return [Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::PersistenceStrategy, nil]
+        optional :_persistence_strategy,
+                 enum: -> { Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy },
+                 api_name: :__persistence_strategy__
+
         # @!attribute categories
         #   An object where the key is the category and the values are the preference
         #   settings for that category.
@@ -32,18 +41,34 @@ module Knockapi
                  },
                  nil?: true
 
-        # @!method initialize(categories: nil, channel_types: nil, workflows: nil)
+        # @!method initialize(_persistence_strategy: nil, categories: nil, channel_types: nil, workflows: nil)
         #   Some parameter documentations has been truncated, see
         #   {Knockapi::Models::Recipients::PreferenceSetRequest} for more details.
         #
         #   A request to set a preference set for a recipient.
         #
+        #   @param _persistence_strategy [Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::PersistenceStrategy] Controls how the preference set is persisted. 'replace' will completely replace
+        #
         #   @param categories [Hash{Symbol=>Boolean, Knockapi::Models::Recipients::PreferenceSetRequest::Category::PreferenceSetWorkflowCategorySettingObject}, nil] An object where the key is the category and the values are the preference settin
         #
         #   @param channel_types [Knockapi::Models::Recipients::PreferenceSetChannelTypes, nil] Channel type preferences.
         #
         #   @param workflows [Hash{Symbol=>Boolean, Knockapi::Models::Recipients::PreferenceSetRequest::Workflow::PreferenceSetWorkflowCategorySettingObject}, nil] An object where the key is the workflow key and the values are the preference se
 
+        # Controls how the preference set is persisted. 'replace' will completely replace
+        # the preference set, 'merge' will merge with existing preferences.
+        #
+        # @see Knockapi::Models::Recipients::PreferenceSetRequest#_persistence_strategy
+        module PersistenceStrategy
+          extend Knockapi::Internal::Type::Enum
+
+          MERGE = :merge
+          REPLACE = :replace
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # Workflow or category preferences within a preference set
         module Category
           extend Knockapi::Internal::Type::Union
@@ -51,9 +76,7 @@ module Knockapi
           variant Knockapi::Internal::Type::Boolean
 
           # The settings object for a workflow or category, where you can specify channel types or conditions.
-          variant -> {
-            Knockapi::Recipients::PreferenceSetRequest::Category::PreferenceSetWorkflowCategorySettingObject
-          }
+          variant -> { Knockapi::Recipients::PreferenceSetRequest::Category::PreferenceSetWorkflowCategorySettingObject }
 
           class PreferenceSetWorkflowCategorySettingObject < Knockapi::Internal::Type::BaseModel
             # @!attribute channel_types
@@ -88,9 +111,7 @@ module Knockapi
           variant Knockapi::Internal::Type::Boolean
 
           # The settings object for a workflow or category, where you can specify channel types or conditions.
-          variant -> {
-            Knockapi::Recipients::PreferenceSetRequest::Workflow::PreferenceSetWorkflowCategorySettingObject
-          }
+          variant -> { Knockapi::Recipients::PreferenceSetRequest::Workflow::PreferenceSetWorkflowCategorySettingObject }
 
           class PreferenceSetWorkflowCategorySettingObject < Knockapi::Internal::Type::BaseModel
             # @!attribute channel_types

data/lib/knockapi/models/recipients/slack_channel_data.rb

@@ -9,9 +9,7 @@ module Knockapi
         #
         #   @return [Array<Knockapi::Models::Recipients::SlackChannelData::Connection::SlackTokenConnection, Knockapi::Models::Recipients::SlackChannelData::Connection::SlackIncomingWebhookConnection>]
         required :connections,
-                 -> {
-                   Knockapi::Internal::Type::ArrayOf[union: Knockapi::Recipients::SlackChannelData::Connection]
-                 }
+                 -> { Knockapi::Internal::Type::ArrayOf[union: Knockapi::Recipients::SlackChannelData::Connection] }
 
         # @!attribute token
         #   A Slack connection token.

data/lib/knockapi/models/user_list_messages_params.rb

@@ -30,9 +30,7 @@ module Knockapi
       #
       #   @return [Array<Symbol, Knockapi::Models::UserListMessagesParams::EngagementStatus>, nil]
       optional :engagement_status,
-               -> {
-                 Knockapi::Internal::Type::ArrayOf[enum: Knockapi::UserListMessagesParams::EngagementStatus]
-               }
+               -> { Knockapi::Internal::Type::ArrayOf[enum: Knockapi::UserListMessagesParams::EngagementStatus] }
 
       # @!attribute inserted_at
       #
@@ -62,10 +60,7 @@ module Knockapi
       #   Limits the results to messages with the given delivery status.
       #
       #   @return [Array<Symbol, Knockapi::Models::UserListMessagesParams::Status>, nil]
-      optional :status,
-               -> {
-                 Knockapi::Internal::Type::ArrayOf[enum: Knockapi::UserListMessagesParams::Status]
-               }
+      optional :status, -> { Knockapi::Internal::Type::ArrayOf[enum: Knockapi::UserListMessagesParams::Status] }
 
       # @!attribute tenant
       #   Limits the results to items with the corresponding tenant.

data/lib/knockapi/resources/objects.rb

@@ -425,14 +425,16 @@ module Knockapi
       # Some parameter documentations has been truncated, see
       # {Knockapi::Models::ObjectSetPreferencesParams} for more details.
       #
-      # Sets preferences within the given preference set. This is a destructive
-      # operation and will replace any existing preferences with the preferences given.
-      # If no object exists in the current environment for the given `:collection` and
-      # `:object_id`, Knock will create the object as part of this request. The
-      # preference set `:id` can be either `default` or a `tenant.id`. Learn more about
+      # Sets preferences within the given preference set. By default, this is a
+      # destructive operation and will replace any existing preferences with the
+      # preferences given. Use '\_\_persistence_strategy': 'merge' to merge with
+      # existing preferences instead. If no object exists in the current environment for
+      # the given `:collection` and `:object_id`, Knock will create the object as part
+      # of this request. The preference set `:id` can be either `default` or a
+      # `tenant.id`. Learn more about
       # [per-tenant preferences](/preferences/tenant-preferences).
       #
-      # @overload set_preferences(collection, object_id_, id, categories: nil, channel_types: nil, workflows: nil, request_options: {})
+      # @overload set_preferences(collection, object_id_, id, _persistence_strategy: nil, categories: nil, channel_types: nil, workflows: nil, request_options: {})
       #
       # @param collection [String] The collection this object belongs to.
       #
@@ -440,6 +442,8 @@ module Knockapi
       #
       # @param id [String] Unique identifier for the preference set.
       #
+      # @param _persistence_strategy [Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::PersistenceStrategy] Controls how the preference set is persisted. 'replace' will completely replace
+      #
       # @param categories [Hash{Symbol=>Boolean, Knockapi::Models::Recipients::PreferenceSetRequest::Category::PreferenceSetWorkflowCategorySettingObject}, nil] An object where the key is the category and the values are the preference settin
       #
       # @param channel_types [Knockapi::Models::Recipients::PreferenceSetChannelTypes, nil] Channel type preferences.

data/lib/knockapi/resources/users.rb

@@ -375,15 +375,19 @@ module Knockapi
       # Some parameter documentations has been truncated, see
       # {Knockapi::Models::UserSetPreferencesParams} for more details.
       #
-      # Updates a complete preference set for a user. This is a destructive operation
-      # that will replace the existing preference set for the user.
+      # Updates a complete preference set for a user. By default, this is a destructive
+      # operation and will replace any existing preferences with the preferences given.
+      # Use '**persistence_strategy**': 'merge' to merge with existing preferences
+      # instead.
       #
-      # @overload set_preferences(user_id, id, categories: nil, channel_types: nil, workflows: nil, request_options: {})
+      # @overload set_preferences(user_id, id, _persistence_strategy: nil, categories: nil, channel_types: nil, workflows: nil, request_options: {})
       #
       # @param user_id [String] The unique identifier of the user.
       #
       # @param id [String] Unique identifier for the preference set.
       #
+      # @param _persistence_strategy [Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::PersistenceStrategy] Controls how the preference set is persisted. 'replace' will completely replace
+      #
       # @param categories [Hash{Symbol=>Boolean, Knockapi::Models::Recipients::PreferenceSetRequest::Category::PreferenceSetWorkflowCategorySettingObject}, nil] An object where the key is the category and the values are the preference settin
       #
       # @param channel_types [Knockapi::Models::Recipients::PreferenceSetChannelTypes, nil] Channel type preferences.

data/lib/knockapi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Knockapi
-  VERSION = "1.10.3"
+  VERSION = "1.11.1"
 end

data/rbi/knockapi/errors.rbi

@@ -59,10 +59,10 @@ module Knockapi
     end
 
     class APIConnectionError < Knockapi::Errors::APIError
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :status
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :body
 
       # @api private

data/rbi/knockapi/models/recipients/preference_set_request.rbi

@@ -12,6 +12,25 @@ module Knockapi
             )
           end
 
+        # Controls how the preference set is persisted. 'replace' will completely replace
+        # the preference set, 'merge' will merge with existing preferences.
+        sig do
+          returns(
+            T.nilable(
+              Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::OrSymbol
+            )
+          )
+        end
+        attr_reader :_persistence_strategy
+
+        sig do
+          params(
+            _persistence_strategy:
+              Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::OrSymbol
+          ).void
+        end
+        attr_writer :_persistence_strategy
+
         # An object where the key is the category and the values are the preference
         # settings for that category.
         sig do
@@ -63,6 +82,8 @@ module Knockapi
         # A request to set a preference set for a recipient.
         sig do
           params(
+            _persistence_strategy:
+              Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::OrSymbol,
             categories:
               T.nilable(
                 T::Hash[
@@ -90,6 +111,9 @@ module Knockapi
           ).returns(T.attached_class)
         end
         def self.new(
+          # Controls how the preference set is persisted. 'replace' will completely replace
+          # the preference set, 'merge' will merge with existing preferences.
+          _persistence_strategy: nil,
           # An object where the key is the category and the values are the preference
           # settings for that category.
           categories: nil,
@@ -104,6 +128,8 @@ module Knockapi
         sig do
           override.returns(
             {
+              _persistence_strategy:
+                Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::OrSymbol,
               categories:
                 T.nilable(
                   T::Hash[
@@ -132,6 +158,42 @@ module Knockapi
         def to_hash
         end
 
+        # Controls how the preference set is persisted. 'replace' will completely replace
+        # the preference set, 'merge' will merge with existing preferences.
+        module PersistenceStrategy
+          extend Knockapi::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MERGE =
+            T.let(
+              :merge,
+              Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::TaggedSymbol
+            )
+          REPLACE =
+            T.let(
+              :replace,
+              Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         # Workflow or category preferences within a preference set
         module Category
           extend Knockapi::Internal::Type::Union

data/rbi/knockapi/resources/objects.rbi

@@ -422,17 +422,21 @@ module Knockapi
       )
       end
 
-      # Sets preferences within the given preference set. This is a destructive
-      # operation and will replace any existing preferences with the preferences given.
-      # If no object exists in the current environment for the given `:collection` and
-      # `:object_id`, Knock will create the object as part of this request. The
-      # preference set `:id` can be either `default` or a `tenant.id`. Learn more about
+      # Sets preferences within the given preference set. By default, this is a
+      # destructive operation and will replace any existing preferences with the
+      # preferences given. Use '\_\_persistence_strategy': 'merge' to merge with
+      # existing preferences instead. If no object exists in the current environment for
+      # the given `:collection` and `:object_id`, Knock will create the object as part
+      # of this request. The preference set `:id` can be either `default` or a
+      # `tenant.id`. Learn more about
       # [per-tenant preferences](/preferences/tenant-preferences).
       sig do
         params(
           collection: String,
           object_id_: String,
           id: String,
+          _persistence_strategy:
+            Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::OrSymbol,
           categories:
             T.nilable(
               T::Hash[
@@ -465,6 +469,9 @@ module Knockapi
         object_id_,
         # Unique identifier for the preference set.
         id,
+        # Controls how the preference set is persisted. 'replace' will completely replace
+        # the preference set, 'merge' will merge with existing preferences.
+        _persistence_strategy: nil,
         # An object where the key is the category and the values are the preference
         # settings for that category.
         categories: nil,

data/rbi/knockapi/resources/users.rbi

@@ -362,12 +362,16 @@ module Knockapi
       )
       end
 
-      # Updates a complete preference set for a user. This is a destructive operation
-      # that will replace the existing preference set for the user.
+      # Updates a complete preference set for a user. By default, this is a destructive
+      # operation and will replace any existing preferences with the preferences given.
+      # Use '**persistence_strategy**': 'merge' to merge with existing preferences
+      # instead.
       sig do
         params(
           user_id: String,
           id: String,
+          _persistence_strategy:
+            Knockapi::Recipients::PreferenceSetRequest::PersistenceStrategy::OrSymbol,
           categories:
             T.nilable(
               T::Hash[
@@ -398,6 +402,9 @@ module Knockapi
         user_id,
         # Unique identifier for the preference set.
         id,
+        # Controls how the preference set is persisted. 'replace' will completely replace
+        # the preference set, 'merge' will merge with existing preferences.
+        _persistence_strategy: nil,
         # An object where the key is the category and the values are the preference
         # settings for that category.
         categories: nil,

data/sig/knockapi/models/recipients/preference_set_request.rbs

@@ -3,12 +3,19 @@ module Knockapi
     module Recipients
       type preference_set_request =
         {
+          _persistence_strategy: Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy,
           categories: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::category]?,
           channel_types: Knockapi::Recipients::PreferenceSetChannelTypes?,
           workflows: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::workflow]?
         }
 
       class PreferenceSetRequest < Knockapi::Internal::Type::BaseModel
+        attr_reader _persistence_strategy: Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy?
+
+        def _persistence_strategy=: (
+          Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy
+        ) -> Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy
+
         attr_accessor categories: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::category]?
 
         attr_accessor channel_types: Knockapi::Recipients::PreferenceSetChannelTypes?
@@ -16,17 +23,30 @@ module Knockapi
         attr_accessor workflows: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::workflow]?
 
         def initialize: (
+          ?_persistence_strategy: Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy,
           ?categories: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::category]?,
           ?channel_types: Knockapi::Recipients::PreferenceSetChannelTypes?,
           ?workflows: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::workflow]?
         ) -> void
 
         def to_hash: -> {
+          _persistence_strategy: Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy,
           categories: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::category]?,
           channel_types: Knockapi::Recipients::PreferenceSetChannelTypes?,
           workflows: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::workflow]?
         }
 
+        type persistence_strategy = :merge | :replace
+
+        module PersistenceStrategy
+          extend Knockapi::Internal::Type::Enum
+
+          MERGE: :merge
+          REPLACE: :replace
+
+          def self?.values: -> ::Array[Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy]
+        end
+
         type category =
           bool
           | Knockapi::Recipients::PreferenceSetRequest::Category::PreferenceSetWorkflowCategorySettingObject

data/sig/knockapi/resources/objects.rbs

@@ -125,6 +125,7 @@ module Knockapi
         String collection,
         String object_id_,
         String id,
+        ?_persistence_strategy: Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy,
         ?categories: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::category]?,
         ?channel_types: Knockapi::Recipients::PreferenceSetChannelTypes?,
         ?workflows: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::workflow]?,

data/sig/knockapi/resources/users.rbs

@@ -112,6 +112,7 @@ module Knockapi
       def set_preferences: (
         String user_id,
         String id,
+        ?_persistence_strategy: Knockapi::Models::Recipients::PreferenceSetRequest::persistence_strategy,
         ?categories: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::category]?,
         ?channel_types: Knockapi::Recipients::PreferenceSetChannelTypes?,
         ?workflows: ::Hash[Symbol, Knockapi::Models::Recipients::PreferenceSetRequest::workflow]?,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: knockapi
 version: !ruby/object:Gem::Version
-  version: 1.10.3
+  version: 1.11.1
 platform: ruby
 authors:
 - Knock
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-13 00:00:00.000000000 Z
+date: 2025-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool