feat: Inbound emails (beta) (#65)

Co-authored-by: Lucas Fernandes da Costa <[email protected]>

Author: kewynakshlley

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.receiving.Receiving;
 import com.resend.services.topics.Topics;
 import com.resend.services.templates.Templates;
 
@@ -92,6 +93,15 @@ public Broadcasts broadcasts() {
         return new Broadcasts(apiKey);
     }
 
+    /**
+     * Returns a Receiving object that can be used to interact with the Receiving service for inbound emails.
+     *
+     * @return A Receiving object.
+     */
+    public Receiving receiving() {
+        return new Receiving(apiKey);
+    }
+  
     /**
      * Returns a Topics object that can be used to interact with the Topics service.
      *

src/main/java/com/resend/services/emails/Emails.java

@@ -192,4 +192,82 @@ public ListEmailsResponseSuccess list(ListParams params) throws ResendException
 
         return resendMapper.readValue(responseBody, ListEmailsResponseSuccess.class);
     }
+
+    /**
+     * Retrieves a single attachment from a sent email.
+     *
+     * @param emailId The unique identifier of the email.
+     * @param attachmentId The unique identifier of the attachment.
+     * @return The attachment details including download URL.
+     * @throws ResendException If an error occurs while retrieving the attachment.
+     */
+    public AttachmentResponse getAttachment(String emailId, String attachmentId) throws ResendException {
+        AbstractHttpResponse<String> response = this.httpClient.perform(
+            "/emails/" + emailId + "/attachments/" + attachmentId,
+            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, AttachmentResponse.class);
+    }
+
+    /**
+     * Retrieves all attachments from a sent email.
+     *
+     * @param emailId The unique identifier of the email.
+     * @return A ListAttachmentsResponse containing all attachments from the email.
+     * @throws ResendException If an error occurs while retrieving the attachments.
+     */
+    public ListAttachmentsResponse listAttachments(String emailId) throws ResendException {
+        AbstractHttpResponse<String> response = this.httpClient.perform(
+            "/emails/" + emailId + "/attachments",
+            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, ListAttachmentsResponse.class);
+    }
+
+    /**
+     * Retrieves a paginated list of attachments from a sent email.
+     *
+     * @param emailId The unique identifier of the email.
+     * @param params The params used to customize the list (pagination).
+     * @return A ListAttachmentsResponse containing the paginated list of attachments.
+     * @throws ResendException If an error occurs while retrieving the attachments.
+     */
+    public ListAttachmentsResponse listAttachments(String emailId, ListParams params) throws ResendException {
+        String pathWithQuery = "/emails/" + emailId + "/attachments" + 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, ListAttachmentsResponse.class);
+    }
 }

src/main/java/com/resend/services/emails/model/AttachmentResponse.java

@@ -0,0 +1,207 @@
+package com.resend.services.emails.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Represents the response when retrieving an attachment from a sent email.
+ */
+public class AttachmentResponse {
+
+    /**
+     * The object type, always "attachment".
+     */
+    @JsonProperty("object")
+    private String object;
+
+    /**
+     * The unique identifier of the attachment.
+     */
+    @JsonProperty("id")
+    private String id;
+
+    /**
+     * The filename of the attachment.
+     */
+    @JsonProperty("filename")
+    private String filename;
+
+    /**
+     * The size of the attachment in bytes.
+     */
+    @JsonProperty("size")
+    private Integer size;
+
+    /**
+     * The MIME content type of the attachment.
+     */
+    @JsonProperty("content_type")
+    private String contentType;
+
+    /**
+     * The content disposition (inline or attachment).
+     */
+    @JsonProperty("content_disposition")
+    private String contentDisposition;
+
+    /**
+     * The content ID for inline attachments.
+     */
+    @JsonProperty("content_id")
+    private String contentId;
+
+    /**
+     * The download URL for the attachment.
+     */
+    @JsonProperty("download_url")
+    private String downloadUrl;
+
+    /**
+     * The expiration timestamp of the download URL.
+     */
+    @JsonProperty("expires_at")
+    private String expiresAt;
+
+    /**
+     * Get the object type.
+     * @return The object type.
+     */
+    public String getObject() {
+        return object;
+    }
+
+    /**
+     * Set the object type.
+     * @param object The object type.
+     */
+    public void setObject(String object) {
+        this.object = object;
+    }
+
+    /**
+     * Get the attachment ID.
+     * @return The attachment ID.
+     */
+    public String getId() {
+        return id;
+    }
+
+    /**
+     * Set the attachment ID.
+     * @param id The attachment ID.
+     */
+    public void setId(String id) {
+        this.id = id;
+    }
+
+    /**
+     * Get the filename.
+     * @return The filename.
+     */
+    public String getFilename() {
+        return filename;
+    }
+
+    /**
+     * Set the filename.
+     * @param filename The filename.
+     */
+    public void setFilename(String filename) {
+        this.filename = filename;
+    }
+
+    /**
+     * Get the size in bytes.
+     * @return The size.
+     */
+    public Integer getSize() {
+        return size;
+    }
+
+    /**
+     * Set the size.
+     * @param size The size in bytes.
+     */
+    public void setSize(Integer size) {
+        this.size = size;
+    }
+
+    /**
+     * Get the content type.
+     * @return The content type.
+     */
+    public String getContentType() {
+        return contentType;
+    }
+
+    /**
+     * Set the content type.
+     * @param contentType The content type.
+     */
+    public void setContentType(String contentType) {
+        this.contentType = contentType;
+    }
+
+    /**
+     * Get the content disposition.
+     * @return The content disposition.
+     */
+    public String getContentDisposition() {
+        return contentDisposition;
+    }
+
+    /**
+     * Set the content disposition.
+     * @param contentDisposition The content disposition.
+     */
+    public void setContentDisposition(String contentDisposition) {
+        this.contentDisposition = contentDisposition;
+    }
+
+    /**
+     * Get the content ID.
+     * @return The content ID.
+     */
+    public String getContentId() {
+        return contentId;
+    }
+
+    /**
+     * Set the content ID.
+     * @param contentId The content ID.
+     */
+    public void setContentId(String contentId) {
+        this.contentId = contentId;
+    }
+
+    /**
+     * Get the download URL.
+     * @return The download URL.
+     */
+    public String getDownloadUrl() {
+        return downloadUrl;
+    }
+
+    /**
+     * Set the download URL.
+     * @param downloadUrl The download URL.
+     */
+    public void setDownloadUrl(String downloadUrl) {
+        this.downloadUrl = downloadUrl;
+    }
+
+    /**
+     * Get the expiration timestamp.
+     * @return The expiration timestamp.
+     */
+    public String getExpiresAt() {
+        return expiresAt;
+    }
+
+    /**
+     * Set the expiration timestamp.
+     * @param expiresAt The expiration timestamp.
+     */
+    public void setExpiresAt(String expiresAt) {
+        this.expiresAt = expiresAt;
+    }
+}

src/main/java/com/resend/services/emails/model/ListAttachmentsResponse.java

@@ -0,0 +1,65 @@
+package com.resend.services.emails.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * Represents a successful response for listing attachments.
+ */
+public class ListAttachmentsResponse {
+
+    @JsonProperty("object")
+    private String object;
+
+    @JsonProperty("data")
+    private List<AttachmentResponse> data;
+
+    @JsonProperty("has_more")
+    private Boolean hasMore;
+
+    /**
+     * Default constructor
+     */
+    public ListAttachmentsResponse() {
+    }
+
+    /**
+     * Constructs a successful response for listing attachments.
+     *
+     * @param data The list of attachments.
+     * @param object The object type, always "list".
+     * @param hasMore Whether there are more attachments available for pagination.
+     */
+    public ListAttachmentsResponse(final List<AttachmentResponse> data, final String object, final Boolean hasMore) {
+        this.data = data;
+        this.object = object;
+        this.hasMore = hasMore;
+    }
+
+    /**
+     * Gets the list of attachments.
+     *
+     * @return The list of attachments.
+     */
+    public List<AttachmentResponse> getData() {
+        return data;
+    }
+
+    /**
+     * Gets the object type.
+     *
+     * @return The object type.
+     */
+    public String getObject() {
+        return object;
+    }
+
+    /**
+     * Gets the indicator whether there are more items available for pagination.
+     *
+     * @return Whether there are more items available for pagination.
+     */
+    public Boolean hasMore() {
+        return hasMore;
+    }
+}