sendmux-sending 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93f7898501dac6b038c2b64530535627dd8b3178f2434a5e48cf1b99c4473561
-  data.tar.gz: 4eeb6992dd17fef37619abfec88e608d9d58ab1766d66c959ddd8fb4fddfef4b
+  metadata.gz: 195959762d9b4fe1a794ad4b40bde49927733d5bf6bbbe751ff7975a74a3be4b
+  data.tar.gz: 0b4e725dd8a434917954bd0d0bddc0232e58f7596c6e3fada3ff404f98a017d0
 SHA512:
-  metadata.gz: 43ebf3cd892bbd8b1a0f888e91601f825c996792d4e0958574b70d0fcfc7f5879af8dcf6217f98b88c7758053c76d9e8e1ab31dcd47ab3229f5408d0df4012f6
-  data.tar.gz: 77cd109cdaa57e393ab4f607fa402cb2dc52c2cf7b1b4c51ca54e079c7f1116070ab5f6396947f173669494c69dfb70cb6c65aa79c5236ea147b024234345e47
+  metadata.gz: d14fc7657e5a681d1624acf5fa069f04d795435c6f6422662d0e4e25f2a2598d7dfe049c35deda0262ab0fca4e1f15a6610fe06bc737d7090aa8d657c5bbd377
+  data.tar.gz: 0d415c60df2619d31805dbc5b9aebe0580feaa47b12d6ae9e3e81826e3f5044054fb46423489f2f18f39473207cbf2c89556eb3ec7a66651c4893b231f577c02

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.4.0](https://github.com/Sendmux/sendmux-sdk/compare/ruby-sending/v1.3.0...ruby-sending/v1.4.0) (2026-09-10)
+
+
+### Features
+
+* add REST OAuth clients and CLI token lifecycle ([cc4a3aa](https://github.com/Sendmux/sendmux-sdk/commit/cc4a3aa6110378641418a94455ed5b9a986e65ff))
+
 ## [1.3.0](https://github.com/Sendmux/sendmux-sdk/compare/ruby-sending/v1.2.0...ruby-sending/v1.3.0) (2026-09-08)
 
 

data/README.md

@@ -18,6 +18,8 @@ Ruby SDK package for the Sendmux Sending API.
 - Ruby 3.1 or newer.
 - A send-capable `smx_mbx_` key or owner-approved Sending-resource `smx_agent_` token.
 
+For OAuth, use a REST access token with the scopes and mailbox access required by the operation. See [OAuth for REST APIs](https://sendmux.ai/docs/developer-tools/oauth).
+
 ## Installation
 
 ```sh
@@ -30,9 +32,21 @@ Or add it to your Gemfile:
 gem "sendmux-sending", "~> 1.0"
 ```
 
+## OAuth access tokens
+
+Pass either `api_key:` or `access_token:`. `access_token:` accepts a bare token string or a callable; the callable is evaluated once per authenticated request. Your application owns token storage, expiry checks and refresh coordination.
+
+```ruby
+require "sendmux/sending"
+
+client = Sendmux::Sending::Client.new(
+  access_token: -> { ENV.fetch("SENDMUX_ACCESS_TOKEN") }
+)
+```
+
 ## Usage
 
-Create a sending client with a send-capable key before calling generated operations.
+Create a sending client with a send-capable key for the API-key example below.
 
 ```ruby
 require "sendmux/sending"

data/lib/sendmux/sending/client.rb

@@ -5,6 +5,12 @@ module Sendmux
     DEFAULT_BASE_URL = 'https://smtp.sendmux.ai/api/v1'
 
     class ApiClient < Generated::ApiClient
+      def update_params_for_auth!(header_params, query_params, auth_names)
+        return super unless config.access_token_getter && !Array(auth_names).empty?
+
+        header_params['Authorization'] = "Bearer #{config.access_token_with_refresh}"
+      end
+
       def call_api(...)
         super
       rescue Generated::ApiError => e
@@ -15,12 +21,13 @@ module Sendmux
     class Client
       attr_reader :api_client, :configuration
 
-      def initialize(api_key:, base_url: DEFAULT_BASE_URL, retry_options: nil)
+      def initialize(api_key: nil, access_token: nil, base_url: DEFAULT_BASE_URL, retry_options: nil)
         @configuration = Sendmux::Core::Auth.configure_bearer(
           Generated::Configuration.new,
           api_key,
           Sendmux::Core::ApiKeySurface::SENDING,
-          base_url: base_url
+          base_url: base_url,
+          access_token: access_token
         )
         Sendmux::Core::Retry.configure(@configuration, retry_options)
         @api_client = ApiClient.new(@configuration)

data/lib/sendmux/sending/version.rb

@@ -2,6 +2,6 @@
 
 module Sendmux
   module Sending
-    VERSION = '1.3.0'
+    VERSION = '1.4.0'
   end
 end

data/lib/sendmux_sending_generated/api/attachments_api.rb

@@ -172,7 +172,7 @@ module Sendmux::Sending::Generated
       return_type = opts[:debug_return_type] || 'AttachmentUploadIntentResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['BearerAuth']
+      auth_names = opts[:debug_auth_names] || ['OAuth2', 'BearerAuth']
 
       new_options = opts.merge(
         :operation => :"AttachmentsApi.sending_create_attachment_upload",
@@ -240,7 +240,7 @@ module Sendmux::Sending::Generated
       return_type = opts[:debug_return_type] || 'AttachmentUploadResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['BearerAuth']
+      auth_names = opts[:debug_auth_names] || ['OAuth2', 'BearerAuth']
 
       new_options = opts.merge(
         :operation => :"AttachmentsApi.sending_get_attachment",
@@ -348,7 +348,7 @@ module Sendmux::Sending::Generated
       return_type = opts[:debug_return_type] || 'AttachmentUploadResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['BearerAuth']
+      auth_names = opts[:debug_auth_names] || ['OAuth2', 'BearerAuth']
 
       new_options = opts.merge(
         :operation => :"AttachmentsApi.sending_upload_attachment",

data/lib/sendmux_sending_generated/api/emails_api.rb

@@ -75,7 +75,7 @@ module Sendmux::Sending::Generated
       return_type = opts[:debug_return_type] || 'SendSuccessResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['BearerAuth']
+      auth_names = opts[:debug_auth_names] || ['OAuth2', 'BearerAuth']
 
       new_options = opts.merge(
         :operation => :"EmailsApi.sending_send_email",
@@ -150,7 +150,7 @@ module Sendmux::Sending::Generated
       return_type = opts[:debug_return_type] || 'BatchSendSuccessResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['BearerAuth']
+      auth_names = opts[:debug_auth_names] || ['OAuth2', 'BearerAuth']
 
       new_options = opts.merge(
         :operation => :"EmailsApi.sending_send_email_batch",

data/lib/sendmux_sending_generated/api/meta_api.rb

@@ -60,7 +60,7 @@ module Sendmux::Sending::Generated
       return_type = opts[:debug_return_type] || 'ConnectionResponse'
 
       # auth_names
-      auth_names = opts[:debug_auth_names] || ['BearerAuth']
+      auth_names = opts[:debug_auth_names] || ['OAuth2', 'BearerAuth']
 
       new_options = opts.merge(
         :operation => :"MetaApi.sending_get_connection",

data/lib/sendmux_sending_generated/configuration.rb

@@ -255,6 +255,13 @@ module Sendmux::Sending::Generated
             key: 'Authorization',
             value: "Bearer #{access_token_with_refresh}"
           },
+        'OAuth2' =>
+          {
+            type: 'oauth2',
+            in: 'header',
+            key: 'Authorization',
+            value: "Bearer #{access_token_with_refresh}"
+          },
       }
     end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: sendmux-sending
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Sendmux
 bindir: bin
 cert_chain: []
-date: 2026-09-08 00:00:00.000000000 Z
+date: 2026-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -77,7 +77,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: 1.3.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2.0'
@@ -87,7 +87,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: 1.3.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2.0'