knockapi 1.20.0 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59aa0cd10e59e4f0f18ddbefd0da6e0482a90c1243539d52389c1074e1a9e14c
-  data.tar.gz: 9a797662afb59af4d0964d0025957607feb398ea4f8a728e359a174886222d31
+  metadata.gz: f84eb716141c76105b2acb3a28285745d095515554458a21179ebd249a4d718b
+  data.tar.gz: 4eecf79648fb8d92f89a70bd9898a1baf42f050194074e488fda86b17c7a17b2
 SHA512:
-  metadata.gz: 6d1da55316e1915100adc1748a00de8aee8b46c8b7a710948a34190faa8f6a03cbe33f0856817c9437b82eb09aeb6fc7ea18f04b87498234dd7ddb623f4b5734
-  data.tar.gz: a4268192cef85172e23bdaf4287e7a0d6f9257bb199ea56b17800974aa16e8424fcdff12ee87eddd7e205801e40605ab6a00d5c7cbed8977a7057bb5227054d9
+  metadata.gz: 709a46b6b32a02e00757e34b88bf9a856648a651764d0efcb70025c71b89ce4dcd23db575fd761733c00f370aa2e92bd6cd1b7bd1792e8fd2a779f5b9ed9d71e
+  data.tar.gz: 5de4b46c82ce8adb49182334b3048ad403fb5d96576d2e942c84d6f9b82ade253b4c69d8f8188f1ab5383965afbf1e9eef4a35dc34d0998c11bc164a3591e95f

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.21.0 (2025-11-20)
+
+Full Changelog: [v1.20.0...v1.21.0](https://github.com/knocklabs/knock-ruby/compare/v1.20.0...v1.21.0)
+
+### Features
+
+* **api:** Add bulk delete subscriptions ([2fed837](https://github.com/knocklabs/knock-ruby/commit/2fed8371bbd0a682d8a5c3fd030024847c69180b))
+
+
+### Chores
+
+* explicitly require "base64" gem ([cde84e5](https://github.com/knocklabs/knock-ruby/commit/cde84e5db590434da5db78b9138915f3072ec82d))
+
 ## 1.20.0 (2025-11-19)
 
 Full Changelog: [v1.19.0...v1.20.0](https://github.com/knocklabs/knock-ruby/compare/v1.19.0...v1.20.0)

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.20.0"
+gem "knockapi", "~> 1.21.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Models
+    module Objects
+      # @see Knockapi::Resources::Objects::Bulk#delete_subscriptions
+      class BulkDeleteSubscriptionsParams < Knockapi::Internal::Type::BaseModel
+        extend Knockapi::Internal::Type::RequestParameters::Converter
+        include Knockapi::Internal::Type::RequestParameters
+
+        # @!attribute subscriptions
+        #   A nested list of subscriptions.
+        #
+        #   @return [Array<Knockapi::Models::Objects::BulkDeleteSubscriptionsParams::Subscription>]
+        required :subscriptions,
+                 -> { Knockapi::Internal::Type::ArrayOf[Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription] }
+
+        # @!method initialize(subscriptions:, request_options: {})
+        #   @param subscriptions [Array<Knockapi::Models::Objects::BulkDeleteSubscriptionsParams::Subscription>] A nested list of subscriptions.
+        #
+        #   @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}]
+
+        class Subscription < Knockapi::Internal::Type::BaseModel
+          # @!attribute id
+          #   Unique identifier for the object.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute recipients
+          #   The recipients of the subscription. You can subscribe up to 100 recipients to an
+          #   object at a time.
+          #
+          #   @return [Array<String, Knockapi::Models::RecipientReference::ObjectReference>]
+          required :recipients, -> { Knockapi::Internal::Type::ArrayOf[union: Knockapi::RecipientReference] }
+
+          # @!method initialize(id:, recipients:)
+          #   Some parameter documentations has been truncated, see
+          #   {Knockapi::Models::Objects::BulkDeleteSubscriptionsParams::Subscription} for
+          #   more details.
+          #
+          #   A list of subscriptions. 1 subscribed-to id, and N subscriber recipients.
+          #
+          #   @param id [String] Unique identifier for the object.
+          #
+          #   @param recipients [Array<String, Knockapi::Models::RecipientReference::ObjectReference>] The recipients of the subscription. You can subscribe up to 100 recipients to an
+        end
+      end
+    end
+  end
+end

data/lib/knockapi/resources/objects/bulk.rb

@@ -56,6 +56,31 @@ module Knockapi
           )
         end
 
+        # Delete subscriptions for many objects in a single collection type. If a
+        # subscription for an object in the collection doesn't exist, it will be skipped.
+        #
+        # @overload delete_subscriptions(collection, subscriptions:, request_options: {})
+        #
+        # @param collection [String] The collection this object belongs to.
+        #
+        # @param subscriptions [Array<Knockapi::Models::Objects::BulkDeleteSubscriptionsParams::Subscription>] A nested list of subscriptions.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::BulkOperation]
+        #
+        # @see Knockapi::Models::Objects::BulkDeleteSubscriptionsParams
+        def delete_subscriptions(collection, params)
+          parsed, options = Knockapi::Objects::BulkDeleteSubscriptionsParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["v1/objects/%1$s/bulk/subscriptions/delete", collection],
+            body: parsed,
+            model: Knockapi::BulkOperation,
+            options: options
+          )
+        end
+
         # Bulk sets up to 1,000 objects at a time in the specified collection.
         #
         # @overload set(collection, objects:, request_options: {})

data/lib/knockapi/version.rb

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

data/lib/knockapi.rb

@@ -3,6 +3,7 @@
 # Standard libraries.
 # rubocop:disable Lint/RedundantRequireStatement
 require "English"
+require "base64"
 require "cgi"
 require "date"
 require "erb"
@@ -125,6 +126,7 @@ require_relative "knockapi/models/object_list_schedules_params"
 require_relative "knockapi/models/object_list_subscriptions_params"
 require_relative "knockapi/models/objects/bulk_add_subscriptions_params"
 require_relative "knockapi/models/objects/bulk_delete_params"
+require_relative "knockapi/models/objects/bulk_delete_subscriptions_params"
 require_relative "knockapi/models/objects/bulk_set_params"
 require_relative "knockapi/models/object_set_channel_data_params"
 require_relative "knockapi/models/object_set_params"

data/manifest.yaml

@@ -1,5 +1,6 @@
 dependencies:
   - English
+  - base64
   - cgi
   - date
   - erb

data/rbi/knockapi/models/objects/bulk_delete_subscriptions_params.rbi

@@ -0,0 +1,121 @@
+# typed: strong
+
+module Knockapi
+  module Models
+    module Objects
+      class BulkDeleteSubscriptionsParams < Knockapi::Internal::Type::BaseModel
+        extend Knockapi::Internal::Type::RequestParameters::Converter
+        include Knockapi::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Knockapi::Objects::BulkDeleteSubscriptionsParams,
+              Knockapi::Internal::AnyHash
+            )
+          end
+
+        # A nested list of subscriptions.
+        sig do
+          returns(
+            T::Array[
+              Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription
+            ]
+          )
+        end
+        attr_accessor :subscriptions
+
+        sig do
+          params(
+            subscriptions:
+              T::Array[
+                Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription::OrHash
+              ],
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # A nested list of subscriptions.
+          subscriptions:,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              subscriptions:
+                T::Array[
+                  Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription
+                ],
+              request_options: Knockapi::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Subscription < Knockapi::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription,
+                Knockapi::Internal::AnyHash
+              )
+            end
+
+          # Unique identifier for the object.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The recipients of the subscription. You can subscribe up to 100 recipients to an
+          # object at a time.
+          sig do
+            returns(
+              T::Array[
+                T.any(String, Knockapi::RecipientReference::ObjectReference)
+              ]
+            )
+          end
+          attr_accessor :recipients
+
+          # A list of subscriptions. 1 subscribed-to id, and N subscriber recipients.
+          sig do
+            params(
+              id: String,
+              recipients:
+                T::Array[
+                  T.any(
+                    String,
+                    Knockapi::RecipientReference::ObjectReference::OrHash
+                  )
+                ]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Unique identifier for the object.
+            id:,
+            # The recipients of the subscription. You can subscribe up to 100 recipients to an
+            # object at a time.
+            recipients:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                recipients:
+                  T::Array[
+                    T.any(String, Knockapi::RecipientReference::ObjectReference)
+                  ]
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/knockapi/resources/objects/bulk.rbi

@@ -45,6 +45,27 @@ module Knockapi
         )
         end
 
+        # Delete subscriptions for many objects in a single collection type. If a
+        # subscription for an object in the collection doesn't exist, it will be skipped.
+        sig do
+          params(
+            collection: String,
+            subscriptions:
+              T::Array[
+                Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription::OrHash
+              ],
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(Knockapi::BulkOperation)
+        end
+        def delete_subscriptions(
+          # The collection this object belongs to.
+          collection,
+          # A nested list of subscriptions.
+          subscriptions:,
+          request_options: {}
+        )
+        end
+
         # Bulk sets up to 1,000 objects at a time in the specified collection.
         sig do
           params(

data/sig/knockapi/models/objects/bulk_delete_subscriptions_params.rbs

@@ -0,0 +1,50 @@
+module Knockapi
+  module Models
+    module Objects
+      type bulk_delete_subscriptions_params =
+        {
+          subscriptions: ::Array[Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription]
+        }
+        & Knockapi::Internal::Type::request_parameters
+
+      class BulkDeleteSubscriptionsParams < Knockapi::Internal::Type::BaseModel
+        extend Knockapi::Internal::Type::RequestParameters::Converter
+        include Knockapi::Internal::Type::RequestParameters
+
+        attr_accessor subscriptions: ::Array[Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription]
+
+        def initialize: (
+          subscriptions: ::Array[Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription],
+          ?request_options: Knockapi::request_opts
+        ) -> void
+
+        def to_hash: -> {
+          subscriptions: ::Array[Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription],
+          request_options: Knockapi::RequestOptions
+        }
+
+        type subscription =
+          {
+            id: String,
+            recipients: ::Array[Knockapi::Models::recipient_reference]
+          }
+
+        class Subscription < Knockapi::Internal::Type::BaseModel
+          attr_accessor id: String
+
+          attr_accessor recipients: ::Array[Knockapi::Models::recipient_reference]
+
+          def initialize: (
+            id: String,
+            recipients: ::Array[Knockapi::Models::recipient_reference]
+          ) -> void
+
+          def to_hash: -> {
+            id: String,
+            recipients: ::Array[Knockapi::Models::recipient_reference]
+          }
+        end
+      end
+    end
+  end
+end

data/sig/knockapi/resources/objects/bulk.rbs

@@ -14,6 +14,12 @@ module Knockapi
           ?request_options: Knockapi::request_opts
         ) -> Knockapi::BulkOperation
 
+        def delete_subscriptions: (
+          String collection,
+          subscriptions: ::Array[Knockapi::Objects::BulkDeleteSubscriptionsParams::Subscription],
+          ?request_options: Knockapi::request_opts
+        ) -> Knockapi::BulkOperation
+
         def set: (
           String collection,
           objects: ::Array[Knockapi::Objects::BulkSetParams::Object],

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: knockapi
 version: !ruby/object:Gem::Version
-  version: 1.20.0
+  version: 1.21.0
 platform: ruby
 authors:
 - Knock
@@ -131,6 +131,7 @@ files:
 - lib/knockapi/models/object_unset_channel_data_params.rb
 - lib/knockapi/models/objects/bulk_add_subscriptions_params.rb
 - lib/knockapi/models/objects/bulk_delete_params.rb
+- lib/knockapi/models/objects/bulk_delete_subscriptions_params.rb
 - lib/knockapi/models/objects/bulk_set_params.rb
 - lib/knockapi/models/page_info.rb
 - lib/knockapi/models/providers/ms_team_check_auth_params.rb
@@ -345,6 +346,7 @@ files:
 - rbi/knockapi/models/object_unset_channel_data_params.rbi
 - rbi/knockapi/models/objects/bulk_add_subscriptions_params.rbi
 - rbi/knockapi/models/objects/bulk_delete_params.rbi
+- rbi/knockapi/models/objects/bulk_delete_subscriptions_params.rbi
 - rbi/knockapi/models/objects/bulk_set_params.rbi
 - rbi/knockapi/models/page_info.rbi
 - rbi/knockapi/models/providers/ms_team_check_auth_params.rbi
@@ -558,6 +560,7 @@ files:
 - sig/knockapi/models/object_unset_channel_data_params.rbs
 - sig/knockapi/models/objects/bulk_add_subscriptions_params.rbs
 - sig/knockapi/models/objects/bulk_delete_params.rbs
+- sig/knockapi/models/objects/bulk_delete_subscriptions_params.rbs
 - sig/knockapi/models/objects/bulk_set_params.rbs
 - sig/knockapi/models/page_info.rbs
 - sig/knockapi/models/providers/ms_team_check_auth_params.rbs