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

* Sync SDK with current OpenAPI specifications

* Fix email tags, settings, and batch idempotency

Author: bjarn

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

@@ -193,18 +193,6 @@ public ProjectRotateTokenResponse rotateToken(String projectId) {
             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);
         }
@@ -305,13 +293,25 @@ public TeamUsageDetailData usage(Map<String, String> query) {
             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 {

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 @@ public class EmailEndpoint extends Endpoint {
     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 @@ private void reset() {
         this.attachments = new ArrayList<>();
         this.route = null;
         this.metadata = new LinkedHashMap<>();
-        this.tags = new ArrayList<>();
+        this.tag = null;
+        this.settings = null;
         this.idempotencyKey = null;
     }
 
@@ -196,10 +198,18 @@ public EmailEndpoint metadata(String key, Object value) {
     }
 
     /**
-     * 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 SendEmailResponse send() {
     }
 
     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 @@ private Map<String, Object> buildPayload() {
             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;