add projects API

lib/mailtrap.rb

@@ -8,6 +8,7 @@
 require_relative 'mailtrap/contacts_api'
 require_relative 'mailtrap/contact_lists_api'
 require_relative 'mailtrap/contact_fields_api'
+require_relative 'mailtrap/projects_api'
 
 module Mailtrap
   # @!macro api_errors

lib/mailtrap/project.rb

@@ -0,0 +1,25 @@
+# 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] Array of inboxes
+  # @attr_reader permissions [Hash] List of permissions
+  Project = Struct.new(
+    :id,
+    :name,
+    :share_links,
+    :inboxes,
+    :permissions,
+    keyword_init: true
+  ) do
+
+    # @return [Hash] The project attributes as a hash
+    def to_h
+      super.compact
+    end
+  end
+end

lib/mailtrap/projects_api.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative 'base_api'
+require_relative 'project'
+
+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 base_path
+      "/api/accounts/#{account_id}/projects"
+    end
+
+    def wrap_request(options)
+      { project: options }
+    end
+  end
+end