mailinator_client 1.0.7 → 1.1.1

data/lib/mailinator_client/webhooks.rb

@@ -29,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/mailinator_client.gemspec

@@ -15,11 +15,12 @@ Gem::Specification.new do |gem|
   gem.version       = MailinatorClient::VERSION
   gem.licenses      = ["MIT"]
 
-  gem.required_ruby_version = ">= 2.1"
+  gem.required_ruby_version = ">= 2.7"
 
-  gem.add_dependency "httparty", ">= 0.21", "< 0.22"
+  gem.add_dependency "httparty", ">= 0.24", "< 0.25"
 
-  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"
+  gem.add_development_dependency "addressable", ">= 2.9", "< 3.0"
+  gem.add_development_dependency "minitest", ">= 5.26", "< 6.0"
+  gem.add_development_dependency "rake", ">= 13.4", "< 14.0"
+  gem.add_development_dependency "webmock", ">= 3.26.2", "< 4.0"
 end

data/test/messages_api_test.rb

@@ -1,136 +1,274 @@
 require File.expand_path(File.dirname(__FILE__) + "/test_helper")
 
 class MessagesApiTest < Minitest::Test
-  def test_messages_endpoints
-    require_env!(
-      "MAILINATOR_TEST_API_TOKEN",
-      "MAILINATOR_TEST_INBOX",
-      "MAILINATOR_TEST_PHONE_NUMBER",
-      "MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID",
-      "MAILINATOR_TEST_ATTACHMENT_ID"
-    )
+  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")
 
-    client = integration_client
-    domain_name = first_domain_name(client)
-    inbox_all = "*"
+    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!"
+      }
+    )
 
-    message_to_post = {
-      subject: "Testing ruby message",
-      from: "test_email_ruby@test.com",
-      text: "I love Ruby!"
-    }
-    response = client.messages.post_message(domain: domain_name, inbox: inbox_all, messageToPost: message_to_post)
     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
+    )
 
-    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"
-    message = response["msgs"][0]
-    message_id = message["id"]
+  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
+    )
 
-    response = client.messages.fetch_inbox(domain: domain_name, inbox: inbox_all, limit: 1, cursor: response["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
+    )
 
-    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"
+    )
 
-    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
 
-    begin
-      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"
-    rescue MailinatorClient::ResponseError => e
-      if e.code >= 500
-        warn "Skipping wait query assertion due to server-side error (HTTP #{e.code})"
-      else
-        raise
-      end
-    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"
+    )
 
-    response = client.messages.fetch_inbox_message(domain: domain_name, inbox: inbox_all, messageId: message_id)
+    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)
+    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")
+    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"]
+    )
 
-    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,
+    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"])
+    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,
+    response = @client.messages.fetch_inbox_message_attachment(
+      domain: @domain_name,
       inbox: ENV["MAILINATOR_TEST_INBOX"],
       messageId: ENV["MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"],
-      attachmentId: ENV["MAILINATOR_TEST_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,
+    response = @client.messages.fetch_message_attachment(
+      domain: @domain_name,
       messageId: ENV["MAILINATOR_TEST_MESSAGE_WITH_ATTACHMENT_ID"],
-      attachmentId: ENV["MAILINATOR_TEST_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)
+    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)
+    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)
+    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)
+    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)
+    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
 
-    response = client.messages.fetch_message_raw(domain: domain_name, messageId: message_id)
+  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)
+    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
 
-    warn "Skipping legacy non-spec endpoints: messages.fetch_latest_messages / messages.fetch_latest_inbox_messages"
+  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"
-    else
-      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"
+      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

data/test/messages_query_params_test.rb

@@ -2,53 +2,75 @@ require File.expand_path(File.dirname(__FILE__) + "/test_helper")
 
 class MessagesQueryParamsTest < Minitest::Test
   def test_fetch_inbox_message_accepts_optional_delete
-    client = MailinatorClient::Client.new(auth_token: "test-token")
-    request = stub_request(:get, "https://api.mailinator.com/api/v2/domains/private.example/inboxes/inbox/messages/msg-123")
-      .with(query: { "delete" => "10s" })
-      .to_return(status: 200, body: "{}", headers: { "Content-Type" => "application/json" })
+    require_env!(
+      "MAILINATOR_TEST_API_TOKEN",
+      "MAILINATOR_TEST_INBOX"
+    )
 
-    response = client.messages.fetch_inbox_message(
-      domain: "private.example",
-      inbox: "inbox",
-      messageId: "msg-123",
-      delete: "10s"
+    client = integration_client
+    domain_name = ENV["MAILINATOR_TEST_DOMAIN"].to_s.strip
+    domain_name = first_domain_name(client) if domain_name.empty?
+
+    message_to_post = {
+      subject: "Query param delete test",
+      from: "test_email_ruby@test.com",
+      text: "Delete param integration test"
+    }
+    post_response = client.messages.post_message(
+      domain: domain_name,
+      inbox: "*",
+      messageToPost: message_to_post
     )
+    message_id = post_response["id"]
+    assert message_id != nil, "Expected posted message id to not be nil"
+
+    response = client.messages.fetch_inbox_message(
+      domain: domain_name,
+      inbox: "*",
+      messageId: message_id,
+      delete: "1m"
+    ) rescue begin
+      e = $!
+      if e.is_a?(MailinatorClient::ResponseError)
+        flunk "Expected HTTP 200 for fetch_inbox_message with delete param, got HTTP #{e.code}"
+      end
+      raise
+    end
 
-    assert_equal({}, response)
-    assert_requested(request, times: 1)
+    assert_kind_of(Hash, response, "Expected JSON object response for fetch_inbox_message")
+    returned_id = response["id"] || response["mrid"]
+    assert returned_id != nil, "Expected message id in fetch_inbox_message response"
+    assert_equal(message_id, returned_id, "Expected returned message id to match requested message id")
   end
 
   def test_fetch_sms_message_supports_inbox_list_query_params
-    client = MailinatorClient::Client.new(auth_token: "test-token")
-    request = stub_request(:get, "https://api.mailinator.com/api/v2/domains/private.example/inboxes/15555550123")
-      .with(
-        query: {
-          "skip" => "5",
-          "limit" => "10",
-          "sort" => "descending",
-          "decode_subject" => "true",
-          "cursor" => "cursor-1",
-          "full" => "true",
-          "delete" => "30s",
-          "wait" => "20s"
-        }
-      )
-      .to_return(status: 200, body: "{\"msgs\":[]}", headers: { "Content-Type" => "application/json" })
+    require_env!(
+      "MAILINATOR_TEST_API_TOKEN",
+      "MAILINATOR_TEST_PHONE_NUMBER"
+    )
+
+    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_sms_message(
-      domain: "private.example",
-      teamSmsNumber: "15555550123",
-      skip: 5,
+      domain: domain_name,
+      teamSmsNumber: ENV["MAILINATOR_TEST_PHONE_NUMBER"],
+      skip: 0,
       limit: 10,
       sort: "descending",
       decode_subject: true,
-      cursor: "cursor-1",
-      full: true,
-      delete: "30s",
-      wait: "20s"
-    )
+      full: false
+    ) rescue begin
+      e = $!
+      if e.is_a?(MailinatorClient::ResponseError)
+        flunk "Expected HTTP 200 for fetch_sms_message query params flow, got HTTP #{e.code}"
+      end
+      raise
+    end
 
-    assert_equal({ "msgs" => [] }, response)
-    assert_requested(request, times: 1)
+    assert_kind_of(Hash, response, "Expected JSON object response for fetch_sms_message")
+    assert response.key?("msgs"), "Expected msgs key in fetch_sms_message response"
+    assert_kind_of(Array, response["msgs"], "Expected msgs to be an array")
   end
 end

data/test/messages_stream_domain_api_test.rb

@@ -0,0 +1,39 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+require "timeout"
+
+class MessagesStreamDomainApiTest < Minitest::Test
+  def test_stream_domain_messages_endpoint
+    require_env!("MAILINATOR_TEST_API_TOKEN")
+
+    client = integration_client
+    domain_name = "private"
+
+    response = nil
+    # This test requires a real email to arrive while the stream is open.
+    stream_thread = Thread.new do
+      client.messages.stream_domain_messages(
+        domain: domain_name,
+        limit: 1,
+        throttleInterval: 1000
+      )
+    end
+
+    response = Timeout.timeout(20) do
+      stream_thread.value
+    end rescue begin
+      e = $!
+      if e.is_a?(Timeout::Error)
+        flunk "Expected stream domain messages to return within timeout"
+      end
+      if e.is_a?(MailinatorClient::ResponseError)
+        flunk "Expected HTTP 200 from stream domain messages endpoint, got HTTP #{e.code}"
+      end
+      raise
+    end
+
+    assert_kind_of(Hash, response, "Expected stream response to be a JSON object")
+    assert response.key?("domain"), "Expected response to include domain"
+    assert response.key?("to"), "Expected response to include to"
+    assert response.key?("msgs"), "Expected response to include msgs"
+  end
+end

data/test/messages_stream_inbox_api_test.rb

@@ -0,0 +1,40 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+require "timeout"
+
+class MessagesStreamInboxApiTest < Minitest::Test
+  def test_stream_inbox_messages_endpoint
+    require_env!("MAILINATOR_TEST_API_TOKEN", "MAILINATOR_TEST_INBOX")
+
+    client = integration_client
+    domain_name = "private"
+    inbox_name = ENV["MAILINATOR_TEST_INBOX"]
+
+    response = nil
+    # This test requires a real email to arrive while the stream is open.
+    stream_thread = Thread.new do
+      client.messages.stream_inbox_messages(
+        domain: domain_name,
+        inbox: inbox_name,
+        limit: 1,
+        throttleInterval: 1000
+      )
+    end
+
+    response = Timeout.timeout(20) do
+      stream_thread.value
+    end rescue begin
+      e = $!
+      if e.is_a?(Timeout::Error)
+        flunk "Expected stream inbox messages to return within timeout"
+      end
+      if e.is_a?(MailinatorClient::ResponseError)
+        flunk "Expected HTTP 200 from stream inbox messages endpoint, got HTTP #{e.code}"
+      end
+      raise
+    end
+
+    assert_kind_of(Hash, response, "Expected stream response to be a JSON object")
+    assert response.key?("to"), "Expected response to include to"
+    assert response.key?("msgs"), "Expected response to include msgs"
+  end
+end

data/test/messages_summary_api_test.rb

@@ -0,0 +1,28 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+class MessagesSummaryApiTest < Minitest::Test
+  def test_fetch_message_summary_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_summary(
+      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 summary endpoint, got HTTP #{e.code}"
+      end
+      raise
+    end
+
+    assert_kind_of(Hash, response, "Expected message summary endpoint to return a JSON object")
+    assert_equal(["summary"], response.keys.sort, "Expected only the summary property")
+  end
+end

data/test/messages_text_api_test.rb

@@ -0,0 +1,28 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+class MessagesTextApiTest < Minitest::Test
+  def test_fetch_message_text_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_text(
+      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 text endpoint, got HTTP #{e.code}"
+      end
+      raise
+    end
+
+    assert_kind_of(Hash, response, "Expected message text response to be a JSON object")
+    assert_equal(["text"], response.keys.sort, "Expected only the text property")
+  end
+end