Cover sub account endpoints

Author: IgorDobryn

src/main/java/io/mailtrap/api/subaccounts/SubAccounts.java

@@ -0,0 +1,29 @@
+package io.mailtrap.api.subaccounts;
+
+import io.mailtrap.model.request.subaccounts.CreateSubAccountRequest;
+import io.mailtrap.model.response.subaccounts.SubAccount;
+
+import java.util.List;
+
+public interface SubAccounts {
+
+    /**
+     * Get a list of sub accounts for the specified organization.
+     * Requires sub account management permissions for the organization.
+     *
+     * @param organizationId unique organization ID
+     * @return list of sub accounts
+     */
+    List<SubAccount> getSubAccounts(long organizationId);
+
+    /**
+     * Create a new sub account under the specified organization.
+     * Requires sub account management permissions for the organization.
+     *
+     * @param organizationId unique organization ID
+     * @param request        sub account data
+     * @return created sub account
+     */
+    SubAccount createSubAccount(long organizationId, CreateSubAccountRequest request);
+
+}

src/main/java/io/mailtrap/api/subaccounts/SubAccountsImpl.java

@@ -0,0 +1,37 @@
+package io.mailtrap.api.subaccounts;
+
+import io.mailtrap.Constants;
+import io.mailtrap.api.apiresource.ApiResource;
+import io.mailtrap.config.MailtrapConfig;
+import io.mailtrap.http.RequestData;
+import io.mailtrap.model.request.subaccounts.CreateSubAccountRequest;
+import io.mailtrap.model.response.subaccounts.SubAccount;
+
+import java.util.List;
+
+public class SubAccountsImpl extends ApiResource implements SubAccounts {
+
+    public SubAccountsImpl(final MailtrapConfig config) {
+        super(config);
+        this.apiHost = Constants.GENERAL_HOST;
+    }
+
+    @Override
+    public List<SubAccount> getSubAccounts(final long organizationId) {
+        return httpClient.getList(
+            String.format(apiHost + "/api/organizations/%d/sub_accounts", organizationId),
+            new RequestData(),
+            SubAccount.class
+        );
+    }
+
+    @Override
+    public SubAccount createSubAccount(final long organizationId, final CreateSubAccountRequest request) {
+        return httpClient.post(
+            String.format(apiHost + "/api/organizations/%d/sub_accounts", organizationId),
+            request,
+            new RequestData(),
+            SubAccount.class
+        );
+    }
+}

src/main/java/io/mailtrap/client/MailtrapClient.java

@@ -56,6 +56,12 @@ public class MailtrapClient {
     @Getter
     private final MailtrapEmailTemplatesApi emailTemplatesApi;
 
+    /**
+     * API for Mailtrap.io Organizations functionality
+     */
+    @Getter
+    private final MailtrapOrganizationsApi organizationsApi;
+
     /**
      * Utility class which holds sending context (which API to use: Email Sending API, Bulk Sending API or
      * Email Testing API, inbox id for Email Testing API) to make it possible to perform send directly from MailtrapClient

src/main/java/io/mailtrap/client/api/MailtrapOrganizationsApi.java

@@ -0,0 +1,16 @@
+package io.mailtrap.client.api;
+
+import io.mailtrap.api.subaccounts.SubAccounts;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * Represents an API for Mailtrap Organizations functionality
+ */
+@Getter
+@Accessors(fluent = true)
+@RequiredArgsConstructor
+public class MailtrapOrganizationsApi {
+    private final SubAccounts subAccounts;
+}

src/main/java/io/mailtrap/factory/MailtrapClientFactory.java

@@ -22,6 +22,7 @@
 import io.mailtrap.api.sendingdomains.SendingDomainsImpl;
 import io.mailtrap.api.sendingemails.SendingEmailsImpl;
 import io.mailtrap.api.stats.StatsImpl;
+import io.mailtrap.api.subaccounts.SubAccountsImpl;
 import io.mailtrap.api.suppressions.SuppressionsImpl;
 import io.mailtrap.api.testingemails.TestingEmailsImpl;
 import io.mailtrap.client.MailtrapClient;
@@ -70,11 +71,18 @@ public static MailtrapClient createMailtrapClient(final MailtrapConfig config) {
         final var generalApi = createGeneralApi(config);
         final var contactsApi = createContactsApi(config);
         final var emailTemplatesApi = createEmailTemplatesApi(config);
+        final var organizationsApi = createOrganizationsApi(config);
 
         final var sendingContextHolder = configureSendingContext(config);
 
         return new MailtrapClient(sendingApi, testingApi, bulkSendingApi, generalApi, contactsApi, emailTemplatesApi,
-                sendingContextHolder);
+                organizationsApi, sendingContextHolder);
+    }
+
+    private static MailtrapOrganizationsApi createOrganizationsApi(final MailtrapConfig config) {
+        final var subAccounts = new SubAccountsImpl(config);
+
+        return new MailtrapOrganizationsApi(subAccounts);
     }
 
     private static MailtrapContactsApi createContactsApi(final MailtrapConfig config) {

src/main/java/io/mailtrap/model/request/subaccounts/CreateSubAccountRequest.java

@@ -0,0 +1,17 @@
+package io.mailtrap.model.request.subaccounts;
+
+import io.mailtrap.model.AbstractModel;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+public class CreateSubAccountRequest extends AbstractModel {
+
+    private SubAccountInput account;
+
+}

src/main/java/io/mailtrap/model/request/subaccounts/SubAccountInput.java

@@ -0,0 +1,14 @@
+package io.mailtrap.model.request.subaccounts;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class SubAccountInput {
+
+    private String name;
+
+}

src/main/java/io/mailtrap/model/response/subaccounts/SubAccount.java

@@ -0,0 +1,12 @@
+package io.mailtrap.model.response.subaccounts;
+
+import lombok.Data;
+
+@Data
+public class SubAccount {
+
+    private long id;
+
+    private String name;
+
+}

src/test/java/io/mailtrap/api/subaccounts/SubAccountsImplTest.java

@@ -0,0 +1,64 @@
+package io.mailtrap.api.subaccounts;
+
+import io.mailtrap.Constants;
+import io.mailtrap.config.MailtrapConfig;
+import io.mailtrap.factory.MailtrapClientFactory;
+import io.mailtrap.model.request.subaccounts.CreateSubAccountRequest;
+import io.mailtrap.model.request.subaccounts.SubAccountInput;
+import io.mailtrap.model.response.subaccounts.SubAccount;
+import io.mailtrap.testutils.BaseTest;
+import io.mailtrap.testutils.DataMock;
+import io.mailtrap.testutils.TestHttpClient;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+class SubAccountsImplTest extends BaseTest {
+
+    private final long organizationId = 1001L;
+
+    private SubAccounts api;
+
+    @BeforeEach
+    public void init() {
+        final TestHttpClient httpClient = new TestHttpClient(List.of(
+                DataMock.build(Constants.GENERAL_HOST + "/api/organizations/" + organizationId + "/sub_accounts",
+                        "GET", null, "api/subaccounts/getSubAccountsResponse.json"),
+
+                DataMock.build(Constants.GENERAL_HOST + "/api/organizations/" + organizationId + "/sub_accounts",
+                        "POST", "api/subaccounts/createSubAccountRequest.json", "api/subaccounts/createSubAccountResponse.json")
+        ));
+
+        final MailtrapConfig testConfig = new MailtrapConfig.Builder()
+                .httpClient(httpClient)
+                .token("dummy_token")
+                .build();
+
+        api = MailtrapClientFactory.createMailtrapClient(testConfig).organizationsApi().subAccounts();
+    }
+
+    @Test
+    void test_getSubAccounts() {
+        final List<SubAccount> subAccounts = api.getSubAccounts(organizationId);
+
+        assertEquals(2, subAccounts.size());
+        assertEquals(12345L, subAccounts.get(0).getId());
+        assertEquals("Development Team Account", subAccounts.get(0).getName());
+        assertEquals(12346L, subAccounts.get(1).getId());
+    }
+
+    @Test
+    void test_createSubAccount() {
+        final CreateSubAccountRequest request = new CreateSubAccountRequest(new SubAccountInput("New Team Account"));
+
+        final SubAccount response = api.createSubAccount(organizationId, request);
+
+        assertNotNull(response);
+        assertEquals(12347L, response.getId());
+        assertEquals("New Team Account", response.getName());
+    }
+}

src/test/resources/api/subaccounts/createSubAccountRequest.json

@@ -0,0 +1,5 @@
+{
+  "account": {
+    "name": "New Team Account"
+  }
+}