mailtrap 2.7.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a56e52ebde096ddaa019f4c16e15f63fe37ace69d91892f4c92044c0727b3c3f
-  data.tar.gz: 79a7aca8251526389c4faa2f643ca8f7e58182de4dcbada0af2d8f9a5afe6464
+  metadata.gz: ad3283b7e6c8af70b1ac8bb3a965868e3b312c01682615c86f7da5104add3bcb
+  data.tar.gz: 8bab417f54c310a6a92b93ed4a1c6ca6a4cd88dae2e0614e3d2f21cda05d8cf0
 SHA512:
-  metadata.gz: df5e86fd7a0d31a5b717e189ae9637f6e0f413dad2d4fd2c9adbc56e7be5197ef5a59a759dc6eee9ff19a98c9196c7d5f1a984b3ee5f75ef69a5ca0f376a5519
-  data.tar.gz: 516e66780366eaf9f76b07f0957092b345fdd0262cd15dd997dcde5887276b7b37ba9c5c29971c6e7e53082e74db4deb5575ba1b4e0ebab4341fae05d7accc98
+  metadata.gz: 317490e679342d1c9ac8ae12162268c4102ee410a3d4a9896237894c2a5cd39063595c613d248938a1770cd8f24c7cb4dc72f109c1dabec48f920f92f47cd89d
+  data.tar.gz: 7da01e190af37689aff6aacdeb411f0858c7c75baf809b51266db920e2988021343e73f164728d9d9bf857139ee2f30cbf004b6c50782d7394685ef6513f05d8

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [2.8.0] - 2026-03-03
+- Add Account Accesses API
+- Add Billing API
+
 ## [2.7.0] - 2026-02-24 
 - Add Sandbox Messages API
 - Add Sending Domains API

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mailtrap (2.7.0)
+    mailtrap (2.8.0)
       base64
 
 GEM

data/README.md

@@ -191,9 +191,11 @@ Contact management:
 
 General:
 
-- Templates CRUD – [`email_templates_api.rb`](examples/email_templates_api.rb)
-- Action Mailer – [`action_mailer.rb`](examples/action_mailer.rb)
 - Accounts API – [`accounts_api.rb`](examples/accounts_api.rb)
+- Account Accesses API – [`account_accesses_api.rb`](examples/account_accesses_api.rb)
+- Billing API – [`billing_api.rb`](examples/billing_api.rb)
+- Templates API – [`email_templates_api.rb`](examples/email_templates_api.rb)
+- Action Mailer – [`action_mailer.rb`](examples/action_mailer.rb)
 
 ## Migration guide v1 → v2
 

data/lib/mailtrap/account_access.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Mailtrap
+  # Data Transfer Object for AccountAccess
+  # @see https://docs.mailtrap.io/developers/account-management/access-control
+  # @attr_reader id [Integer] The access ID
+  # @attr_reader specifier_type [String] The type of the specifier
+  # @attr_reader specifier [Hash] The specifier for the access
+  # @attr_reader resources [Array<Hash>] The resources this access applies to
+  # @attr_reader permissions [Hash] The permissions granted
+  #
+  AccountAccess = Struct.new(
+    :id,
+    :specifier_type,
+    :specifier,
+    :resources,
+    :permissions,
+    keyword_init: true
+  )
+end

data/lib/mailtrap/account_accesses_api.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative 'base_api'
+require_relative 'account_access'
+
+module Mailtrap
+  class AccountAccessesAPI
+    include BaseAPI
+
+    attr_reader :account_id
+
+    self.response_class = AccountAccess
+
+    # Retrieves a list of account accesses with optional filtering by domain, inbox, or project IDs
+    # @param domain_ids [Array<Integer>] Optional array of domain IDs to filter by
+    # @param inbox_ids [Array<Integer>] Optional array of inbox IDs to filter by
+    # @param project_ids [Array<Integer>] Optional array of project IDs to filter by
+    # @return [Array<AccountAccess>] List of account access objects
+    # @!macro api_errors
+    def list(domain_ids: [], inbox_ids: [], project_ids: [])
+      query_params = {}
+      query_params[:domain_ids] = domain_ids unless domain_ids.empty?
+      query_params[:inbox_ids] = inbox_ids unless inbox_ids.empty?
+      query_params[:project_ids] = project_ids unless project_ids.empty?
+
+      base_list(query_params)
+    end
+
+    # Deletes an account access
+    # @param account_access_id [Integer] The account access ID
+    # @return [Hash]
+    # @!macro api_errors
+    def delete(account_access_id)
+      base_delete(account_access_id)
+    end
+
+    private
+
+    def base_path
+      "/api/accounts/#{account_id}/account_accesses"
+    end
+  end
+end

data/lib/mailtrap/billing_api.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'base_api'
+require_relative 'billing_usage'
+
+module Mailtrap
+  class BillingAPI
+    include BaseAPI
+
+    # Get current billing cycle usage
+    # @return [BillingUsage] Billing usage data for account
+    # @!macro api_errors
+    def usage
+      response = client.get("/api/accounts/#{account_id}/billing/usage")
+      build_entity(response, BillingUsage)
+    end
+  end
+end

data/lib/mailtrap/billing_usage.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Mailtrap
+  # Data Transfer Object for Billing Usage data
+  # @see https://docs.mailtrap.io/developers/account-management/billing
+  # @attr_reader billing [Hash] The billing cycle details
+  # @attr_reader testing [Hash] Testing subscription usage
+  # @attr_reader sending [Hash] Sending subscription usage
+  #
+  BillingUsage = Struct.new(
+    :billing,
+    :testing,
+    :sending,
+    keyword_init: true
+  )
+end

data/lib/mailtrap/project.rb

@@ -2,7 +2,7 @@
 
 module Mailtrap
   # Data Transfer Object for Project
-  # @see https://api-docs.mailtrap.io/docs/mailtrap-api-docs/ee252e413d78a-create-project
+  # @see https://docs.mailtrap.io/developers/email-sandbox/projects
   # @attr_reader id [Integer] The project ID
   # @attr_reader name [String] The project name
   # @attr_reader share_links [Hash] Admin and viewer share links

data/lib/mailtrap/version.rb

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

data/lib/mailtrap.rb

@@ -5,6 +5,8 @@ require_relative 'mailtrap/mail'
 require_relative 'mailtrap/errors'
 require_relative 'mailtrap/version'
 require_relative 'mailtrap/accounts_api'
+require_relative 'mailtrap/account_accesses_api'
+require_relative 'mailtrap/billing_api'
 require_relative 'mailtrap/email_templates_api'
 require_relative 'mailtrap/contacts_api'
 require_relative 'mailtrap/contact_lists_api'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mailtrap
 version: !ruby/object:Gem::Version
-  version: 2.7.0
+  version: 2.8.0
 platform: ruby
 authors:
 - Railsware Products Studio LLC
@@ -43,12 +43,16 @@ files:
 - Rakefile
 - lib/mailtrap.rb
 - lib/mailtrap/account.rb
+- lib/mailtrap/account_access.rb
+- lib/mailtrap/account_accesses_api.rb
 - lib/mailtrap/accounts_api.rb
 - lib/mailtrap/action_mailer.rb
 - lib/mailtrap/action_mailer/delivery_method.rb
 - lib/mailtrap/action_mailer/railtie.rb
 - lib/mailtrap/attachment.rb
 - lib/mailtrap/base_api.rb
+- lib/mailtrap/billing_api.rb
+- lib/mailtrap/billing_usage.rb
 - lib/mailtrap/client.rb
 - lib/mailtrap/contact.rb
 - lib/mailtrap/contact_field.rb