feat: Implement templates module (beta)

src/main/java/com/resend/Resend.java

@@ -7,6 +7,7 @@
 import com.resend.services.contacts.Contacts;
 import com.resend.services.domains.Domains;
 import com.resend.services.emails.Emails;
+import com.resend.services.templates.Templates;
 
 /**
  * The Resend class provides a facade for the Domains and Emails services.
@@ -89,4 +90,13 @@ public Batch batch() {
     public Broadcasts broadcasts() {
         return new Broadcasts(apiKey);
     }
+
+    /**
+     * Returns a Templates object that can be used to interact with the Templates service.
+     *
+     * @return A Templates object.
+     */
+    public Templates templates() {
+        return new Templates(apiKey);
+    }
 }

src/main/java/com/resend/services/templates/Templates.java

@@ -0,0 +1,180 @@
+package com.resend.services.templates;
+
+import com.resend.core.exception.ResendException;
+import com.resend.core.helper.URLHelper;
+import com.resend.core.net.AbstractHttpResponse;
+import com.resend.core.net.HttpMethod;
+import com.resend.core.net.ListParams;
+import com.resend.core.service.BaseService;
+import com.resend.services.templates.model.*;
+import okhttp3.MediaType;
+
+/**
+ * Represents the Resend Templates module.
+ */
+public final class Templates extends BaseService {
+
+    /**
+     * Constructs an instance of the {@code Templates} class.
+     *
+     * @param apiKey The apiKey used for authentication.
+     */
+    public Templates(final String apiKey) {
+        super(apiKey);
+    }
+
+    /**
+     * Creates a new template.
+     *
+     * @param options The options for creating the template.
+     * @return The response indicating the status of the template creation.
+     * @throws ResendException If an error occurs while creating the template.
+     */
+    public CreateTemplateResponseSuccess create(CreateTemplateOptions options) throws ResendException {
+        String payload = super.resendMapper.writeValue(options);
+        AbstractHttpResponse<String> response = super.httpClient.perform("/templates", super.apiKey, HttpMethod.POST, payload, MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, CreateTemplateResponseSuccess.class);
+    }
+
+    /**
+     * Retrieves a template by its unique identifier or alias.
+     *
+     * @param templateId The unique identifier or alias of the template.
+     * @return The retrieved template's details.
+     * @throws ResendException If an error occurs while retrieving the template.
+     */
+    public GetTemplateResponseSuccess get(String templateId) throws ResendException {
+        AbstractHttpResponse<String> response = this.httpClient.perform("/templates/" + templateId, super.apiKey, HttpMethod.GET, null, MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, GetTemplateResponseSuccess.class);
+    }
+
+    /**
+     * Retrieves a list of templates.
+     *
+     * @return A ListTemplatesResponse containing the list of templates.
+     * @throws ResendException If an error occurs during the templates list retrieval process.
+     */
+    public ListTemplatesResponseSuccess list() throws ResendException {
+        AbstractHttpResponse<String> response = this.httpClient.perform("/templates", super.apiKey, HttpMethod.GET, null, MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, ListTemplatesResponseSuccess.class);
+    }
+
+    /**
+     * Retrieves a paginated list of templates.
+     *
+     * @param params The params used to customize the list.
+     * @return A ListTemplatesResponse containing the paginated list of templates.
+     * @throws ResendException If an error occurs during the templates list retrieval process.
+     */
+    public ListTemplatesResponseSuccess list(ListParams params) throws ResendException {
+        String pathWithQuery = "/templates" + URLHelper.parse(params);
+        AbstractHttpResponse<String> response = this.httpClient.perform(pathWithQuery, super.apiKey, HttpMethod.GET, null, MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, ListTemplatesResponseSuccess.class);
+    }
+
+    /**
+     * Updates a template by its unique identifier or alias.
+     *
+     * @param templateId The unique identifier or alias of the template.
+     * @param options    The options for updating the template.
+     * @return The response indicating the status of the template update.
+     * @throws ResendException If an error occurs while updating the template.
+     */
+    public UpdateTemplateResponseSuccess update(String templateId, UpdateTemplateOptions options) throws ResendException {
+        String payload = super.resendMapper.writeValue(options);
+        AbstractHttpResponse<String> response = this.httpClient.perform("/templates/" + templateId, super.apiKey, HttpMethod.PATCH, payload, MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, UpdateTemplateResponseSuccess.class);
+    }
+
+    /**
+     * Deletes a template by its unique identifier or alias.
+     *
+     * @param templateId The unique identifier or alias of the template.
+     * @return The response indicating the status of the template deletion.
+     * @throws ResendException If an error occurs while deleting the template.
+     */
+    public DeleteTemplateResponseSuccess remove(String templateId) throws ResendException {
+        AbstractHttpResponse<String> response = this.httpClient.perform("/templates/" + templateId, super.apiKey, HttpMethod.DELETE, null, MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, DeleteTemplateResponseSuccess.class);
+    }
+
+    /**
+     * Duplicates a template by its unique identifier or alias.
+     *
+     * @param templateId The unique identifier or alias of the template.
+     * @return The response indicating the status of the template duplication.
+     * @throws ResendException If an error occurs while duplicating the template.
+     */
+    public DuplicateTemplateResponseSuccess duplicate(String templateId) throws ResendException {
+        AbstractHttpResponse<String> response = this.httpClient.perform("/templates/" + templateId + "/duplicate", super.apiKey, HttpMethod.POST, "", MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, DuplicateTemplateResponseSuccess.class);
+    }
+
+    /**
+     * Publishes a template by its unique identifier or alias.
+     *
+     * @param templateId The unique identifier or alias of the template.
+     * @return The response indicating the status of the template publication.
+     * @throws ResendException If an error occurs while publishing the template.
+     */
+    public PublishTemplateResponseSuccess publish(String templateId) throws ResendException {
+        AbstractHttpResponse<String> response = this.httpClient.perform("/templates/" + templateId + "/publish", super.apiKey, HttpMethod.POST, "", MediaType.get("application/json"));
+
+        if (!response.isSuccessful()) {
+            throw new ResendException(response.getCode(), response.getBody());
+        }
+
+        String responseBody = response.getBody();
+
+        return resendMapper.readValue(responseBody, PublishTemplateResponseSuccess.class);
+    }
+}