zavudev 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64e64c7af653589498a74366233b107a36f2978e842197adc0831a9306134c5c
-  data.tar.gz: e96f566002fda804d792990fec6918bb22892e57999561cebbebdd4cbeaea62f
+  metadata.gz: b4ef6b1c38f382a0031988389835d7a923e031d506e14fe9f760ffa0e1b653f1
+  data.tar.gz: 461d663dc49c09fbb91bf15feaae55818f8cb5a259dc1e551d7d408781436996
 SHA512:
-  metadata.gz: b58b47292119665cc0b6b1481a133a469552e6490ea41b812bf69d3f1c1a73b8565bc019a20bef2065e21384792672c4de65b7a20f5fc2104e6646b3c6e8d0d8
-  data.tar.gz: 532b61631e9d3b2ebee0782f91071b8991a7035810eac2ce120a45f0e931546882713ee0a1c43d9ae2c86e73d18be3ca2603fab810ed30ed43054492fa5ba126
+  metadata.gz: 429315f63bb85c17c6e0be83a569fec22516f393ce234a6f763a4b83b099f8dc116e609dcebfd9034ea6f3034653c6a8e5d571fffcf6763ab30f68db78725d94
+  data.tar.gz: 7325d1f541ab42cdb0d40ecfbcc71b72f111cbb88747fb85344af03f49b5126ea0c554afae9379cb0bb0950055d330058cac51755088092c69b1dfcc0eeedccd

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.5.0 (2026-04-03)
+
+Full Changelog: [v0.4.1...v0.5.0](https://github.com/zavudev/sdk-ruby/compare/v0.4.1...v0.5.0)
+
+### Features
+
+* **api:** api update ([c5b49ca](https://github.com/zavudev/sdk-ruby/commit/c5b49ca5d2bf7ad14c267aa0544d929bd6be0ede))
+* **api:** api update ([e08767b](https://github.com/zavudev/sdk-ruby/commit/e08767b2a22bd0597697c7cfc1864e69b9064aed))
+
+## 0.4.1 (2026-04-01)
+
+Full Changelog: [v0.4.0...v0.4.1](https://github.com/zavudev/sdk-ruby/compare/v0.4.0...v0.4.1)
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([4cc4622](https://github.com/zavudev/sdk-ruby/commit/4cc462282ec8bcf85f123e7bc7cffbf9d4fca1cd))
+* **internal:** correct multipart form field name encoding ([43d6834](https://github.com/zavudev/sdk-ruby/commit/43d6834dab5f8d11e5a6a420b599a78c9f44b936))
+* variable name typo ([9fc59d5](https://github.com/zavudev/sdk-ruby/commit/9fc59d5049ff0a2eb4223ed13d65602e8b6d49a1))
+
+
+### Chores
+
+* **ci:** support opting out of skipping builds on metadata-only commits ([6011f4f](https://github.com/zavudev/sdk-ruby/commit/6011f4fb2114cd5abce24ec8a37314abf010b8a4))
+
 ## 0.4.0 (2026-03-26)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/zavudev/sdk-ruby/compare/v0.3.0...v0.4.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "zavudev", "~> 0.4.0"
+gem "zavudev", "~> 0.5.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/zavudev/internal/util.rb

@@ -157,7 +157,7 @@ module Zavudev
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Zavudev::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Zavudev::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module Zavudev
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Zavudev
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Zavudev::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Zavudev
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -571,16 +585,15 @@ module Zavudev
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in Zavudev::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end

data/lib/zavudev/models/message_send_params.rb

@@ -14,6 +14,13 @@ module Zavudev
       #   @return [String]
       required :to, String
 
+      # @!attribute attachments
+      #   Email attachments. Only supported when channel is 'email'. Maximum 40MB total
+      #   size.
+      #
+      #   @return [Array<Zavudev::Models::MessageSendParams::Attachment>, nil]
+      optional :attachments, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::MessageSendParams::Attachment] }
+
       # @!attribute channel
       #   Delivery channel. Use 'auto' for intelligent routing. If omitted with non-text
       #   messageType, WhatsApp is used. For email recipients, defaults to 'email'.
@@ -89,12 +96,14 @@ module Zavudev
       #   @return [String, nil]
       optional :zavu_sender, String
 
-      # @!method initialize(to:, channel: nil, content: nil, fallback_enabled: nil, html_body: nil, idempotency_key: nil, message_type: nil, metadata: nil, reply_to: nil, subject: nil, text: nil, voice_language: nil, zavu_sender: nil, request_options: {})
+      # @!method initialize(to:, attachments: nil, channel: nil, content: nil, fallback_enabled: nil, html_body: nil, idempotency_key: nil, message_type: nil, metadata: nil, reply_to: nil, subject: nil, text: nil, voice_language: nil, zavu_sender: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Zavudev::Models::MessageSendParams} for more details.
       #
       #   @param to [String] Recipient phone number in E.164 format, email address, or numeric chat ID (for T
       #
+      #   @param attachments [Array<Zavudev::Models::MessageSendParams::Attachment>] Email attachments. Only supported when channel is 'email'. Maximum 40MB total si
+      #
       #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing. If omitted with non-text m
       #
       #   @param content [Zavudev::Models::MessageContent] Additional content for non-text message types.
@@ -120,6 +129,55 @@ module Zavudev
       #   @param zavu_sender [String]
       #
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+
+      class Attachment < Zavudev::Internal::Type::BaseModel
+        # @!attribute filename
+        #   Name of the attached file.
+        #
+        #   @return [String]
+        required :filename, String
+
+        # @!attribute content
+        #   Content of the attached file as a Base64-encoded string.
+        #
+        #   @return [String, nil]
+        optional :content, String
+
+        # @!attribute content_id
+        #   Content ID for inline images. Reference in HTML as
+        #   `<img src="cid:your_content_id">`.
+        #
+        #   @return [String, nil]
+        optional :content_id, String
+
+        # @!attribute content_type
+        #   MIME type of the attachment. If not set, will be derived from the filename.
+        #
+        #   @return [String, nil]
+        optional :content_type, String
+
+        # @!attribute path
+        #   URL where the attachment file is hosted. The server will fetch the file.
+        #
+        #   @return [String, nil]
+        optional :path, String
+
+        # @!method initialize(filename:, content: nil, content_id: nil, content_type: nil, path: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::MessageSendParams::Attachment} for more details.
+        #
+        #   Email attachment. Provide either `content` (base64) or `path` (URL), not both.
+        #
+        #   @param filename [String] Name of the attached file.
+        #
+        #   @param content [String] Content of the attached file as a Base64-encoded string.
+        #
+        #   @param content_id [String] Content ID for inline images. Reference in HTML as `<img src="cid:your_content_i
+        #
+        #   @param content_type [String] MIME type of the attachment. If not set, will be derived from the filename.
+        #
+        #   @param path [String] URL where the attachment file is hosted. The server will fetch the file.
+      end
     end
   end
 end

data/lib/zavudev/models/webhook_event.rb

@@ -30,6 +30,11 @@ module Zavudev
     #
     # - `conversation.new`: New conversation started with a contact
     # - `template.status_changed`: WhatsApp template approval status changed
+    #
+    # **Partner events:**
+    #
+    # - `invitation.status_changed`: A partner invitation status changed (pending,
+    #   in_progress, completed, cancelled)
     module WebhookEvent
       extend Zavudev::Internal::Type::Enum
 
@@ -43,6 +48,7 @@ module Zavudev
       BROADCAST_STATUS_CHANGED = :"broadcast.status_changed"
       CONVERSATION_NEW = :"conversation.new"
       TEMPLATE_STATUS_CHANGED = :"template.status_changed"
+      INVITATION_STATUS_CHANGED = :"invitation.status_changed"
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/zavudev/resources/messages.rb

@@ -107,10 +107,12 @@ module Zavudev
       # - Unverified accounts: 200 messages per channel per day
       # - Complete KYC verification to increase limits to 10,000/day
       #
-      # @overload send_(to:, channel: nil, content: nil, fallback_enabled: nil, html_body: nil, idempotency_key: nil, message_type: nil, metadata: nil, reply_to: nil, subject: nil, text: nil, voice_language: nil, zavu_sender: nil, request_options: {})
+      # @overload send_(to:, attachments: nil, channel: nil, content: nil, fallback_enabled: nil, html_body: nil, idempotency_key: nil, message_type: nil, metadata: nil, reply_to: nil, subject: nil, text: nil, voice_language: nil, zavu_sender: nil, request_options: {})
       #
       # @param to [String] Body param: Recipient phone number in E.164 format, email address, or numeric ch
       #
+      # @param attachments [Array<Zavudev::Models::MessageSendParams::Attachment>] Body param: Email attachments. Only supported when channel is 'email'. Maximum 4
+      #
       # @param channel [Symbol, Zavudev::Models::Channel] Body param: Delivery channel. Use 'auto' for intelligent routing. If omitted wit
       #
       # @param content [Zavudev::Models::MessageContent] Body param: Additional content for non-text message types.

data/lib/zavudev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zavudev
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/rbi/zavudev/internal/util.rbi

@@ -148,12 +148,20 @@ module Zavudev
         end
       end
 
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = T.let(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/, Regexp)
+
       class << self
         # @api private
         sig { params(uri: URI::Generic).returns(String) }
         def uri_origin(uri)
         end
 
+        # @api private
+        sig { params(path: T.any(String, Integer)).returns(String) }
+        def encode_path(path)
+        end
+
         # @api private
         sig { params(path: T.any(String, T::Array[String])).returns(String) }
         def interpolate_path(path)

data/rbi/zavudev/models/message_send_params.rbi

@@ -16,6 +16,20 @@ module Zavudev
       sig { returns(String) }
       attr_accessor :to
 
+      # Email attachments. Only supported when channel is 'email'. Maximum 40MB total
+      # size.
+      sig do
+        returns(T.nilable(T::Array[Zavudev::MessageSendParams::Attachment]))
+      end
+      attr_reader :attachments
+
+      sig do
+        params(
+          attachments: T::Array[Zavudev::MessageSendParams::Attachment::OrHash]
+        ).void
+      end
+      attr_writer :attachments
+
       # Delivery channel. Use 'auto' for intelligent routing. If omitted with non-text
       # messageType, WhatsApp is used. For email recipients, defaults to 'email'.
       sig { returns(T.nilable(Zavudev::Channel::OrSymbol)) }
@@ -106,6 +120,7 @@ module Zavudev
       sig do
         params(
           to: String,
+          attachments: T::Array[Zavudev::MessageSendParams::Attachment::OrHash],
           channel: Zavudev::Channel::OrSymbol,
           content: Zavudev::MessageContent::OrHash,
           fallback_enabled: T::Boolean,
@@ -125,6 +140,9 @@ module Zavudev
         # Recipient phone number in E.164 format, email address, or numeric chat ID (for
         # Telegram/Instagram).
         to:,
+        # Email attachments. Only supported when channel is 'email'. Maximum 40MB total
+        # size.
+        attachments: nil,
         # Delivery channel. Use 'auto' for intelligent routing. If omitted with non-text
         # messageType, WhatsApp is used. For email recipients, defaults to 'email'.
         channel: nil,
@@ -160,6 +178,7 @@ module Zavudev
         override.returns(
           {
             to: String,
+            attachments: T::Array[Zavudev::MessageSendParams::Attachment],
             channel: Zavudev::Channel::OrSymbol,
             content: Zavudev::MessageContent,
             fallback_enabled: T::Boolean,
@@ -178,6 +197,88 @@ module Zavudev
       end
       def to_hash
       end
+
+      class Attachment < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::MessageSendParams::Attachment,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        # Name of the attached file.
+        sig { returns(String) }
+        attr_accessor :filename
+
+        # Content of the attached file as a Base64-encoded string.
+        sig { returns(T.nilable(String)) }
+        attr_reader :content
+
+        sig { params(content: String).void }
+        attr_writer :content
+
+        # Content ID for inline images. Reference in HTML as
+        # `<img src="cid:your_content_id">`.
+        sig { returns(T.nilable(String)) }
+        attr_reader :content_id
+
+        sig { params(content_id: String).void }
+        attr_writer :content_id
+
+        # MIME type of the attachment. If not set, will be derived from the filename.
+        sig { returns(T.nilable(String)) }
+        attr_reader :content_type
+
+        sig { params(content_type: String).void }
+        attr_writer :content_type
+
+        # URL where the attachment file is hosted. The server will fetch the file.
+        sig { returns(T.nilable(String)) }
+        attr_reader :path
+
+        sig { params(path: String).void }
+        attr_writer :path
+
+        # Email attachment. Provide either `content` (base64) or `path` (URL), not both.
+        sig do
+          params(
+            filename: String,
+            content: String,
+            content_id: String,
+            content_type: String,
+            path: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Name of the attached file.
+          filename:,
+          # Content of the attached file as a Base64-encoded string.
+          content: nil,
+          # Content ID for inline images. Reference in HTML as
+          # `<img src="cid:your_content_id">`.
+          content_id: nil,
+          # MIME type of the attachment. If not set, will be derived from the filename.
+          content_type: nil,
+          # URL where the attachment file is hosted. The server will fetch the file.
+          path: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              filename: String,
+              content: String,
+              content_id: String,
+              content_type: String,
+              path: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/zavudev/models/webhook_event.rbi

@@ -30,6 +30,11 @@ module Zavudev
     #
     # - `conversation.new`: New conversation started with a contact
     # - `template.status_changed`: WhatsApp template approval status changed
+    #
+    # **Partner events:**
+    #
+    # - `invitation.status_changed`: A partner invitation status changed (pending,
+    #   in_progress, completed, cancelled)
     module WebhookEvent
       extend Zavudev::Internal::Type::Enum
 
@@ -54,6 +59,8 @@ module Zavudev
         T.let(:"conversation.new", Zavudev::WebhookEvent::TaggedSymbol)
       TEMPLATE_STATUS_CHANGED =
         T.let(:"template.status_changed", Zavudev::WebhookEvent::TaggedSymbol)
+      INVITATION_STATUS_CHANGED =
+        T.let(:"invitation.status_changed", Zavudev::WebhookEvent::TaggedSymbol)
 
       sig { override.returns(T::Array[Zavudev::WebhookEvent::TaggedSymbol]) }
       def self.values

data/rbi/zavudev/resources/messages.rbi

@@ -77,6 +77,7 @@ module Zavudev
       sig do
         params(
           to: String,
+          attachments: T::Array[Zavudev::MessageSendParams::Attachment::OrHash],
           channel: Zavudev::Channel::OrSymbol,
           content: Zavudev::MessageContent::OrHash,
           fallback_enabled: T::Boolean,
@@ -96,6 +97,9 @@ module Zavudev
         # Body param: Recipient phone number in E.164 format, email address, or numeric
         # chat ID (for Telegram/Instagram).
         to:,
+        # Body param: Email attachments. Only supported when channel is 'email'. Maximum
+        # 40MB total size.
+        attachments: nil,
         # Body param: Delivery channel. Use 'auto' for intelligent routing. If omitted
         # with non-text messageType, WhatsApp is used. For email recipients, defaults to
         # 'email'.

data/sig/zavudev/internal/util.rbs

@@ -45,8 +45,12 @@ module Zavudev
         -> top?
       } -> top?
 
+      RFC_3986_NOT_PCHARS: Regexp
+
       def self?.uri_origin: (URI::Generic uri) -> String
 
+      def self?.encode_path: (String | Integer path) -> String
+
       def self?.interpolate_path: (String | ::Array[String] path) -> String
 
       def self?.decode_query: (String? query) -> ::Hash[String, ::Array[String]]

data/sig/zavudev/models/message_send_params.rbs

@@ -3,6 +3,7 @@ module Zavudev
     type message_send_params =
       {
         to: String,
+        attachments: ::Array[Zavudev::MessageSendParams::Attachment],
         channel: Zavudev::Models::channel,
         content: Zavudev::MessageContent,
         fallback_enabled: bool,
@@ -24,6 +25,12 @@ module Zavudev
 
       attr_accessor to: String
 
+      attr_reader attachments: ::Array[Zavudev::MessageSendParams::Attachment]?
+
+      def attachments=: (
+        ::Array[Zavudev::MessageSendParams::Attachment]
+      ) -> ::Array[Zavudev::MessageSendParams::Attachment]
+
       attr_reader channel: Zavudev::Models::channel?
 
       def channel=: (Zavudev::Models::channel) -> Zavudev::Models::channel
@@ -76,6 +83,7 @@ module Zavudev
 
       def initialize: (
         to: String,
+        ?attachments: ::Array[Zavudev::MessageSendParams::Attachment],
         ?channel: Zavudev::Models::channel,
         ?content: Zavudev::MessageContent,
         ?fallback_enabled: bool,
@@ -93,6 +101,7 @@ module Zavudev
 
       def to_hash: -> {
         to: String,
+        attachments: ::Array[Zavudev::MessageSendParams::Attachment],
         channel: Zavudev::Models::channel,
         content: Zavudev::MessageContent,
         fallback_enabled: bool,
@@ -107,6 +116,51 @@ module Zavudev
         zavu_sender: String,
         request_options: Zavudev::RequestOptions
       }
+
+      type attachment =
+        {
+          filename: String,
+          content: String,
+          content_id: String,
+          content_type: String,
+          path: String
+        }
+
+      class Attachment < Zavudev::Internal::Type::BaseModel
+        attr_accessor filename: String
+
+        attr_reader content: String?
+
+        def content=: (String) -> String
+
+        attr_reader content_id: String?
+
+        def content_id=: (String) -> String
+
+        attr_reader content_type: String?
+
+        def content_type=: (String) -> String
+
+        attr_reader path: String?
+
+        def path=: (String) -> String
+
+        def initialize: (
+          filename: String,
+          ?content: String,
+          ?content_id: String,
+          ?content_type: String,
+          ?path: String
+        ) -> void
+
+        def to_hash: -> {
+          filename: String,
+          content: String,
+          content_id: String,
+          content_type: String,
+          path: String
+        }
+      end
     end
   end
 end

data/sig/zavudev/models/webhook_event.rbs

@@ -11,6 +11,7 @@ module Zavudev
       | :"broadcast.status_changed"
       | :"conversation.new"
       | :"template.status_changed"
+      | :"invitation.status_changed"
 
     module WebhookEvent
       extend Zavudev::Internal::Type::Enum
@@ -25,6 +26,7 @@ module Zavudev
       BROADCAST_STATUS_CHANGED: :"broadcast.status_changed"
       CONVERSATION_NEW: :"conversation.new"
       TEMPLATE_STATUS_CHANGED: :"template.status_changed"
+      INVITATION_STATUS_CHANGED: :"invitation.status_changed"
 
       def self?.values: -> ::Array[Zavudev::Models::webhook_event]
     end

data/sig/zavudev/resources/messages.rbs

@@ -24,6 +24,7 @@ module Zavudev
 
       def send_: (
         to: String,
+        ?attachments: ::Array[Zavudev::MessageSendParams::Attachment],
         ?channel: Zavudev::Models::channel,
         ?content: Zavudev::MessageContent,
         ?fallback_enabled: bool,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zavudev
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Zavudev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-26 00:00:00.000000000 Z
+date: 2026-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi