feat(api): add team RBAC and fix email tags, settings, and batch headers

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) {
@@ -158,7 +158,7 @@
         }
     }
 
     public static class ProjectsEndpoint {
         private final LettermintClient client;
 
         ProjectsEndpoint(LettermintClient client) {
@@ -193,18 +193,6 @@
             return client.post("/projects/" + segment(projectId) + "/rotate-token", null, ProjectRotateTokenResponse.class);
         }
 
-        public ProjectUpdateMembersResponse updateMembers(String projectId, UpdateProjectMembersData payload) {
-            return client.put("/projects/" + segment(projectId) + "/members", payload, ProjectUpdateMembersResponse.class);
-        }
-
-        public ProjectAddMemberResponse addMember(String projectId, String teamMemberId) {
-            return client.post("/projects/" + segment(projectId) + "/members/" + segment(teamMemberId), null, ProjectAddMemberResponse.class);
-        }
-
-        public ProjectRemoveMemberResponse removeMember(String projectId, String teamMemberId) {
-            return client.delete("/projects/" + segment(projectId) + "/members/" + segment(teamMemberId), ProjectRemoveMemberResponse.class);
-        }
-
         public RouteIndexResponse routes(String projectId) {
             return routes(projectId, null);
         }
@@ -218,7 +206,7 @@
         }
     }
 
     public static class RoutesEndpoint {
         private final LettermintClient client;
 
         RoutesEndpoint(LettermintClient client) {
@@ -242,7 +230,7 @@
         }
     }
 
     public static class StatsEndpoint {
         private final LettermintClient client;
 
         StatsEndpoint(LettermintClient client) {
@@ -258,7 +246,7 @@
         }
     }
 
     public static class SuppressionsEndpoint {
         private final LettermintClient client;
 
         SuppressionsEndpoint(LettermintClient client) {
@@ -282,7 +270,7 @@
         }
     }
 
     public static class TeamEndpoint {
         private final LettermintClient client;
 
         TeamEndpoint(LettermintClient client) {
@@ -305,16 +293,28 @@
             return client.get("/team/usage", TeamUsageDetailData.class, query);
         }
 
+        public TeamRolesResponse roles() {
+            return client.get("/team/roles", TeamRolesResponse.class);
+        }
+
         public TeamMembersResponse members() {
             return members(null);
         }
 
         public TeamMembersResponse members(Map<String, String> query) {
             return client.get("/team/members", TeamMembersResponse.class, query);
         }
+
+        public TeamMemberData member(String userId) {
+            return client.get("/team/members/" + segment(userId), TeamMemberData.class);
+        }
+
+        public TeamMemberData updateMemberAssignment(String userId, UpdateTeamMemberAssignmentData payload) {
+            return client.put("/team/members/" + segment(userId) + "/assignment", payload, TeamMemberData.class);
+        }
     }
 
     public static class WebhooksEndpoint {
         private final LettermintClient client;
 
         WebhooksEndpoint(LettermintClient client) {

src/main/java/co/lettermint/client/LettermintClient.java

@@ -92,7 +92,11 @@ public <T> T post(String path, Object payload, Class<T> responseClass, Map<Strin
     }
 
     public <T> T post(String path, Object payload, TypeReference<T> responseType) {
-        return request("POST", url(path, null), payload, null, responseType, null);
+        return post(path, payload, responseType, null);
+    }
+
+    public <T> T post(String path, Object payload, TypeReference<T> responseType, Map<String, String> headers) {
+        return request("POST", url(path, null), payload, null, responseType, headers);
     }
 
     public <T> T get(String path, Class<T> responseClass) {

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

@@ -26,7 +26,8 @@
     private List<Attachment> attachments;
     private String route;
     private Map<String, Object> metadata;
-    private List<String> tags;
+    private String tag;
+    private Map<String, Object> settings;
     private String idempotencyKey;
 
     public EmailEndpoint(LettermintClient client) {
@@ -50,7 +51,8 @@
         this.attachments = new ArrayList<>();
         this.route = null;
         this.metadata = new LinkedHashMap<>();
-        this.tags = new ArrayList<>();
+        this.tag = null;
+        this.settings = null;
         this.idempotencyKey = null;
     }
 
@@ -58,7 +60,7 @@
      * Set the sender email address.
      * Format: {@code "Name <email>"} or just {@code "email"}
      */
     public EmailEndpoint from(String from) {
         this.from = from;
         return this;
     }
@@ -66,7 +68,7 @@
     /**
      * Set recipient email addresses. Replaces any existing recipients.
      */
     public EmailEndpoint to(String... emails) {
         this.to = new ArrayList<>(Arrays.asList(emails));
         return this;
     }
@@ -74,7 +76,7 @@
     /**
      * Set CC email addresses. Replaces any existing CC recipients.
      */
     public EmailEndpoint cc(String... emails) {
         this.cc = new ArrayList<>(Arrays.asList(emails));
         return this;
     }
@@ -82,7 +84,7 @@
     /**
      * Set BCC email addresses. Replaces any existing BCC recipients.
      */
     public EmailEndpoint bcc(String... emails) {
         this.bcc = new ArrayList<>(Arrays.asList(emails));
         return this;
     }
@@ -90,7 +92,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;
     }
@@ -196,10 +198,18 @@
     }
 
     /**
-     * Add tags to the email.
+     * Set the email tag.
      */
-    public EmailEndpoint tag(String... tags) {
-        this.tags.addAll(Arrays.asList(tags));
+    public EmailEndpoint tag(String tag) {
+        this.tag = tag;
+        return this;
+    }
+
+    /**
+     * Set per-email settings that override the selected route.
+     */
+    public EmailEndpoint settings(Map<String, Object> settings) {
+        this.settings = new LinkedHashMap<>(settings);
         return this;
     }
 
@@ -231,7 +241,17 @@
     }
 
     public List<SendMailResponse> sendBatch(List<SendMailRequest> payloads) {
-        return client.post("/send/batch", payloads, new TypeReference<List<SendMailResponse>>() {});
+        Map<String, String> requestHeaders = null;
+
+        if (idempotencyKey != null && !idempotencyKey.isEmpty()) {
+            requestHeaders = Collections.singletonMap("Idempotency-Key", idempotencyKey);
+        }
+
+        try {
+            return client.post("/send/batch", payloads, new TypeReference<List<SendMailResponse>>() {}, requestHeaders);
+        } finally {
+            reset();
+        }
     }
 
     public String ping() {
@@ -289,8 +309,12 @@
             payload.put("metadata", metadata);
         }
 
-        if (!tags.isEmpty()) {
-            payload.put("tags", tags);
+        if (tag != null) {
+            payload.put("tag", tag);
+        }
+
+        if (settings != null) {
+            payload.put("settings", settings);
         }
 
         return payload;

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

@@ -0,0 +1,9 @@
+package co.lettermint.models.api;
+
+public final class BuiltInTeamRole {
+    public static final String OWNER = "owner";
+    public static final String ADMIN = "admin";
+    public static final String MEMBER = "member";
+
+    private BuiltInTeamRole() {}
+}

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

@@ -0,0 +1,29 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class CursorPaginator {
+    @JsonProperty("data")
+    public List<String> data;
+
+    @JsonProperty("path")
+    public String path;
+
+    @JsonProperty("per_page")
+    public Integer perPage;
+
+    @JsonProperty("next_cursor")
+    public String nextCursor;
+
+    @JsonProperty("next_page_url")
+    public String nextPageUrl;
+
+    @JsonProperty("prev_cursor")
+    public String prevCursor;
+
+    @JsonProperty("prev_page_url")
+    public String prevPageUrl;
+}

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

@@ -0,0 +1,8 @@
+package co.lettermint.models.api;
+
+public final class DkimMode {
+    public static final String LEGACYTXT = "legacy_txt";
+    public static final String MANAGEDCNAME = "managed_cname";
+
+    private DkimMode() {}
+}

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

@@ -0,0 +1,11 @@
+package co.lettermint.models.api;
+
+public final class DnsRecordPurpose {
+    public static final String RETURNPATH = "return_path";
+    public static final String DMARC = "dmarc";
+    public static final String DKIMLEGACY = "dkim_legacy";
+    public static final String DKIMPRIMARY = "dkim_primary";
+    public static final String DKIMSECONDARY = "dkim_secondary";
+
+    private DnsRecordPurpose() {}
+}

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

@@ -0,0 +1,10 @@
+package co.lettermint.models.api;
+
+public final class DnsVerificationScope {
+    public static final String REQUIRED = "required";
+    public static final String RECOMMENDED = "recommended";
+    public static final String MIGRATION = "migration";
+    public static final String DEPRECATED = "deprecated";
+
+    private DnsVerificationScope() {}
+}

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

@@ -13,6 +13,12 @@ public class DomainData {
     @JsonProperty("domain")
     public String domain;
 
+    @JsonProperty("dkim_mode")
+    public String dkimMode;
+
+    @JsonProperty("rotation_ready")
+    public Boolean rotationReady;
+
     @JsonProperty("status_changed_at")
     public String statusChangedAt;
 

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

@@ -9,7 +9,7 @@ public class DomainDnsRecordData {
     public String id;
 
     @JsonProperty("type")
-    public RecordType type;
+    public String type;
 
     @JsonProperty("hostname")
     public String hostname;
@@ -21,7 +21,16 @@ public class DomainDnsRecordData {
     public String content;
 
     @JsonProperty("status")
-    public DnsRecordStatus status;
+    public String status;
+
+    @JsonProperty("purpose")
+    public String purpose;
+
+    @JsonProperty("verification_scope")
+    public String verificationScope;
+
+    @JsonProperty("required_for_verification")
+    public Boolean requiredForVerification;
 
     @JsonProperty("verified_at")
     public String verifiedAt;

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

@@ -12,7 +12,10 @@ public class DomainListData {
     public String domain;
 
     @JsonProperty("status")
-    public DomainStatus status;
+    public String status;
+
+    @JsonProperty("dkim_mode")
+    public String dkimMode;
 
     @JsonProperty("status_changed_at")
     public String statusChangedAt;

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

@@ -2,9 +2,14 @@
 
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+import java.util.Map;
 
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class DomainVerifyDnsRecordsResponse {
     @JsonProperty("message")
     public String message;
+
+    @JsonProperty("recommended_failed_records")
+    public List<Map<String, Object>> recommendedFailedRecords;
 }

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

@@ -11,10 +11,10 @@ public class MessageData {
     public String id;
 
     @JsonProperty("type")
-    public MessageType type;
+    public String type;
 
     @JsonProperty("status")
-    public MessageStatus status;
+    public String status;
 
     @JsonProperty("status_changed_at")
     public String statusChangedAt;

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

@@ -10,7 +10,7 @@ public class MessageEventData {
     public String messageId;
 
     @JsonProperty("event")
-    public MessageEventType event;
+    public String event;
 
     @JsonProperty("metadata")
     public Map<String, Object> metadata;

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

@@ -3,27 +3,16 @@
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import java.util.List;
+import java.util.Map;
 
 @JsonIgnoreProperties(ignoreUnknown = true)
 public class MessageIndexResponse {
     @JsonProperty("data")
     public List<MessageListData> data;
 
-    @JsonProperty("path")
-    public String path;
+    @JsonProperty("links")
+    public List<String> links;
 
-    @JsonProperty("per_page")
-    public Integer perPage;
-
-    @JsonProperty("next_cursor")
-    public String nextCursor;
-
-    @JsonProperty("next_page_url")
-    public String nextPageUrl;
-
-    @JsonProperty("prev_cursor")
-    public String prevCursor;
-
-    @JsonProperty("prev_page_url")
-    public String prevPageUrl;
+    @JsonProperty("meta")
+    public Map<String, Object> meta;
 }

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

@@ -10,10 +10,13 @@ public class MessageListData {
     public String id;
 
     @JsonProperty("type")
-    public MessageType type;
+    public String type;
 
     @JsonProperty("status")
-    public MessageStatus status;
+    public String status;
+
+    @JsonProperty("spam_score")
+    public Double spamScore;
 
     @JsonProperty("from_email")
     public String fromEmail;
@@ -39,6 +42,9 @@ public class MessageListData {
     @JsonProperty("tag")
     public String tag;
 
+    @JsonProperty("status_changed_at")
+    public String statusChangedAt;
+
     @JsonProperty("created_at")
     public String createdAt;
 }

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

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

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

@@ -42,12 +42,6 @@ public class ProjectData {
     @JsonProperty("domains_count")
     public Integer domainsCount;
 
-    @JsonProperty("team_members")
-    public List<TeamMemberData> teamMembers;
-
-    @JsonProperty("team_members_count")
-    public Integer teamMembersCount;
-
     @JsonProperty("last_28_days")
     public MessageStatsData last28Days;
 

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

@@ -20,9 +20,6 @@ public class ProjectListData {
     @JsonProperty("domains_count")
     public Integer domainsCount;
 
-    @JsonProperty("team_members_count")
-    public Integer teamMembersCount;
-
     @JsonProperty("last_28_days")
     public MessageStatsData last28Days;