feat: add global contacts methods

[kewynakshlley]

Summary by cubic

Adds support for global contacts not tied to a segment/audience. When no segmentId/audienceId is provided, the SDK now uses /contacts to create, list, get, update, and delete contacts.

• New Features
  • create() auto-routes to /contacts when no segment/audience is set.
  • Added list() and list(ListParams) for global contacts.
  • Added get(String contactIdOrEmail) for global contacts.
  • Added remove(String contactId) for global contacts (ID only, not email).
  • Updated get/update/remove to pick the correct endpoint based on segment/audience presence.
  • Added tests covering all global contact flows.

^{Written for commit 6564f53. Summary will update automatically on new commits.}

[cubic-dev-ai]

1 issue found across 2 files

Prompt for AI agents (all 1 issues)

Understand the root cause of the following 1 issues and fix them.


<file name="src/main/java/com/resend/services/contacts/Contacts.java">

<violation number="1" location="src/main/java/com/resend/services/contacts/Contacts.java:98">
Rule violated: **API Key Permission Check SDK Methods**

Per the API Key Permission Check SDK Methods guideline, these new global contact endpoints (list/get/remove/update against /contacts) introduce additional Resend API operations. Please confirm production API keys have the necessary permissions for these calls to prevent authorization failures post-deploy.</violation>
</file>

_{React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.}

[cubic-dev-ai]

Rule violated: API Key Permission Check SDK Methods

Per the API Key Permission Check SDK Methods guideline, these new global contact endpoints (list/get/remove/update against /contacts) introduce additional Resend API operations. Please confirm production API keys have the necessary permissions for these calls to prevent authorization failures post-deploy.

Prompt for AI agents

Address the following comment on src/main/java/com/resend/services/contacts/Contacts.java at line 98:

<comment>Per the API Key Permission Check SDK Methods guideline, these new global contact endpoints (list/get/remove/update against /contacts) introduce additional Resend API operations. Please confirm production API keys have the necessary permissions for these calls to prevent authorization failures post-deploy.</comment>

<file context>
@@ -83,13 +89,51 @@ public ListContactsResponseSuccess list(String segmentId, ListParams params) thr
+     * @return A ListContactsResponseSuccess containing the list of global contacts.
+     * @throws ResendException If an error occurs during the contacts list retrieval process.
+     */
+    public ListContactsResponseSuccess list() throws ResendException {
+        AbstractHttpResponse&lt;String&gt; response = this.httpClient.perform(&quot;/contacts&quot;, super.apiKey, HttpMethod.GET, null, MediaType.get(&quot;application/json&quot;));
+
</file context>