mailinator_client 1.0.6 → 1.1.0

data/lib/mailinator_client/rules.rb

@@ -1,25 +1,3 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2024 Manybrain, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
 require "json"
 
 module MailinatorClient
@@ -31,6 +9,7 @@ module MailinatorClient
       @client = client
     end
 
+    # @deprecated Rules endpoints are deprecated in this client.
     # Creates a Rule. Note that in the examples, ":domain_id" can be one of your private domains.
     #
     # Authentication:
@@ -38,7 +17,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} ruleToPost - The Rule object (https://manybrain.github.io/m8rdocs/#create-rule)
     #
     # Responses:
@@ -64,6 +43,7 @@ module MailinatorClient
         body: body)
     end
 
+    # @deprecated Rules endpoints are deprecated in this client.
     # Enables an existing Rule
     #
     # Authentication:
@@ -71,7 +51,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} ruleId - The Rule id
     #
     # Responses:
@@ -95,6 +75,7 @@ module MailinatorClient
         body: body)
     end
 
+    # @deprecated Rules endpoints are deprecated in this client.
     # Disables an existing Rule
     #
     # Authentication:
@@ -102,7 +83,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} ruleId - The Rule id
     #
     # Responses:
@@ -126,6 +107,7 @@ module MailinatorClient
         body: body)
     end
 
+    # @deprecated Rules endpoints are deprecated in this client.
     # Fetches all Rules for a Domain.
     #
     # Authentication:
@@ -133,7 +115,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     #
     # Responses:
     # *  Collection of rules (https://manybrain.github.io/m8rdocs/#get-all-rules)
@@ -155,6 +137,7 @@ module MailinatorClient
         body: body)
     end
 
+    # @deprecated Rules endpoints are deprecated in this client.
     # Fetches a specific rule for a Domain.
     #
     # Authentication:
@@ -162,7 +145,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} ruleId - The Domain name or the Rule id
     #
     # Responses:
@@ -186,6 +169,7 @@ module MailinatorClient
         body: body)
     end
 
+    # @deprecated Rules endpoints are deprecated in this client.
     # Deletes a specific rule for a Domain.
     #
     # Authentication:
@@ -193,7 +177,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} ruleId - The Rule id
     #
     # Responses:

data/lib/mailinator_client/stats.rb

@@ -1,25 +1,3 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2024 Manybrain, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
 require "json"
 
 module MailinatorClient

data/lib/mailinator_client/utils.rb

@@ -1,25 +1,3 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2024 Manybrain, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
 module MailinatorClient
   class Utils
     def self.symbolize_hash_keys(hash)

data/lib/mailinator_client/version.rb

@@ -1,25 +1,3 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2024 Manybrain, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
-module MailinatorClient
-  VERSION = "1.0.6"
-end
+module MailinatorClient
+  VERSION = "1.1.0"
+end

data/lib/mailinator_client/webhooks.rb

@@ -1,25 +1,3 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2024 Manybrain, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
 require "json"
 
 module MailinatorClient
@@ -51,6 +29,7 @@ module MailinatorClient
       raise ArgumentError.new("whToken is required") unless params.has_key?(:whToken)
       raise ArgumentError.new("webhook is required") unless params.has_key?(:webhook)
       
+      body = params[:webhook] if params.has_key?(:webhook)
       query_params[:whtoken] = params[:whToken] if params.has_key?(:whToken)
 
       path = "/domains/private/webhook"

data/lib/mailinator_client.rb

@@ -1,25 +1,3 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2024 Manybrain, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
 require_relative "mailinator_client/version"
 require_relative "mailinator_client/error"
 require_relative "mailinator_client/utils"

data/mailinator_client.gemspec

@@ -1,25 +1,25 @@
-$LOAD_PATH.push(File.expand_path("../lib", __FILE__))
-require "mailinator_client/version"
-
-Gem::Specification.new do |gem|
-  gem.name          = "mailinator_client"
-  gem.authors       = ["Marian Melnychuk"]
-  gem.email         = ["marian.melnychuk@gmail.com"]
-  gem.summary       = %q{Provides a simple ruby wrapper around the Mailinator REST API}
-  gem.description   = %q{Easily use the Mailinator through its REST API with Ruby}
-  gem.homepage      = "https://github.com/manybrain/mailinator-ruby-client"
-  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  gem.files         = `git ls-files`.split("\n")
-  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  gem.require_paths = ["lib"]
-  gem.version       = MailinatorClient::VERSION
-  gem.licenses      = ["MIT"]
-
-  gem.required_ruby_version = ">= 2.1"
-
-  gem.add_dependency "httparty", "~> 0.21.0"
-
-  gem.add_development_dependency "minitest", "~> 5.9"
-  gem.add_development_dependency "rake", "~> 12"
-  gem.add_development_dependency "webmock", "~> 2.3"
-end
+$LOAD_PATH.push(File.expand_path("../lib", __FILE__))
+require "mailinator_client/version"
+
+Gem::Specification.new do |gem|
+  gem.name          = "mailinator_client"
+  gem.authors       = ["Manybrain, LLC"]
+  gem.email         = ["support@manybrain.com"]
+  gem.summary       = %q{Provides a simple ruby wrapper around the Mailinator REST API}
+  gem.description   = %q{Easily use the Mailinator through its REST API with Ruby}
+  gem.homepage      = "https://github.com/manybrain/mailinator-ruby-client"
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.require_paths = ["lib"]
+  gem.version       = MailinatorClient::VERSION
+  gem.licenses      = ["MIT"]
+
+  gem.required_ruby_version = ">= 2.1"
+
+  gem.add_dependency "httparty", ">= 0.21", "< 0.22"
+
+  gem.add_development_dependency "minitest", ">= 5.25", "< 7.0"
+  gem.add_development_dependency "rake", ">= 13.0", "< 14.0"
+  gem.add_development_dependency "webmock", ">= 3.26", "< 4.0"
+end

data/test/authenticators_api_test.rb

@@ -0,0 +1,28 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+class AuthenticatorsApiTest < Minitest::Test
+  def test_authenticators_endpoints
+    require_env!(
+      "MAILINATOR_TEST_API_TOKEN",
+      "MAILINATOR_TEST_AUTH_SECRET",
+      "MAILINATOR_TEST_AUTH_ID"
+    )
+
+    client = integration_client
+
+    response = client.authenticators.instant_totp_2fa_code(totpSecretKey: ENV["MAILINATOR_TEST_AUTH_SECRET"])
+    assert response != nil, "Expected instant totp 2fa code response to not be nil"
+
+    response = client.authenticators.get_authenticators()
+    assert response != nil, "Expected get authenticators response to not be nil"
+
+    response = client.authenticators.get_authenticators_by_id(id: ENV["MAILINATOR_TEST_AUTH_ID"])
+    assert response != nil, "Expected get authenticators by id response to not be nil"
+
+    response = client.authenticators.get_authenticator()
+    assert response != nil, "Expected get authenticator response to not be nil"
+
+    response = client.authenticators.get_authenticator_by_id(id: ENV["MAILINATOR_TEST_AUTH_ID"])
+    assert response != nil, "Expected get authenticator by id response to not be nil"
+  end
+end

data/test/domains_api_test.rb

@@ -0,0 +1,15 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+class DomainsApiTest < Minitest::Test
+  def test_domains_endpoints
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    client = integration_client
+    domain_name = first_domain_name(client)
+
+    response = client.domains.get_domain(domainId: domain_name)
+    assert response != nil, "Expected get domain response to not be nil"
+
+    skip("Skipping deprecated endpoints: domains.create_domain / domains.delete_domain")
+  end
+end

data/test/messages_api_test.rb

@@ -0,0 +1,274 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+class MessagesApiTest < Minitest::Test
+  def setup
+    super
+    @client = integration_client
+    @domain_name = first_domain_name(@client)
+    @inbox_all = "*"
+  end
+
+  def test_post_message_seed
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.post_message(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      messageToPost: {
+        subject: "Testing ruby message",
+        from: "test_email_ruby@test.com",
+        text: "I love Ruby!"
+      }
+    )
+
+    assert response != nil, "Expected post message response to not be nil"
+    assert response["status"] == "ok", "Expected post message response to be ok"
+  end
+
+  def test_fetch_inbox_basic
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      skip: 0,
+      limit: 1,
+      sort: "ascending",
+      decodeSubject: false
+    )
+
+    assert response != nil, "Expected fetch inbox response to not be nil"
+    assert response["msgs"] != nil, "Expected response fetch inbox messages to not be nil"
+  end
+
+  def test_fetch_inbox_cursor
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      skip: 0,
+      limit: 1,
+      sort: "ascending",
+      decodeSubject: false
+    )
+    cursor = response["cursor"]
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      limit: 1,
+      cursor: cursor
+    )
+
+    assert response != nil, "Expected fetch inbox response to not be nil"
+    assert response["msgs"] != nil, "Expected response fetch inbox messages to not be nil"
+  end
+
+  def test_fetch_inbox_full
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      limit: 1,
+      full: true
+    )
+
+    assert response != nil, "Expected fetch inbox response to not be nil"
+    assert response["msgs"] != nil, "Expected response fetch inbox messages to not be nil"
+  end
+
+  def test_fetch_inbox_delete
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      limit: 1,
+      delete: "1m"
+    )
+
+    assert response != nil, "Expected fetch inbox response to not be nil"
+    assert response["msgs"] != nil, "Expected response fetch inbox messages to not be nil"
+  end
+
+  def test_fetch_inbox_wait
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      limit: 1,
+      wait: "1m"
+    )
+
+    assert response != nil, "Expected fetch inbox response to not be nil"
+    assert response["msgs"] != nil, "Expected response fetch inbox messages to not be nil"
+  end
+
+  def test_fetch_message_variants
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      skip: 0,
+      limit: 1,
+      sort: "ascending",
+      decodeSubject: false
+    )
+    message_id = response["msgs"][0]["id"]
+
+    response = @client.messages.fetch_inbox_message(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      messageId: message_id
+    )
+    assert response != nil, "Expected fetch inbox message response to not be nil"
+
+    response = @client.messages.fetch_message(domain: @domain_name, messageId: message_id)
+    assert response != nil, "Expected fetch message response to not be nil"
+
+    response = @client.messages.fetch_message(domain: @domain_name, messageId: message_id, delete: "10s")
+    assert response != nil, "Expected fetch message response to not be nil"
+  end
+
+  def test_fetch_sms_message
+    require_env!("MAILINATOR_TEST_API_TOKEN", "MAILINATOR_TEST_PHONE_NUMBER")
+
+    response = @client.messages.fetch_sms_message(
+      domain: @domain_name,
+      teamSmsNumber: ENV["MAILINATOR_TEST_PHONE_NUMBER"]
+    )
+
+    assert response != nil, "Expected fetch sms message response to not be nil"
+  end
+
+  def test_attachment_list_and_download
+    require_env!(
+      "MAILINATOR_TEST_API_TOKEN",
+      "MAILINATOR_TEST_INBOX",
+      "MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"
+    )
+
+    response = @client.messages.fetch_inbox_message_attachments(
+      domain: @domain_name,
+      inbox: ENV["MAILINATOR_TEST_INBOX"],
+      messageId: ENV["MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"]
+    )
+    assert response != nil, "Expected fetch inbox message attachments response to not be nil"
+    attachments = response["attachments"]
+    assert attachments != nil, "Expected attachments list in fetch inbox message attachments response"
+    assert_kind_of(Array, attachments, "Expected attachments to be an array")
+    assert !attachments.empty?, "Expected at least one attachment for MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"
+    attachment = attachments[0]
+    attachment_id = attachment["id"] || attachment["attachmentId"] || attachment["attachment_id"] || attachment["name"] || attachment["filename"]
+    assert attachment_id != nil, "Expected attachment to include an id or name field"
+
+    response = @client.messages.fetch_message_attachments(
+      domain: @domain_name,
+      messageId: ENV["MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"]
+    )
+    assert response != nil, "Expected fetch message attachments response to not be nil"
+
+    response = @client.messages.fetch_inbox_message_attachment(
+      domain: @domain_name,
+      inbox: ENV["MAILINATOR_TEST_INBOX"],
+      messageId: ENV["MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"],
+      attachmentId: attachment_id
+    )
+    assert response != nil, "Expected fetch inbox message attachment response to not be nil"
+
+    response = @client.messages.fetch_message_attachment(
+      domain: @domain_name,
+      messageId: ENV["MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"],
+      attachmentId: attachment_id
+    )
+    assert response != nil, "Expected fetch message attachment response to not be nil"
+  end
+
+  def test_links_and_logs
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      skip: 0,
+      limit: 1,
+      sort: "ascending",
+      decodeSubject: false
+    )
+    message_id = response["msgs"][0]["id"]
+
+    response = @client.messages.fetch_message_links_full(domain: @domain_name, messageId: message_id)
+    assert response != nil, "Expected fetch message links full response to not be nil"
+    assert response["links"] != nil, "Expected fetch message links links full response to not be nil"
+
+    response = @client.messages.fetch_message_links(domain: @domain_name, messageId: message_id)
+    assert response != nil, "Expected fetch message links response to not be nil"
+    assert response["links"] != nil, "Expected fetch message links links response to not be nil"
+
+    response = @client.messages.fetch_inbox_message_links(domain: @domain_name, inbox: @inbox_all, messageId: message_id)
+    assert response != nil, "Expected fetch inbox message links response to not be nil"
+    assert response["links"] != nil, "Expected fetch inbox message links links response to not be nil"
+
+    response = @client.messages.fetch_message_smtp_log(domain: @domain_name, messageId: message_id)
+    assert response != nil, "Expected fetch message smtp log response to not be nil"
+
+    response = @client.messages.fetch_inbox_message_smtp_log(domain: @domain_name, inbox: @inbox_all, messageId: message_id)
+    assert response != nil, "Expected fetch inbox message smtp log response to not be nil"
+  end
+
+  def test_raw_message_variants
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      skip: 0,
+      limit: 1,
+      sort: "ascending",
+      decodeSubject: false
+    )
+    message_id = response["msgs"][0]["id"]
+
+    response = @client.messages.fetch_message_raw(domain: @domain_name, messageId: message_id)
+    assert response != nil, "Expected fetch message raw response to not be nil"
+
+    response = @client.messages.fetch_inbox_message_raw(domain: @domain_name, inbox: @inbox_all, messageId: message_id)
+    assert response != nil, "Expected fetch inbox message raw response to not be nil"
+  end
+
+  def test_delete_domain_flows
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    delete_domain = ENV["MAILINATOR_TEST_DELETE_DOMAIN"]
+    if delete_domain.to_s.strip.empty?
+      warn "Skipping delete-domain checks: MAILINATOR_TEST_DELETE_DOMAIN is not set"
+      return
+    end
+
+    response = @client.messages.fetch_inbox(
+      domain: @domain_name,
+      inbox: @inbox_all,
+      skip: 0,
+      limit: 1,
+      sort: "ascending",
+      decodeSubject: false
+    )
+    message_id = response["msgs"][0]["id"]
+
+    response = @client.messages.delete_message(domain: delete_domain, inbox: ENV["MAILINATOR_TEST_INBOX"], messageId: message_id)
+    assert response != nil, "Expected delete message response to not be nil"
+    assert response["status"] == "ok", "Expected delete message response to be ok"
+
+    response = @client.messages.delete_all_inbox_messages(domain: delete_domain, inbox: ENV["MAILINATOR_TEST_INBOX"])
+    assert response != nil, "Expected delete all inbox messages response to not be nil"
+    assert response["status"] == "ok", "Expected delete all inbox messages response to be ok"
+
+    response = @client.messages.delete_all_domain_messages(domain: delete_domain)
+    assert response != nil, "Expected delete all domain messages response to not be nil"
+    assert response["status"] == "ok", "Expected delete all domain messages response to be ok"
+  end
+end

data/test/messages_headers_api_test.rb

@@ -0,0 +1,30 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+class MessagesHeadersApiTest < Minitest::Test
+  def test_fetch_message_headers_endpoint
+    require_env!(
+      "MAILINATOR_TEST_API_TOKEN",
+      "MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"
+    )
+
+    client = integration_client
+    domain_name = ENV["MAILINATOR_TEST_DOMAIN"].to_s.strip
+    domain_name = first_domain_name(client) if domain_name.empty?
+
+    response = client.messages.fetch_message_headers(
+      domain: domain_name,
+      messageId: ENV["MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"]
+    ) rescue begin
+      e = $!
+      if e.is_a?(MailinatorClient::ResponseError)
+        flunk "Expected HTTP 200 from message headers endpoint, got HTTP #{e.code}"
+      end
+      raise
+    end
+
+    assert_kind_of(Hash, response, "Expected message headers response to be a JSON object")
+    assert_equal(["headers"], response.keys.sort, "Expected only the headers property")
+    assert response["headers"].is_a?(Hash), "Expected headers to be a JSON object"
+    assert response["headers"]["subject"] != nil, "Expected headers.subject to not be nil"
+  end
+end