feat(api): add sandbox delivery contracts

src/main/java/co/lettermint/api/ApiClient.java

@@ -7,7 +7,7 @@
 import java.net.URLEncoder;
 import java.util.Map;
 
 public class ApiClient {
     private final LettermintClient client;
     private final DomainsEndpoint domains;
     private final MessagesEndpoint messages;
@@ -18,7 +18,7 @@
     private final TeamEndpoint team;
     private final WebhooksEndpoint webhooks;
 
     public ApiClient(String apiToken, String baseUrl) {
         this.client = new LettermintClient(apiToken, baseUrl, LettermintClient.AuthMode.BEARER);
         this.domains = new DomainsEndpoint(client);
         this.messages = new MessagesEndpoint(client);
@@ -78,7 +78,7 @@
         }
     }
 
     public static class DomainsEndpoint {
         private final LettermintClient client;
 
         DomainsEndpoint(LettermintClient client) {
@@ -118,7 +118,7 @@
         }
     }
 
     public static class MessagesEndpoint {
         private final LettermintClient client;
 
         MessagesEndpoint(LettermintClient client) {
@@ -141,8 +141,8 @@
             return client.patch("/messages/" + segment(messageId), payload, RescheduleMessageResponse.class);
         }
 
-        public RescheduleMessageResponse cancel(String messageId) {
-            return client.post("/messages/" + segment(messageId) + "/cancel", null, RescheduleMessageResponse.class);
+        public CancelScheduledMessageResponse cancel(String messageId) {
+            return client.post("/messages/" + segment(messageId) + "/cancel", null, CancelScheduledMessageResponse.class);
         }
 
         public ProcessInboundMessageResponse process(String messageId) {
@@ -170,7 +170,7 @@
         }
     }
 
     public static class ProjectsEndpoint {
         private final LettermintClient client;
 
         ProjectsEndpoint(LettermintClient client) {
@@ -218,7 +218,7 @@
         }
     }
 
     public static class RoutesEndpoint {
         private final LettermintClient client;
 
         RoutesEndpoint(LettermintClient client) {
@@ -242,7 +242,7 @@
         }
     }
 
     public static class StatsEndpoint {
         private final LettermintClient client;
 
         StatsEndpoint(LettermintClient client) {
@@ -258,7 +258,7 @@
         }
     }
 
     public static class SuppressionsEndpoint {
         private final LettermintClient client;
 
         SuppressionsEndpoint(LettermintClient client) {
@@ -282,7 +282,7 @@
         }
     }
 
     public static class TeamEndpoint {
         private final LettermintClient client;
 
         TeamEndpoint(LettermintClient client) {
@@ -326,7 +326,7 @@
         }
     }
 
     public static class WebhooksEndpoint {
         private final LettermintClient client;
 
         WebhooksEndpoint(LettermintClient client) {

src/main/java/co/lettermint/endpoints/EmailEndpoint.java

@@ -31,6 +31,7 @@
     private String tag;
     private List<MessageTag> tags;
     private Map<String, Object> settings;
+    private String sandboxResult;
     private String idempotencyKey;
 
     public EmailEndpoint(LettermintClient client) {
@@ -58,6 +59,7 @@
         this.tag = null;
         this.tags = new ArrayList<>();
         this.settings = null;
+        this.sandboxResult = null;
         this.idempotencyKey = null;
     }
 
@@ -65,7 +67,7 @@
      * Set the sender email address.
      * Format: {@code "Name <email>"} or just {@code "email"}
      */
     public EmailEndpoint from(String from) {
         this.from = from;
         return this;
     }
@@ -73,7 +75,7 @@
     /**
      * Set recipient email addresses. Replaces any existing recipients.
      */
     public EmailEndpoint to(String... emails) {
         this.to = new ArrayList<>(Arrays.asList(emails));
         return this;
     }
@@ -81,7 +83,7 @@
     /**
      * Set CC email addresses. Replaces any existing CC recipients.
      */
     public EmailEndpoint cc(String... emails) {
         this.cc = new ArrayList<>(Arrays.asList(emails));
         return this;
     }
@@ -89,7 +91,7 @@
     /**
      * Set BCC email addresses. Replaces any existing BCC recipients.
      */
     public EmailEndpoint bcc(String... emails) {
         this.bcc = new ArrayList<>(Arrays.asList(emails));
         return this;
     }
@@ -97,7 +99,7 @@
     /**
      * Set reply-to email addresses. Replaces any existing reply-to addresses.
      */
     public EmailEndpoint replyTo(String... emails) {
         this.replyTo = new ArrayList<>(Arrays.asList(emails));
         return this;
     }
@@ -257,6 +259,14 @@
         return this;
     }
 
+    /**
+     * Select the simulated result for a Sandbox project message.
+     */
+    public EmailEndpoint sandboxResult(String sandboxResult) {
+        this.sandboxResult = sandboxResult;
+        return this;
+    }
+
     /**
      * Set an idempotency key for the request.
      */
@@ -369,6 +379,10 @@
             payload.put("settings", settings);
         }
 
+        if (sandboxResult != null) {
+            payload.put("sandbox_result", sandboxResult);
+        }
+
         return payload;
     }
 }

src/main/java/co/lettermint/models/SendEmailResponse.java

@@ -15,6 +15,12 @@ public class SendEmailResponse {
     @JsonProperty("status")
     private String status;
 
+    @JsonProperty("sandbox")
+    private Boolean sandbox;
+
+    @JsonProperty("sandbox_result")
+    private String sandboxResult;
+
     public SendEmailResponse() {
     }
 
@@ -39,11 +45,29 @@ public void setStatus(String status) {
         this.status = status;
     }
 
+    public Boolean getSandbox() {
+        return sandbox;
+    }
+
+    public void setSandbox(Boolean sandbox) {
+        this.sandbox = sandbox;
+    }
+
+    public String getSandboxResult() {
+        return sandboxResult;
+    }
+
+    public void setSandboxResult(String sandboxResult) {
+        this.sandboxResult = sandboxResult;
+    }
+
     @Override
     public String toString() {
         return "SendEmailResponse{" +
                 "messageId='" + messageId + '\'' +
                 ", status='" + status + '\'' +
+                ", sandbox=" + sandbox +
+                ", sandboxResult='" + sandboxResult + '\'' +
                 '}';
     }
 }

src/main/java/co/lettermint/models/api/CancelScheduledMessageResponse.java

@@ -0,0 +1,16 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class CancelScheduledMessageResponse {
+    @JsonProperty("message_id")
+    public String messageId;
+
+    @JsonProperty("status")
+    public String status;
+
+    @JsonProperty("scheduled_at")
+    public String scheduledAt;
+}

src/main/java/co/lettermint/models/api/DeliveryMode.java

@@ -0,0 +1,8 @@
+package co.lettermint.models.api;
+
+public final class DeliveryMode {
+    public static final String LIVE = "live";
+    public static final String SANDBOX = "sandbox";
+
+    private DeliveryMode() {}
+}

src/main/java/co/lettermint/models/api/MessageData.java

@@ -66,4 +66,10 @@ public class MessageData {
 
     @JsonProperty("created_at")
     public String createdAt;
+
+    @JsonProperty("delivery_mode")
+    public String deliveryMode;
+
+    @JsonProperty("sandbox_result")
+    public String sandboxResult;
 }

src/main/java/co/lettermint/models/api/MessageListData.java

@@ -54,4 +54,10 @@ public class MessageListData {
 
     @JsonProperty("created_at")
     public String createdAt;
+
+    @JsonProperty("delivery_mode")
+    public String deliveryMode;
+
+    @JsonProperty("sandbox_result")
+    public String sandboxResult;
 }

src/main/java/co/lettermint/models/api/MessageRecipientData.java

@@ -10,4 +10,7 @@ public class MessageRecipientData {
 
     @JsonProperty("name")
     public String name;
+
+    @JsonProperty("sandbox_result")
+    public String sandboxResult;
 }

src/main/java/co/lettermint/models/api/ProjectData.java

@@ -50,4 +50,7 @@ public class ProjectData {
 
     @JsonProperty("updated_at")
     public String updatedAt;
+
+    @JsonProperty("delivery_mode")
+    public String deliveryMode;
 }

src/main/java/co/lettermint/models/api/RouteData.java

@@ -28,6 +28,9 @@ public class RouteData {
     @JsonProperty("inbound_address")
     public String inboundAddress;
 
+    @JsonProperty("inbound_mx_hostname")
+    public String inboundMxHostname;
+
     @JsonProperty("inbound_domain")
     public String inboundDomain;
 

src/main/java/co/lettermint/models/api/SandboxResult.java

@@ -0,0 +1,17 @@
+package co.lettermint.models.api;
+
+public final class SandboxResult {
+    public static final String DELIVERED = "delivered";
+    public static final String HARDBOUNCED = "hard_bounced";
+    public static final String SOFTBOUNCED = "soft_bounced";
+    public static final String DEFERRED = "deferred";
+    public static final String FAILED = "failed";
+    public static final String SUPPRESSED = "suppressed";
+    public static final String SPAMCOMPLAINT = "spam_complaint";
+    public static final String AUTOREPLIED = "auto_replied";
+    public static final String OPENED = "opened";
+    public static final String CLICKED = "clicked";
+    public static final String UNSUBSCRIBED = "unsubscribed";
+
+    private SandboxResult() {}
+}

src/main/java/co/lettermint/models/api/SendMailRequest.java

@@ -54,4 +54,7 @@ public class SendMailRequest {
 
     @JsonProperty("attachments")
     public List<Map<String, Object>> attachments;
+
+    @JsonProperty("sandbox_result")
+    public String sandboxResult;
 }

src/main/java/co/lettermint/models/api/SendMailResponse.java

@@ -13,4 +13,10 @@ public class SendMailResponse {
 
     @JsonProperty("scheduled_at")
     public String scheduledAt;
+
+    @JsonProperty("sandbox")
+    public Boolean sandbox;
+
+    @JsonProperty("sandbox_result")
+    public String sandboxResult;
 }

src/main/java/co/lettermint/models/api/StoreProjectData.java

@@ -16,4 +16,7 @@ public class StoreProjectData {
 
     @JsonProperty("short_token")
     public Boolean shortToken;
+
+    @JsonProperty("delivery_mode")
+    public String deliveryMode;
 }

src/main/java/co/lettermint/models/api/StoreSuppressionData.java

@@ -23,4 +23,7 @@ public class StoreSuppressionData {
 
     @JsonProperty("project_id")
     public String projectId;
+
+    @JsonProperty("applies_to")
+    public String appliesTo;
 }

src/main/java/co/lettermint/models/api/StoreWebhookData.java

@@ -6,9 +6,6 @@
 
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class StoreWebhookData {
-    @JsonProperty("route_id")
-    public String routeId;
-
     @JsonProperty("name")
     public String name;
 
@@ -23,4 +20,19 @@ public class StoreWebhookData {
 
     @JsonProperty("include_machine_events")
     public Boolean includeMachineEvents;
+
+    @JsonProperty("scope")
+    public String scope;
+
+    @JsonProperty("project_ids")
+    public List<String> projectIds;
+
+    @JsonProperty("route_ids")
+    public List<String> routeIds;
+
+    @JsonProperty("route_id")
+    public String routeId;
+
+    @JsonProperty("delivery_mode_filter")
+    public String deliveryModeFilter;
 }

src/main/java/co/lettermint/models/api/SuppressedRecipientData.java

@@ -20,6 +20,9 @@ public class SuppressedRecipientData {
     @JsonProperty("scope")
     public String scope;
 
+    @JsonProperty("applies_to")
+    public String appliesTo;
+
     @JsonProperty("project_id")
     public String projectId;
 
@@ -31,7 +34,4 @@ public class SuppressedRecipientData {
 
     @JsonProperty("created_at")
     public String createdAt;
-
-    @JsonProperty("updated_at")
-    public String updatedAt;
 }

src/main/java/co/lettermint/models/api/SuppressionAppliesTo.java

@@ -0,0 +1,8 @@
+package co.lettermint.models.api;
+
+public final class SuppressionAppliesTo {
+    public static final String ALL = "all";
+    public static final String BROADCAST = "broadcast";
+
+    private SuppressionAppliesTo() {}
+}

src/main/java/co/lettermint/models/api/SuppressionScope.java

@@ -1,7 +1,6 @@
 package co.lettermint.models.api;
 
 public final class SuppressionScope {
-    public static final String GLOBAL = "global";
     public static final String TEAM = "team";
     public static final String PROJECT = "project";
     public static final String ROUTE = "route";

src/main/java/co/lettermint/models/api/UpdateProjectData.java

@@ -16,4 +16,7 @@ public class UpdateProjectData {
 
     @JsonProperty("default_route_id")
     public String defaultRouteId;
+
+    @JsonProperty("delivery_mode")
+    public String deliveryMode;
 }

src/main/java/co/lettermint/models/api/UpdateWebhookData.java

@@ -20,4 +20,19 @@ public class UpdateWebhookData {
 
     @JsonProperty("include_machine_events")
     public Boolean includeMachineEvents;
+
+    @JsonProperty("scope")
+    public String scope;
+
+    @JsonProperty("project_ids")
+    public List<String> projectIds;
+
+    @JsonProperty("route_ids")
+    public List<String> routeIds;
+
+    @JsonProperty("route_id")
+    public String routeId;
+
+    @JsonProperty("delivery_mode_filter")
+    public String deliveryModeFilter;
 }

src/main/java/co/lettermint/models/api/WebhookData.java

@@ -9,6 +9,15 @@ public class WebhookData {
     @JsonProperty("id")
     public String id;
 
+    @JsonProperty("scope")
+    public String scope;
+
+    @JsonProperty("project_ids")
+    public List<String> projectIds;
+
+    @JsonProperty("route_ids")
+    public List<String> routeIds;
+
     @JsonProperty("route_id")
     public String routeId;
 
@@ -27,9 +36,6 @@ public class WebhookData {
     @JsonProperty("include_machine_events")
     public Boolean includeMachineEvents;
 
-    @JsonProperty("secret")
-    public String secret;
-
     @JsonProperty("last_called_at")
     public String lastCalledAt;
 
@@ -38,4 +44,7 @@ public class WebhookData {
 
     @JsonProperty("updated_at")
     public String updatedAt;
+
+    @JsonProperty("delivery_mode_filter")
+    public String deliveryModeFilter;
 }

src/main/java/co/lettermint/models/api/WebhookDeliveryData.java

@@ -15,6 +15,15 @@ public class WebhookDeliveryData {
     @JsonProperty("event_type")
     public String eventType;
 
+    @JsonProperty("source_scope")
+    public String sourceScope;
+
+    @JsonProperty("source_project_id")
+    public String sourceProjectId;
+
+    @JsonProperty("source_route_id")
+    public String sourceRouteId;
+
     @JsonProperty("status")
     public String status;
 
@@ -44,4 +53,7 @@ public class WebhookDeliveryData {
 
     @JsonProperty("timestamp")
     public String timestamp;
+
+    @JsonProperty("sandbox")
+    public Boolean sandbox;
 }

src/main/java/co/lettermint/models/api/WebhookDeliveryListData.java

@@ -14,6 +14,15 @@ public class WebhookDeliveryListData {
     @JsonProperty("event_type")
     public String eventType;
 
+    @JsonProperty("source_scope")
+    public String sourceScope;
+
+    @JsonProperty("source_project_id")
+    public String sourceProjectId;
+
+    @JsonProperty("source_route_id")
+    public String sourceRouteId;
+
     @JsonProperty("status")
     public String status;
 

src/main/java/co/lettermint/models/api/WebhookDeliveryModeFilter.java

@@ -0,0 +1,9 @@
+package co.lettermint.models.api;
+
+public final class WebhookDeliveryModeFilter {
+    public static final String LIVE = "live";
+    public static final String SANDBOX = "sandbox";
+    public static final String BOTH = "both";
+
+    private WebhookDeliveryModeFilter() {}
+}