mailtrap 2.4.2 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbab8dc3de2d25ab941149a0324bde111b57ce174a3b4d6c7f9233a2081edaf6
-  data.tar.gz: 2504ee84dc9fea519b8fef55c9adf9e160f28f2e400a28d9b228db0fb82a3bcf
+  metadata.gz: 38c84a79ba87b360caf02839703e51e1e1af2cb84092e03b995677805dd09c16
+  data.tar.gz: 2a6e502ff5876367d35ecc5907d4aaa3fd32689f342d6e91c3f54dd189cdcaea
 SHA512:
-  metadata.gz: 60f24be1ea02688b21315cd2b33c17b7ef09d5e11c2695f7f237c6fadac1bd0c9aa2458b74713f3ffb13421bc1d58237fd12b5b6a5a101be00e5530f9ebf86a5
-  data.tar.gz: 53e05d3a12c3f68cd5ade6cb844e3316902594be51aa85a624941ad7c501765bbf8302d985f6c9a27028034397a794281d4266d06580ffdb5b289d876c3ac28d
+  metadata.gz: 927ef7bb197ea1636462a5e926eb273d8703e383ddee5e66b578252cb6d51cc7cb1e2afba194c70186980d67d32488cf3115c529146a6fedb02a8a5b4f0ae699
+  data.tar.gz: abcba3b12d50ae4b292c6fcdfd5e4b1786dafbfe02dfbe20528662dd3f2fc12b6fd2b14bd53b7ab09082a51a006e58003c9d8a989616cc5827d14ee89263c32f

data/.rubocop.yml

@@ -1,4 +1,4 @@
-require:
+plugins:
   - rubocop-rake
   - rubocop-rspec
 

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+## [2.6.0] - 2026-01-27
+- Add Inboxes API
+- Add Projects API
+- Models' `to_h` now returns all fields without compacting
+
+## [2.5.0] - 2025-11-10
+- Add Contact Imports API
+- Add Suppressions API
+- Write the message IDs to the message when sending with Action Mailer
+- Fix versioning :)
+
 ## [2.4.1] - 2025-08-21
 - Set `template_uuid` and `template_variables` when building mail from `Mail::Message`
 

data/Gemfile

@@ -8,11 +8,11 @@ gem 'appraisal'
 gem 'irb'
 gem 'mail'
 gem 'net-smtp'
-gem 'rake', '~> 13.0'
-gem 'rdoc', '~> 6.13.0'
-gem 'rspec', '~> 3.0'
+gem 'rake', '~> 13.3'
+gem 'rdoc', '~> 7.1.0'
+gem 'rspec', '~> 3'
 gem 'rspec-its'
-gem 'rubocop', '~> 1.21'
+gem 'rubocop', '~> 1.82'
 gem 'rubocop-rake', require: false
 gem 'rubocop-rspec', require: false
 gem 'vcr'

data/Gemfile.lock

@@ -1,88 +1,93 @@
 PATH
   remote: .
   specs:
-    mailtrap (2.4.2)
+    mailtrap (2.6.0)
       base64
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
     appraisal (2.5.0)
       bundler
       rake
       thor (>= 0.14.0)
     ast (2.4.3)
     base64 (0.3.0)
-    bigdecimal (3.1.8)
-    crack (1.0.0)
+    bigdecimal (4.0.1)
+    crack (1.0.1)
       bigdecimal
       rexml
-    date (3.4.1)
-    diff-lcs (1.5.1)
-    hashdiff (1.1.0)
-    io-console (0.8.0)
-    irb (1.15.2)
+    date (3.5.1)
+    diff-lcs (1.6.2)
+    erb (6.0.1)
+    hashdiff (1.2.1)
+    io-console (0.8.2)
+    irb (1.16.0)
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.12.2)
+    json (2.18.0)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    mail (2.8.1)
+    logger (1.7.0)
+    mail (2.9.0)
+      logger
       mini_mime (>= 0.1.1)
       net-imap
       net-pop
       net-smtp
     mini_mime (1.1.5)
-    net-imap (0.5.7)
+    net-imap (0.6.2)
       date
       net-protocol
     net-pop (0.1.2)
       net-protocol
     net-protocol (0.2.2)
       timeout
-    net-smtp (0.5.0)
+    net-smtp (0.5.1)
       net-protocol
     parallel (1.27.0)
-    parser (3.3.8.0)
+    parser (3.3.10.1)
       ast (~> 2.4.1)
       racc
-    pp (0.6.2)
+    pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.4.0)
-    psych (5.2.6)
+    prism (1.9.0)
+    psych (5.3.1)
       date
       stringio
-    public_suffix (5.1.1)
+    public_suffix (7.0.2)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
-    rdoc (6.13.1)
+    rake (13.3.1)
+    rdoc (7.1.0)
+      erb
       psych (>= 4.0.0)
-    regexp_parser (2.10.0)
-    reline (0.6.1)
+      tsort
+    regexp_parser (2.11.3)
+    reline (0.6.3)
       io-console (~> 0.5)
-    rexml (3.4.2)
-    rspec (3.13.0)
+    rexml (3.4.4)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.1)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-its (1.3.0)
-      rspec-core (>= 3.0.0)
-      rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.13.1)
+    rspec-its (2.0.0)
+      rspec-core (>= 3.13.0)
+      rspec-expectations (>= 3.13.0)
+    rspec-mocks (3.13.7)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.78.0)
+    rspec-support (3.13.6)
+    rubocop (1.84.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -90,29 +95,32 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.45.1, < 2.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.45.1)
+    rubocop-ast (1.49.0)
       parser (>= 3.3.7.2)
-      prism (~> 1.4)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (3.0.2)
-      rubocop (~> 1.61)
+      prism (~> 1.7)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.9.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.81)
     ruby-progressbar (1.13.0)
-    stringio (3.1.7)
-    thor (1.4.0)
-    timeout (0.4.3)
-    unicode-display_width (3.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
-    vcr (6.2.0)
-    webmock (3.23.1)
+    stringio (3.2.0)
+    thor (1.5.0)
+    timeout (0.6.0)
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    vcr (6.4.0)
+    webmock (3.26.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.37)
+    yard (0.9.38)
 
 PLATFORMS
   ruby
@@ -123,11 +131,11 @@ DEPENDENCIES
   mail
   mailtrap!
   net-smtp
-  rake (~> 13.0)
-  rdoc (~> 6.13.0)
-  rspec (~> 3.0)
+  rake (~> 13.3)
+  rdoc (~> 7.1.0)
+  rspec (~> 3)
   rspec-its
-  rubocop (~> 1.21)
+  rubocop (~> 1.82)
   rubocop-rake
   rubocop-rspec
   vcr

data/README.md

@@ -1,17 +1,21 @@
+# Mailtrap Ruby client - Official
+
+![Ruby](https://img.shields.io/badge/Ruby-CC342D)
 [![test](https://github.com/mailtrap/mailtrap-ruby/actions/workflows/main.yml/badge.svg)](https://github.com/mailtrap/mailtrap-ruby/actions/workflows/main.yml)
 [![docs](https://shields.io/badge/docs-rubydoc.info-blue)](https://rubydoc.info/gems/mailtrap)
 [![gem](https://shields.io/gem/v/mailtrap)](https://rubygems.org/gems/mailtrap)
 [![downloads](https://shields.io/gem/dt/mailtrap)](https://rubygems.org/gems/mailtrap)
 
+This client uses API v2, for v1 refer to [this documentation](https://mailtrap.docs.apiary.io/)
 
 
-# Official Mailtrap Ruby client
+## Prerequisites
 
-This Ruby gem offers integration with the [official API](https://api-docs.mailtrap.io/) for [Mailtrap](https://mailtrap.io).
+To get the most out of this official Mailtrap.io Ruby SDK:
 
-Quickly add email sending functionality to your Ruby application with Mailtrap.
+- [Create a Mailtrap account](https://mailtrap.io/signup)
 
-(This client uses API v2, for v1 refer to [this documentation](https://mailtrap.docs.apiary.io/))
+- [Verify your domain](https://mailtrap.io/sending/domains)
 
 ## Installation
 
@@ -105,31 +109,27 @@ client.send_batch(
 )
 ```
 
-### Email Templates API
+### Sandbox Sending
+
+Send emails to your Sandbox for testing purposes:
 
 ```ruby
 require 'mailtrap'
 
-client = Mailtrap::Client.new(api_key: 'your-api-key')
-templates = Mailtrap::EmailTemplatesAPI.new 3229, client
-
-templates.create(
-  name: 'Welcome Email',
-  subject: 'Welcome to Mailtrap!',
-  body_html: '<h1>Hello</h1>',
-  body_text: 'Hello',
-  category: 'welcome'
+client = Mailtrap::Client.new(api_key: 'your-api-key', sandbox: true, inbox_id: YOUR_INBOX_ID)
+client.send(mail)
+
+# You can also pass the request parameters directly
+client.send(
+  from: { email: 'mailtrap@example.com', name: 'Mailtrap Test' },
+  to: [
+    { email: 'your@email.com' }
+  ],
+  subject: 'You are awesome!',
+  text: 'Congrats for sending test email with Mailtrap!'
 )
 ```
 
-Refer to the [`examples`](examples) folder for more examples:
-
-- [Full](examples/full.rb)
-- [Email template](examples/email_template.rb)
-- [Batch Sending](examples/batch.rb)
-- [ActionMailer](examples/action_mailer.rb)
-- [Email Templates API](examples/email_templates_api.rb)
-
 ### Content-Transfer-Encoding
 
 `mailtrap` gem uses Mailtrap API to send emails. Mailtrap API does not try to
@@ -148,7 +148,7 @@ configuration example.
 
 You can configure two Mailtrap clients to operate simultaneously. This setup is
 particularly useful when you need to send emails using both the transactional
-and bulk APIs. Refer to the configuration example below:
+and bulk APIs. Refer to the configuration examples below.
 
 ```ruby
 # config/application.rb
@@ -168,26 +168,60 @@ config.action_mailer.mailtrap_bulk_settings = {
 mail(delivery_method: :mailtrap_bulk)
 ```
 
+## Supported functionality & Examples
+
+Refer to the [`examples`](examples) folder for more examples:
+
+Email API:
+- Full email sending – [`full.rb`](examples/full.rb)
+
+- Batch sending – [`batch.rb`](examples/batch.rb)
+
+Email Sandbox (Testing):
+
+- Projects CRUD – [`projects_api.rb`](examples/projects_api.rb)
+- Inboxes CRUD - [`inboxes_api.rb`](examples/inboxes_api.rb)
+
+Contact management:
+
+- Contacts CRUD & listing – [`contacts_api.rb`](examples/contacts_api.rb)
+
+General API:
+
+- Templates CRUD – [`email_templates_api.rb`](examples/email_templates_api.rb)
+
+- Action Mailer – [`action_mailer.rb`](examples/action_mailer.rb)
+
 ## Migration guide v1 → v2
 
 Change `Mailtrap::Sending::Client` to `Mailtrap::Client`.
 
 If you use classes which have `Sending` namespace, remove the namespace like in the example above.
 
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/railsware/mailtrap-ruby). This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](CODE_OF_CONDUCT.md).
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`.
 
-## Contributing
+To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+All contributions are required to have rspec tests covering its functionality.
 
-Bug reports and pull requests are welcome on [GitHub](https://github.com/mailtrap/mailtrap-ruby). This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](CODE_OF_CONDUCT.md).
+Please be sure to update [README](README.md) with new examples and features when applicable.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The package is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ## Code of Conduct
 
-Everyone interacting in the Mailtrap project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
+Everyone interacting in the Mailtrap project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
+
+## Compatibility with previous releases
+
+Versions of this package up to 2.0.2 were an [unofficial client](https://github.com/vchin/mailtrap-client) developed by [@vchin](https://github.com/vchin). Package version 3 is a completely new package. 

data/lib/mailtrap/action_mailer/delivery_method.rb

@@ -14,7 +14,9 @@ module Mailtrap
       def deliver!(message)
         mail = Mailtrap::Mail.from_message(message)
 
-        client.send(mail)
+        client.send(mail).tap do |resp|
+          message['X-MT-Message-IDs'] = resp[:message_ids]
+        end
       end
 
       private

data/lib/mailtrap/contact.rb

@@ -29,10 +29,5 @@ module Mailtrap
     def newly_created?
       @action != 'updated'
     end
-
-    # @return [Hash] The contact attributes as a hash
-    def to_h
-      super.compact
-    end
   end
 end

data/lib/mailtrap/contact_field.rb

@@ -9,10 +9,5 @@ module Mailtrap
   #   Allowed values: text, integer, float, boolean, date
   # @attr_reader merge_tag [String] Personalize your campaigns by adding a merge tag.
   #   This field will be replaced with unique contact details for each recipient (max 80 characters)
-  ContactField = Struct.new(:id, :name, :data_type, :merge_tag, keyword_init: true) do
-    # @return [Hash] The contact field attributes as a hash
-    def to_h
-      super.compact
-    end
-  end
+  ContactField = Struct.new(:id, :name, :data_type, :merge_tag, keyword_init: true)
 end

data/lib/mailtrap/contact_import.rb

@@ -14,10 +14,5 @@ module Mailtrap
     :updated_contacts_count,
     :contacts_over_limit_count,
     keyword_init: true
-  ) do
-    # @return [Hash] The contact attributes as a hash
-    def to_h
-      super.compact
-    end
-  end
+  )
 end

data/lib/mailtrap/contact_list.rb

@@ -5,10 +5,5 @@ module Mailtrap
   # @see https://api-docs.mailtrap.io/docs/mailtrap-api-docs/6ec7a37234af2-contact-list
   # @attr_reader id [Integer] The contact list ID
   # @attr_reader name [String] The name of the contact list
-  ContactList = Struct.new(:id, :name, keyword_init: true) do
-    # @return [Hash] The contact list attributes as a hash
-    def to_h
-      super.compact
-    end
-  end
+  ContactList = Struct.new(:id, :name, keyword_init: true)
 end

data/lib/mailtrap/email_template.rb

@@ -26,10 +26,5 @@ module Mailtrap
     :created_at,
     :updated_at,
     keyword_init: true
-  ) do
-    # @return [Hash] The template attributes as a hash
-    def to_h
-      super.compact
-    end
-  end
+  )
 end

data/lib/mailtrap/inbox.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Mailtrap
+  # Data Transfer Object for Inbox
+  # @see https://api-docs.mailtrap.io/docs/mailtrap-api-docs/ee252e413d78a-create-project
+  # @attr_reader id [Integer] The inbox ID
+  # @attr_reader name [String] The inbox name
+  # @attr_reader username [String] The inbox username
+  # @attr_reader password [String, nil] The inbox password
+  # @attr_reader max_size [Integer] The maximum inbox size in MB
+  # @attr_reader status [String] The inbox status
+  # @attr_reader email_username [String] The email username
+  # @attr_reader email_username_enabled [Boolean] Whether the email username is enabled
+  # @attr_reader sent_messages_count [Integer] The count of sent messages
+  # @attr_reader forwarded_messages_count [Integer] The count of forwarded messages
+  # @attr_reader used [Integer] The used inbox size in MB
+  # @attr_reader forward_from_email_address [String] The forwarding email address
+  # @attr_reader project_id [Integer] The associated project ID
+  # @attr_reader domain [String] The inbox domain
+  # @attr_reader pop3_domain [String] The POP3 domain
+  # @attr_reader email_domain [String] The email domain
+  # @attr_reader api_domain [String] The API domain
+  # @attr_reader emails_count [Integer] The total number of emails
+  # @attr_reader emails_unread_count [Integer] The number of unread emails
+  # @attr_reader last_message_sent_at [String, nil] The timestamp of the last sent message
+  # @attr_reader smtp_ports [Array<Integer>] The list of SMTP ports
+  # @attr_reader pop3_ports [Array<Integer>] The list of POP3 ports
+  # @attr_reader max_message_size [Integer] The maximum message size in MB
+  # @attr_reader permissions [Hash] List of permissions
+  Inbox = Struct.new(
+    :id,
+    :name,
+    :username,
+    :password,
+    :max_size,
+    :status,
+    :email_username,
+    :email_username_enabled,
+    :sent_messages_count,
+    :forwarded_messages_count,
+    :used,
+    :forward_from_email_address,
+    :project_id,
+    :domain,
+    :pop3_domain,
+    :email_domain,
+    :api_domain,
+    :emails_count,
+    :emails_unread_count,
+    :last_message_sent_at,
+    :smtp_ports,
+    :pop3_ports,
+    :max_message_size,
+    :permissions,
+    keyword_init: true
+  )
+end

data/lib/mailtrap/inboxes_api.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require_relative 'base_api'
+require_relative 'inbox'
+
+module Mailtrap
+  class InboxesAPI
+    include BaseAPI
+
+    self.supported_options = %i[name]
+    self.response_class = Inbox
+
+    # Lists all Inboxes for the account
+    # @return [Array<Inbox>] Array of Inboxes
+    # @!macro api_errors
+    def list
+      base_list
+    end
+
+    # Retrieves a specific inbox
+    # @param inbox_id [Integer] The inbox identifier
+    # @return [Inbox] Inbox object
+    # @!macro api_errors
+    def get(inbox_id)
+      base_get(inbox_id)
+    end
+
+    # Creates a new inbox
+    # @param [Hash] options The parameters to create
+    # @option options [String] :name The inbox name
+    # @return [Inbox] Created inbox object
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def create(options)
+      validate_options!(options, supported_options + [:project_id])
+      response = client.post("/api/accounts/#{account_id}/projects/#{options[:project_id]}/inboxes",
+                             wrap_request(options))
+      handle_response(response)
+    end
+
+    # Deletes an inbox
+    # @param inbox_id [Integer] The Inbox identifier
+    # @return nil
+    # @!macro api_errors
+    def delete(inbox_id)
+      base_delete(inbox_id)
+    end
+
+    # Updates an existing Inbox
+    # @param inbox_id [Integer] The Inbox identifier
+    # @param [Hash] options The parameters to update
+    # @option options [String] :name The inbox name
+    # @option options [String] :email_username The inbox email username
+    # @return [Inbox] Updated Inbox object
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def update(inbox_id, options)
+      base_update(inbox_id, options, supported_options + [:email_username])
+    end
+
+    # Delete all messages (emails) from Inbox
+    # @param inbox_id [Integer] The Inbox identifier
+    # @return [Inbox] Updated Inbox object
+    # @!macro api_errors
+    def clean(inbox_id)
+      response = client.patch("#{base_path}/#{inbox_id}/clean")
+      handle_response(response)
+    end
+
+    # Mark all messages in the inbox as read
+    # @param inbox_id [Integer] The Inbox identifier
+    # @return [Inbox] Updated Inbox object
+    # @!macro api_errors
+    def mark_as_read(inbox_id)
+      response = client.patch("#{base_path}/#{inbox_id}/all_read")
+      handle_response(response)
+    end
+
+    # Reset SMTP credentials of the inbox
+    # @param inbox_id [Integer] The Inbox identifier
+    # @return [Inbox] Updated Inbox object
+    # @!macro api_errors
+    def reset_credentials(inbox_id)
+      response = client.patch("#{base_path}/#{inbox_id}/reset_credentials")
+      handle_response(response)
+    end
+
+    private
+
+    def wrap_request(options)
+      { inbox: options }
+    end
+
+    def base_path
+      "/api/accounts/#{account_id}/inboxes"
+    end
+  end
+end

data/lib/mailtrap/project.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Mailtrap
+  # Data Transfer Object for Project
+  # @see https://api-docs.mailtrap.io/docs/mailtrap-api-docs/ee252e413d78a-create-project
+  # @attr_reader id [Integer] The project ID
+  # @attr_reader name [String] The project name
+  # @attr_reader share_links [Hash] Admin and viewer share links
+  # @attr_reader inboxes [Array<Mailtrap::Inbox>] Array of inboxes
+  # @attr_reader permissions [Hash] List of permissions
+  #
+  Project = Struct.new(
+    :id,
+    :name,
+    :share_links,
+    :inboxes,
+    :permissions,
+    keyword_init: true
+  )
+end

data/lib/mailtrap/projects_api.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative 'base_api'
+require_relative 'project'
+require_relative 'inbox'
+
+module Mailtrap
+  class ProjectsAPI
+    include BaseAPI
+
+    self.supported_options = %i[name]
+
+    self.response_class = Project
+
+    # Lists all projects for the account
+    # @return [Array<Project>] Array of projects
+    # @!macro api_errors
+    def list
+      base_list
+    end
+
+    # Retrieves a specific project
+    # @param project_id [Integer] The project ID
+    # @return [Project] Project object
+    # @!macro api_errors
+    def get(project_id)
+      base_get(project_id)
+    end
+
+    # Creates a new project
+    # @param [Hash] options The parameters to create
+    # @option options [String] :name The project name
+    # @return [Project] Created project object
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def create(options)
+      base_create(options)
+    end
+
+    # Updates an existing project
+    # @param project_id [Integer] The project ID
+    # @param [Hash] options The parameters to update
+    # @return [Project] Updated project object
+    # @!macro api_errors
+    # @raise [ArgumentError] If invalid options are provided
+    def update(project_id, options)
+      base_update(project_id, options)
+    end
+
+    # Deletes a project
+    # @param project_id [Integer] The project ID
+    # @return nil
+    # @!macro api_errors
+    def delete(project_id)
+      base_delete(project_id)
+    end
+
+    private
+
+    def handle_response(response)
+      build_entity(
+        response.merge(
+          inboxes: response[:inboxes]&.map { |inbox| build_entity(inbox, Mailtrap::Inbox) }
+        ),
+        response_class
+      )
+    end
+
+    def base_path
+      "/api/accounts/#{account_id}/projects"
+    end
+
+    def wrap_request(options)
+      { project: options }
+    end
+  end
+end

data/lib/mailtrap/suppression.rb

@@ -37,10 +37,5 @@ module Mailtrap
     :message_sender_email,
     :message_subject,
     keyword_init: true
-  ) do
-    # @return [Hash] The suppression attributes as a hash
-    def to_h
-      super.compact
-    end
-  end
+  )
 end

data/lib/mailtrap/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mailtrap
-  VERSION = '2.4.2'
+  VERSION = '2.6.0'
 end

data/lib/mailtrap.rb

@@ -10,6 +10,8 @@ require_relative 'mailtrap/contact_lists_api'
 require_relative 'mailtrap/contact_fields_api'
 require_relative 'mailtrap/contact_imports_api'
 require_relative 'mailtrap/suppressions_api'
+require_relative 'mailtrap/projects_api'
+require_relative 'mailtrap/inboxes_api'
 
 module Mailtrap
   # @!macro api_errors

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mailtrap
 version: !ruby/object:Gem::Version
-  version: 2.4.2
+  version: 2.6.0
 platform: ruby
 authors:
 - Railsware Products Studio LLC
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -60,9 +59,13 @@ files:
 - lib/mailtrap/email_template.rb
 - lib/mailtrap/email_templates_api.rb
 - lib/mailtrap/errors.rb
+- lib/mailtrap/inbox.rb
+- lib/mailtrap/inboxes_api.rb
 - lib/mailtrap/mail.rb
 - lib/mailtrap/mail/base.rb
 - lib/mailtrap/mail/from_template.rb
+- lib/mailtrap/project.rb
+- lib/mailtrap/projects_api.rb
 - lib/mailtrap/suppression.rb
 - lib/mailtrap/suppressions_api.rb
 - lib/mailtrap/version.rb
@@ -75,7 +78,6 @@ metadata:
   source_code_uri: https://github.com/mailtrap/mailtrap-ruby
   changelog_uri: https://github.com/mailtrap/mailtrap-ruby/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -90,8 +92,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Official mailtrap.io API client
 test_files: []