knockapi 1.15.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d72e806e4aa7f07a86c10e93b8e6060c1da2860ab3d8af247e6c20e83bedacf
-  data.tar.gz: 49d2bd4bfe5cc74233d8549938819497bf410f7b2d5686cb8c2096c6f86d40db
+  metadata.gz: fc785b0ad211db7b83b53f41e0049c338cb773c1e38939ae169b79d8f7c864c0
+  data.tar.gz: 6da67b0bb566b75e47f5f8e3df16f186d1be34d66a465e64849cad9f796da95d
 SHA512:
-  metadata.gz: 18b9a4fcab27e4ed869e66b8f189f3ddd780dbe6636eba4a29b143d1cc5362a4069812f55a65041b92b5a1820fe8be29b0b08dd16bfb791504b9e1b163d9cb00
-  data.tar.gz: 2c8f5226db4d52750c0905dfc38de19ba144cc771e4b4d9316972f7395641f22a09eebae4e0f63315d4d1450172d490502eed29a13e4959888a932529bfefa35
+  metadata.gz: f8aa5dd11bb82eb2b81d6c2e359db5da4a97088f649d9808eccf6fd74d356ead63b919aedaa2b61bd339a958ade85deccf9965f20677b5d5646c38d9b9567169
+  data.tar.gz: 2d0532da30ba698de50465a59f46cd96ce75cd63be73807ee92124181ec5e03e48b804a1011f16cc43ff4cf6a08c285550bb7bcbd7db6b43f089121946e95f3a

data/CHANGELOG.md

@@ -1,5 +1,60 @@
 # Changelog
 
+## 1.17.0 (2025-10-24)
+
+Full Changelog: [v1.16.0...v1.17.0](https://github.com/knocklabs/knock-ruby/compare/v1.16.0...v1.17.0)
+
+### Features
+
+* **api:** api update ([fd477b8](https://github.com/knocklabs/knock-ruby/commit/fd477b877f0a74c124a531a9f9b09e52905383b7))
+* **api:** api update ([e47f831](https://github.com/knocklabs/knock-ruby/commit/e47f831b8ec05779d0003c27f701f9b0fd1c85b5))
+* **api:** api update ([2b5808c](https://github.com/knocklabs/knock-ruby/commit/2b5808ccb42252fdebc45486d231aba4dfa9a7b7))
+* **api:** api update ([99546b7](https://github.com/knocklabs/knock-ruby/commit/99546b73a6a6440e373059c1bdc71d48532af3fa))
+* **api:** api update ([042c92a](https://github.com/knocklabs/knock-ruby/commit/042c92a80665539dfeda7c2b8de0acead59fcfb1))
+* **api:** api update ([0f7fc4a](https://github.com/knocklabs/knock-ruby/commit/0f7fc4a35357d5cf6cb8394f0df9b60598d15e63))
+* handle thread interrupts in the core HTTP client ([6161a77](https://github.com/knocklabs/knock-ruby/commit/6161a7749b9fa424f49758cebd3753d135a84095))
+
+
+### Bug Fixes
+
+* absolutely qualified uris should always override the default ([2bb6341](https://github.com/knocklabs/knock-ruby/commit/2bb63414bbf3b9d9b4b996cd75341a183a6aa792))
+* should not reuse buffers for `IO.copy_stream` interop ([6464681](https://github.com/knocklabs/knock-ruby/commit/64646819574a19a1eb4969dc4abbc1d718ed7f4f))
+
+
+### Chores
+
+* ignore linter error for tests having large collections ([20f8ea6](https://github.com/knocklabs/knock-ruby/commit/20f8ea6a8cae8b3463b48d48f4ad065df465cddb))
+* simplify model references ([c126d85](https://github.com/knocklabs/knock-ruby/commit/c126d85300aa1ffe211fbc8e1c25eff4ca25ab7e))
+
+## 1.16.0 (2025-10-07)
+
+Full Changelog: [v1.15.0...v1.16.0](https://github.com/knocklabs/knock-ruby/compare/v1.15.0...v1.16.0)
+
+### Features
+
+* **api:** api update ([f006836](https://github.com/knocklabs/knock-ruby/commit/f0068369fd1ad7dfa9843753966d6bfb3758e1ea))
+* **api:** api update ([8f74167](https://github.com/knocklabs/knock-ruby/commit/8f74167231ab9aba28065beb23922d7c4cba9cea))
+* **api:** api update ([27835b7](https://github.com/knocklabs/knock-ruby/commit/27835b7a76ec99e59511e5f92e0ddb88a48ed608))
+* **api:** manual updates ([22850d8](https://github.com/knocklabs/knock-ruby/commit/22850d8c0b0605e045cc7d19020ac9f9c97ae163))
+
+
+### Bug Fixes
+
+* always send `filename=...` for multipart requests where a file is expected ([1a6d4ac](https://github.com/knocklabs/knock-ruby/commit/1a6d4acdcf66e42ddc5b813a61dc7c535e5f90ee))
+* coroutine leaks from connection pool ([3bc1ff2](https://github.com/knocklabs/knock-ruby/commit/3bc1ff25c7b0cda3f712779d67a8c5f6f5b28969))
+* **internal:** use null byte as file separator in the fast formatting script ([d8c723e](https://github.com/knocklabs/knock-ruby/commit/d8c723ed107313e3cc641ea8b68eb5ee8543bfcc))
+* shorten multipart boundary sep to less than RFC specificed max length ([66403e8](https://github.com/knocklabs/knock-ruby/commit/66403e82039587fbf154aff05c2cbfc1e56066a0))
+
+
+### Performance Improvements
+
+* faster code formatting ([b578cd0](https://github.com/knocklabs/knock-ruby/commit/b578cd025eefbe8b3ba863403c8a59f9b0acc6bf))
+
+
+### Chores
+
+* allow fast-format to use bsd sed as well ([c57f00b](https://github.com/knocklabs/knock-ruby/commit/c57f00b885b596ea799f8929986228240fa3aab4))
+
 ## 1.15.0 (2025-09-23)
 
 Full Changelog: [v1.14.0...v1.15.0](https://github.com/knocklabs/knock-ruby/compare/v1.14.0...v1.15.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.15.0"
+gem "knockapi", "~> 1.17.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/knockapi/client.rb

@@ -18,9 +18,6 @@ module Knockapi
     # @return [String]
     attr_reader :api_key
 
-    # @return [Knockapi::Resources::Shared]
-    attr_reader :shared
-
     # @return [Knockapi::Resources::Recipients]
     attr_reader :recipients
 
@@ -108,7 +105,6 @@ module Knockapi
         idempotency_header: idempotency_header
       )
 
-      @shared = Knockapi::Resources::Shared.new(client: self)
       @recipients = Knockapi::Resources::Recipients.new(client: self)
       @users = Knockapi::Resources::Users.new(client: self)
       @objects = Knockapi::Resources::Objects.new(client: self)

data/lib/knockapi/file_part.rb

@@ -38,18 +38,21 @@ module Knockapi
     def to_yaml(*a) = read.to_yaml(*a)
 
     # @param content [Pathname, StringIO, IO, String]
-    # @param filename [String, nil]
+    # @param filename [Pathname, String, nil]
     # @param content_type [String, nil]
     def initialize(content, filename: nil, content_type: nil)
-      @content = content
+      @content_type = content_type
       @filename =
-        case content
-        in Pathname
-          filename.nil? ? content.basename.to_path : ::File.basename(filename)
+        case [filename, (@content = content)]
+        in [String | Pathname, _]
+          ::File.basename(filename)
+        in [nil, Pathname]
+          content.basename.to_path
+        in [nil, IO]
+          content.to_path
         else
-          filename.nil? ? nil : ::File.basename(filename)
+          filename
         end
-      @content_type = content_type
     end
   end
 end

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

@@ -128,37 +128,47 @@ module Knockapi
           url, deadline = request.fetch_values(:url, :deadline)
 
           req = nil
-          eof = false
           finished = false
-          closing = nil
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
-            with_pool(url, deadline: deadline) do |conn|
-              next if finished
-
-              req, closing = self.class.build_request(request) do
-                self.class.calibrate_socket_timeout(conn, deadline)
-              end
-
-              self.class.calibrate_socket_timeout(conn, deadline)
-              unless conn.started?
-                conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
-                conn.start
-              end
+            next if finished
 
-              self.class.calibrate_socket_timeout(conn, deadline)
-              conn.request(req) do |rsp|
-                y << [conn, req, rsp]
-                break if finished
+            with_pool(url, deadline: deadline) do |conn|
+              eof = false
+              closing = nil
+              ::Thread.handle_interrupt(Object => :never) do
+                ::Thread.handle_interrupt(Object => :immediate) do
+                  req, closing = self.class.build_request(request) do
+                    self.class.calibrate_socket_timeout(conn, deadline)
+                  end
 
-                rsp.read_body do |bytes|
-                  y << bytes.force_encoding(Encoding::BINARY)
-                  break if finished
+                  self.class.calibrate_socket_timeout(conn, deadline)
+                  unless conn.started?
+                    conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
+                    conn.start
+                  end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
+                  conn.request(req) do |rsp|
+                    y << [req, rsp]
+                    break if finished
+
+                    rsp.read_body do |bytes|
+                      y << bytes.force_encoding(Encoding::BINARY)
+                      break if finished
+
+                      self.class.calibrate_socket_timeout(conn, deadline)
+                    end
+                    eof = true
+                  end
+                end
+              ensure
+                begin
+                  conn.finish if !eof && conn&.started?
+                ensure
+                  closing&.call
                 end
-                eof = true
               end
             end
           rescue Timeout::Error
@@ -168,17 +178,10 @@ module Knockapi
           end
           # rubocop:enable Metrics/BlockLength
 
-          conn, _, response = enum.next
+          _, response = enum.next
           body = Knockapi::Internal::Util.fused_enum(enum, external: true) do
             finished = true
-            tap do
-              enum.next
-            rescue StopIteration
-              nil
-            end
-          ensure
-            conn.finish if !eof && conn&.started?
-            closing&.call
+            loop { enum.next }
           end
           [Integer(response.code), response, body]
         end

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

@@ -82,17 +82,20 @@ module Knockapi
           #
           # @return [Pathname, StringIO, IO, String, Object]
           def dump(value, state:)
-            # rubocop:disable Lint/DuplicateBranch
             case value
+            in StringIO | String
+              # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
+              # while not required, a filename is recommended, and in practice many servers do expect this
+              Knockapi::FilePart.new(value, filename: "upload")
             in IO
               state[:can_retry] = false
+              value.to_path.nil? ? Knockapi::FilePart.new(value, filename: "upload") : value
             in Knockapi::FilePart if value.content.is_a?(IO)
               state[:can_retry] = false
+              value
             else
+              value
             end
-            # rubocop:enable Lint/DuplicateBranch
-
-            value
           end
 
           # @api private

data/lib/knockapi/internal/util.rb

@@ -346,8 +346,9 @@ module Knockapi
           base_path, base_query = lhs.fetch_values(:path, :query)
           slashed = base_path.end_with?("/") ? base_path : "#{base_path}/"
 
-          parsed_path, parsed_query = parse_uri(rhs.fetch(:path)).fetch_values(:path, :query)
-          override = URI::Generic.build(**rhs.slice(:scheme, :host, :port), path: parsed_path)
+          merged = {**parse_uri(rhs.fetch(:path)), **rhs.except(:path, :query)}
+          parsed_path, parsed_query = merged.fetch_values(:path, :query)
+          override = URI::Generic.build(**merged.slice(:scheme, :host, :port), path: parsed_path)
 
           joined = URI.join(URI::Generic.build(lhs.except(:path, :query)), slashed, override)
           query = deep_merge(
@@ -473,10 +474,9 @@ module Knockapi
         # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
-            buf = String.new
             y.define_singleton_method(:write) do
-              self << buf.replace(_1)
-              buf.bytesize
+              self << _1.dup
+              _1.bytesize
             end
 
             blk.call(y)
@@ -566,7 +566,8 @@ module Knockapi
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
-          boundary = SecureRandom.urlsafe_base64(60)
+          # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
+          boundary = SecureRandom.urlsafe_base64(46)
 
           closing = []
           strio = writable_enum do |y|

data/lib/knockapi/models/audience_add_members_params.rb

@@ -8,13 +8,13 @@ module Knockapi
       include Knockapi::Internal::Type::RequestParameters
 
       # @!attribute members
-      #   A list of audience members to add.
+      #   A list of audience members to add. Limited to 1,000 members per request.
       #
       #   @return [Array<Knockapi::Models::AudienceAddMembersParams::Member>]
       required :members, -> { Knockapi::Internal::Type::ArrayOf[Knockapi::AudienceAddMembersParams::Member] }
 
       # @!method initialize(members:, request_options: {})
-      #   @param members [Array<Knockapi::Models::AudienceAddMembersParams::Member>] A list of audience members to add.
+      #   @param members [Array<Knockapi::Models::AudienceAddMembersParams::Member>] A list of audience members to add. Limited to 1,000 members per request.
       #
       #   @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/knockapi/models/identify_user_request.rb

@@ -12,7 +12,7 @@ module Knockapi
       # @!attribute channel_data
       #   A request to set channel data for a type of channel inline.
       #
-      #   @return [Hash{Symbol=>Knockapi::Models::Recipients::PushChannelData, Knockapi::Models::Recipients::OneSignalChannelData, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwsSnsPushChannelData, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil]
+      #   @return [Hash{Symbol=>Knockapi::Models::Recipients::InlineChannelDataRequestItem::PushChannelDataTokensOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwssnsPushChannelDataTargetArNsOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::OneSignalChannelDataPlayerIDsOnly, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil]
       optional :channel_data,
                -> {
                  Knockapi::Internal::Type::HashOf[union: Knockapi::Recipients::InlineChannelDataRequestItem]
@@ -79,7 +79,7 @@ module Knockapi
       #
       #   @param avatar [String, nil] A URL for the avatar of the user.
       #
-      #   @param channel_data [Hash{Symbol=>Knockapi::Models::Recipients::PushChannelData, Knockapi::Models::Recipients::OneSignalChannelData, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwsSnsPushChannelData, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil] A request to set channel data for a type of channel inline.
+      #   @param channel_data [Hash{Symbol=>Knockapi::Models::Recipients::InlineChannelDataRequestItem::PushChannelDataTokensOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwssnsPushChannelDataTargetArNsOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::OneSignalChannelDataPlayerIDsOnly, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil] A request to set channel data for a type of channel inline.
       #
       #   @param created_at [Time, nil] The creation date of the user from your system.
       #

data/lib/knockapi/models/inline_identify_user_request.rb

@@ -18,7 +18,7 @@ module Knockapi
       # @!attribute channel_data
       #   A request to set channel data for a type of channel inline.
       #
-      #   @return [Hash{Symbol=>Knockapi::Models::Recipients::PushChannelData, Knockapi::Models::Recipients::OneSignalChannelData, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwsSnsPushChannelData, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil]
+      #   @return [Hash{Symbol=>Knockapi::Models::Recipients::InlineChannelDataRequestItem::PushChannelDataTokensOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwssnsPushChannelDataTargetArNsOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::OneSignalChannelDataPlayerIDsOnly, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil]
       optional :channel_data,
                -> {
                  Knockapi::Internal::Type::HashOf[union: Knockapi::Recipients::InlineChannelDataRequestItem]
@@ -88,7 +88,7 @@ module Knockapi
       #
       #   @param avatar [String, nil] A URL for the avatar of the user.
       #
-      #   @param channel_data [Hash{Symbol=>Knockapi::Models::Recipients::PushChannelData, Knockapi::Models::Recipients::OneSignalChannelData, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwsSnsPushChannelData, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil] A request to set channel data for a type of channel inline.
+      #   @param channel_data [Hash{Symbol=>Knockapi::Models::Recipients::InlineChannelDataRequestItem::PushChannelDataTokensOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwssnsPushChannelDataTargetArNsOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::OneSignalChannelDataPlayerIDsOnly, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil] A request to set channel data for a type of channel inline.
       #
       #   @param created_at [Time, nil] The creation date of the user from your system.
       #

data/lib/knockapi/models/inline_object_request.rb

@@ -18,7 +18,7 @@ module Knockapi
       # @!attribute channel_data
       #   A request to set channel data for a type of channel inline.
       #
-      #   @return [Hash{Symbol=>Knockapi::Models::Recipients::PushChannelData, Knockapi::Models::Recipients::OneSignalChannelData, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwsSnsPushChannelData, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil]
+      #   @return [Hash{Symbol=>Knockapi::Models::Recipients::InlineChannelDataRequestItem::PushChannelDataTokensOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwssnsPushChannelDataTargetArNsOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::OneSignalChannelDataPlayerIDsOnly, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil]
       optional :channel_data,
                -> {
                  Knockapi::Internal::Type::HashOf[union: Knockapi::Recipients::InlineChannelDataRequestItem]
@@ -51,7 +51,7 @@ module Knockapi
       #
       #   @param collection [String] The collection this object belongs to.
       #
-      #   @param channel_data [Hash{Symbol=>Knockapi::Models::Recipients::PushChannelData, Knockapi::Models::Recipients::OneSignalChannelData, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwsSnsPushChannelData, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil] A request to set channel data for a type of channel inline.
+      #   @param channel_data [Hash{Symbol=>Knockapi::Models::Recipients::InlineChannelDataRequestItem::PushChannelDataTokensOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::AwssnsPushChannelDataTargetArNsOnly, Knockapi::Models::Recipients::InlineChannelDataRequestItem::OneSignalChannelDataPlayerIDsOnly, Knockapi::Models::Recipients::SlackChannelData, Knockapi::Models::Recipients::MsTeamsChannelData, Knockapi::Models::Recipients::DiscordChannelData}, nil] A request to set channel data for a type of channel inline.
       #
       #   @param created_at [Time, nil] Timestamp when the resource was created.
       #

data/lib/knockapi/models/message.rb

@@ -17,7 +17,9 @@ module Knockapi
       required :_typename, String, api_name: :__typename
 
       # @!attribute channel_id
-      #   The ID for the channel the message was sent through.
+      #   @deprecated
+      #
+      #   Deprecated, use channel.id instead.
       #
       #   @return [String]
       required :channel_id, String
@@ -43,7 +45,7 @@ module Knockapi
       required :recipient, union: -> { Knockapi::RecipientReference }
 
       # @!attribute source
-      #   The workflow that triggered the message.
+      #   The workflow or guide that triggered the message.
       #
       #   @return [Knockapi::Models::Message::Source]
       required :source, -> { Knockapi::Message::Source }
@@ -74,6 +76,12 @@ module Knockapi
       #   @return [Time, nil]
       optional :archived_at, Time, nil?: true
 
+      # @!attribute channel
+      #   A configured channel, which is a way to route messages to a provider.
+      #
+      #   @return [Knockapi::Models::Message::Channel, nil]
+      optional :channel, -> { Knockapi::Message::Channel }
+
       # @!attribute clicked_at
       #   Timestamp when the message was clicked.
       #
@@ -141,7 +149,7 @@ module Knockapi
       #   @return [String, nil]
       optional :workflow, String, nil?: true
 
-      # @!method initialize(id:, _typename:, channel_id:, engagement_statuses:, inserted_at:, recipient:, source:, status:, updated_at:, actors: nil, archived_at: nil, clicked_at: nil, data: nil, interacted_at: nil, link_clicked_at: nil, metadata: nil, read_at: nil, scheduled_at: nil, seen_at: nil, tenant: nil, workflow: nil)
+      # @!method initialize(id:, _typename:, channel_id:, engagement_statuses:, inserted_at:, recipient:, source:, status:, updated_at:, actors: nil, archived_at: nil, channel: nil, clicked_at: nil, data: nil, interacted_at: nil, link_clicked_at: nil, metadata: nil, read_at: nil, scheduled_at: nil, seen_at: nil, tenant: nil, workflow: nil)
       #   Some parameter documentations has been truncated, see
       #   {Knockapi::Models::Message} for more details.
       #
@@ -152,7 +160,7 @@ module Knockapi
       #
       #   @param _typename [String] The typename of the schema.
       #
-      #   @param channel_id [String] The ID for the channel the message was sent through.
+      #   @param channel_id [String] Deprecated, use channel.id instead.
       #
       #   @param engagement_statuses [Array<Symbol, Knockapi::Models::Message::EngagementStatus>] A list of engagement statuses.
       #
@@ -160,7 +168,7 @@ module Knockapi
       #
       #   @param recipient [String, Knockapi::Models::RecipientReference::ObjectReference] A reference to a recipient, either a user identifier (string) or an object refer
       #
-      #   @param source [Knockapi::Models::Message::Source] The workflow that triggered the message.
+      #   @param source [Knockapi::Models::Message::Source] The workflow or guide that triggered the message.
       #
       #   @param status [Symbol, Knockapi::Models::Message::Status] The message delivery status.
       #
@@ -170,6 +178,8 @@ module Knockapi
       #
       #   @param archived_at [Time, nil] Timestamp when the message was archived.
       #
+      #   @param channel [Knockapi::Models::Message::Channel] A configured channel, which is a way to route messages to a provider.
+      #
       #   @param clicked_at [Time, nil] Timestamp when the message was clicked.
       #
       #   @param data [Hash{Symbol=>Object}, nil] Data associated with the message’s workflow run. Includes the workflow trigger r
@@ -219,13 +229,13 @@ module Knockapi
         required :categories, Knockapi::Internal::Type::ArrayOf[String]
 
         # @!attribute key
-        #   The key of the workflow that triggered the message.
+        #   The key of the workflow or guide that triggered the message.
         #
         #   @return [String]
         required :key, String
 
         # @!attribute version_id
-        #   The ID of the version of the workflow that triggered the message.
+        #   The ID of the version of the workflow or guide that triggered the message.
         #
         #   @return [String]
         required :version_id, String
@@ -236,18 +246,40 @@ module Knockapi
         #   @return [String, nil]
         optional :step_ref, String, nil?: true
 
-        # @!method initialize(_typename:, categories:, key:, version_id:, step_ref: nil)
-        #   The workflow that triggered the message.
+        # @!attribute type
+        #   Whether this message was generated from a workflow, broadcast, or guide.
+        #
+        #   @return [Symbol, Knockapi::Models::Message::Source::Type, nil]
+        optional :type, enum: -> { Knockapi::Message::Source::Type }
+
+        # @!method initialize(_typename:, categories:, key:, version_id:, step_ref: nil, type: nil)
+        #   The workflow or guide that triggered the message.
         #
         #   @param _typename [String]
         #
         #   @param categories [Array<String>] The categories associated with the message.
         #
-        #   @param key [String] The key of the workflow that triggered the message.
+        #   @param key [String] The key of the workflow or guide that triggered the message.
         #
-        #   @param version_id [String] The ID of the version of the workflow that triggered the message.
+        #   @param version_id [String] The ID of the version of the workflow or guide that triggered the message.
         #
         #   @param step_ref [String, nil] The step reference for the step in the workflow that generated the message.
+        #
+        #   @param type [Symbol, Knockapi::Models::Message::Source::Type] Whether this message was generated from a workflow, broadcast, or guide.
+
+        # Whether this message was generated from a workflow, broadcast, or guide.
+        #
+        # @see Knockapi::Models::Message::Source#type
+        module Type
+          extend Knockapi::Internal::Type::Enum
+
+          BROADCAST = :broadcast
+          WORKFLOW = :workflow
+          GUIDE = :guide
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
 
       # The message delivery status.
@@ -267,6 +299,87 @@ module Knockapi
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # @see Knockapi::Models::Message#channel
+      class Channel < Knockapi::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique identifier for the channel.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #   The timestamp of when the channel was created.
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute provider
+        #   The ID of the provider that this channel uses to deliver messages.
+        #
+        #   @return [String]
+        required :provider, String
+
+        # @!attribute type
+        #   The type of channel, determining what kind of messages it can send.
+        #
+        #   @return [Symbol, Knockapi::Models::Message::Channel::Type]
+        required :type, enum: -> { Knockapi::Message::Channel::Type }
+
+        # @!attribute updated_at
+        #   The timestamp of when the channel was last updated.
+        #
+        #   @return [Time]
+        required :updated_at, Time
+
+        # @!attribute key
+        #   Unique identifier for the channel within a project (immutable once created).
+        #
+        #   @return [String, nil]
+        optional :key, String, nil?: true
+
+        # @!attribute name
+        #   The human-readable name of the channel.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!method initialize(id:, created_at:, provider:, type:, updated_at:, key: nil, name: nil)
+        #   A configured channel, which is a way to route messages to a provider.
+        #
+        #   @param id [String] The unique identifier for the channel.
+        #
+        #   @param created_at [Time] The timestamp of when the channel was created.
+        #
+        #   @param provider [String] The ID of the provider that this channel uses to deliver messages.
+        #
+        #   @param type [Symbol, Knockapi::Models::Message::Channel::Type] The type of channel, determining what kind of messages it can send.
+        #
+        #   @param updated_at [Time] The timestamp of when the channel was last updated.
+        #
+        #   @param key [String, nil] Unique identifier for the channel within a project (immutable once created).
+        #
+        #   @param name [String, nil] The human-readable name of the channel.
+
+        # The type of channel, determining what kind of messages it can send.
+        #
+        # @see Knockapi::Models::Message::Channel#type
+        module Type
+          extend Knockapi::Internal::Type::Enum
+
+          EMAIL = :email
+          IN_APP = :in_app
+          IN_APP_FEED = :in_app_feed
+          IN_APP_GUIDE = :in_app_guide
+          SMS = :sms
+          PUSH = :push
+          CHAT = :chat
+          HTTP = :http
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end

data/lib/knockapi/models/messages/batch_archive_response.rb

@@ -4,7 +4,7 @@ module Knockapi
   module Models
     module Messages
       # @type [Knockapi::Internal::Type::Converter]
-      BatchArchiveResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Models::Message }]
+      BatchArchiveResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Message }]
     end
   end
 end

data/lib/knockapi/models/messages/batch_mark_as_interacted_response.rb

@@ -4,7 +4,7 @@ module Knockapi
   module Models
     module Messages
       # @type [Knockapi::Internal::Type::Converter]
-      BatchMarkAsInteractedResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Models::Message }]
+      BatchMarkAsInteractedResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Message }]
     end
   end
 end

data/lib/knockapi/models/messages/batch_mark_as_read_response.rb

@@ -4,7 +4,7 @@ module Knockapi
   module Models
     module Messages
       # @type [Knockapi::Internal::Type::Converter]
-      BatchMarkAsReadResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Models::Message }]
+      BatchMarkAsReadResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Message }]
     end
   end
 end

data/lib/knockapi/models/messages/batch_mark_as_seen_response.rb

@@ -4,7 +4,7 @@ module Knockapi
   module Models
     module Messages
       # @type [Knockapi::Internal::Type::Converter]
-      BatchMarkAsSeenResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Models::Message }]
+      BatchMarkAsSeenResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Message }]
     end
   end
 end

data/lib/knockapi/models/messages/batch_mark_as_unread_response.rb

@@ -4,7 +4,7 @@ module Knockapi
   module Models
     module Messages
       # @type [Knockapi::Internal::Type::Converter]
-      BatchMarkAsUnreadResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Models::Message }]
+      BatchMarkAsUnreadResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Message }]
     end
   end
 end

data/lib/knockapi/models/messages/batch_mark_as_unseen_response.rb

@@ -4,7 +4,7 @@ module Knockapi
   module Models
     module Messages
       # @type [Knockapi::Internal::Type::Converter]
-      BatchMarkAsUnseenResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Models::Message }]
+      BatchMarkAsUnseenResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Message }]
     end
   end
 end

data/lib/knockapi/models/messages/batch_unarchive_response.rb

@@ -4,7 +4,7 @@ module Knockapi
   module Models
     module Messages
       # @type [Knockapi::Internal::Type::Converter]
-      BatchUnarchiveResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Models::Message }]
+      BatchUnarchiveResponse = Knockapi::Internal::Type::ArrayOf[-> { Knockapi::Message }]
     end
   end
 end