From 3899f2b28763fa2cda3b43d5c7cfc50fd23a090c Mon Sep 17 00:00:00 2001 From: Micael Marques Date: Wed, 15 Jul 2026 00:29:41 -0300 Subject: [PATCH 1/3] =?UTF-8?q?fix:=20baseUrl=20can=C3=B4nico=20https://ap?= =?UTF-8?q?i.ararahq.com=20(path=20/v1,=20sem=20/api)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- src/main/java/com/ararahq/arara/sdk/config/AraraConfig.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2faea0d..9d06f2f 100644 --- a/README.md +++ b/README.md @@ -97,7 +97,7 @@ import com.ararahq.arara.sdk.Arara; // Criar o cliente Arara arara = Arara.builder() .apiKey("sua-chave-api-aqui") - .baseUrl("https://api.ararahq.com/api") + .baseUrl("https://api.ararahq.com") .build(); ``` diff --git a/src/main/java/com/ararahq/arara/sdk/config/AraraConfig.java b/src/main/java/com/ararahq/arara/sdk/config/AraraConfig.java index 6313239..19a17fe 100644 --- a/src/main/java/com/ararahq/arara/sdk/config/AraraConfig.java +++ b/src/main/java/com/ararahq/arara/sdk/config/AraraConfig.java @@ -11,7 +11,7 @@ @Builder public class AraraConfig { @Builder.Default - String baseUrl = "https://api.ararahq.com/api"; + String baseUrl = "https://api.ararahq.com"; String apiKey; From a30204bb5865f828cf439c45d602cea3464a8c15 Mon Sep 17 00:00:00 2001 From: Micael Marques Date: Thu, 16 Jul 2026 00:29:17 -0300 Subject: [PATCH 2/3] feat: paridade de cobertura (contacts, conversations, wallet, numbers, smart-links, api-keys, organizations) --- .../java/com/ararahq/arara/sdk/Arara.java | 21 ++++ .../arara/sdk/http/AraraHttpClient.java | 98 +++++++++++++++---- .../sdk/models/AutoRechargeSettings.java | 21 ++++ .../sdk/models/BusinessProfilePatch.java | 25 +++++ .../sdk/models/BusinessProfileResponse.java | 32 ++++++ .../arara/sdk/models/ContactMessageItem.java | 21 ++++ .../sdk/models/ContactMessagesResponse.java | 18 ++++ .../arara/sdk/models/ContactPatchRequest.java | 18 ++++ .../arara/sdk/models/ContactRequest.java | 19 ++++ .../arara/sdk/models/ContactResponse.java | 34 +++++++ .../arara/sdk/models/ContactsBatchError.java | 17 ++++ .../sdk/models/ContactsBatchResponse.java | 21 ++++ .../sdk/models/ContactsListResponse.java | 20 ++++ .../models/ContactsReactivationCandidate.java | 18 ++++ .../models/ContactsReactivationResponse.java | 17 ++++ .../sdk/models/ContactsStatsResponse.java | 20 ++++ .../sdk/models/ConversationReplyRequest.java | 17 ++++ .../CreateWhatsAppSmartLinkRequest.java | 18 ++++ .../arara/sdk/models/GeneratedApiKey.java | 15 +++ .../ararahq/arara/sdk/models/NumberCard.java | 31 ++++++ .../arara/sdk/models/NumbersResponse.java | 17 ++++ .../ararahq/arara/sdk/models/NumbersSlot.java | 21 ++++ .../sdk/models/OrganizationPlanResponse.java | 23 +++++ .../sdk/models/RequestNumberRequest.java | 19 ++++ .../sdk/models/UpdateAutoRechargeRequest.java | 18 ++++ .../arara/sdk/models/UpdateNumberRequest.java | 18 ++++ .../UpdateWhatsAppSmartLinkRequest.java | 17 ++++ .../arara/sdk/models/WalletTransaction.java | 23 +++++ .../sdk/models/WalletTransactionPage.java | 20 ++++ .../sdk/models/WhatsAppSmartLinkResponse.java | 25 +++++ .../arara/sdk/services/ApiKeyService.java | 43 ++++++++ .../arara/sdk/services/ContactService.java | 93 ++++++++++++++++++ .../sdk/services/ConversationService.java | 77 +++++++++++++++ .../arara/sdk/services/NumberService.java | 81 +++++++++++++++ .../sdk/services/OrganizationService.java | 53 ++++++++++ .../arara/sdk/services/SmartLinkService.java | 56 +++++++++++ .../arara/sdk/services/WalletService.java | 41 ++++++++ 37 files changed, 1128 insertions(+), 18 deletions(-) create mode 100644 src/main/java/com/ararahq/arara/sdk/models/AutoRechargeSettings.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/BusinessProfilePatch.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/BusinessProfileResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactMessageItem.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactMessagesResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactPatchRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactsBatchError.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactsBatchResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactsListResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationCandidate.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ContactsStatsResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/ConversationReplyRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/CreateWhatsAppSmartLinkRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/GeneratedApiKey.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/NumberCard.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/NumbersResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/NumbersSlot.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/OrganizationPlanResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/RequestNumberRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/UpdateAutoRechargeRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/UpdateNumberRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/UpdateWhatsAppSmartLinkRequest.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/WalletTransaction.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/WalletTransactionPage.java create mode 100644 src/main/java/com/ararahq/arara/sdk/models/WhatsAppSmartLinkResponse.java create mode 100644 src/main/java/com/ararahq/arara/sdk/services/ApiKeyService.java create mode 100644 src/main/java/com/ararahq/arara/sdk/services/ContactService.java create mode 100644 src/main/java/com/ararahq/arara/sdk/services/ConversationService.java create mode 100644 src/main/java/com/ararahq/arara/sdk/services/NumberService.java create mode 100644 src/main/java/com/ararahq/arara/sdk/services/OrganizationService.java create mode 100644 src/main/java/com/ararahq/arara/sdk/services/SmartLinkService.java create mode 100644 src/main/java/com/ararahq/arara/sdk/services/WalletService.java diff --git a/src/main/java/com/ararahq/arara/sdk/Arara.java b/src/main/java/com/ararahq/arara/sdk/Arara.java index b0a700a..8474112 100644 --- a/src/main/java/com/ararahq/arara/sdk/Arara.java +++ b/src/main/java/com/ararahq/arara/sdk/Arara.java @@ -2,10 +2,17 @@ import com.ararahq.arara.sdk.config.AraraConfig; import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.services.ApiKeyService; import com.ararahq.arara.sdk.services.CampaignService; +import com.ararahq.arara.sdk.services.ContactService; +import com.ararahq.arara.sdk.services.ConversationService; import com.ararahq.arara.sdk.services.MessageService; +import com.ararahq.arara.sdk.services.NumberService; +import com.ararahq.arara.sdk.services.OrganizationService; +import com.ararahq.arara.sdk.services.SmartLinkService; import com.ararahq.arara.sdk.services.TemplateService; import com.ararahq.arara.sdk.services.UserService; +import com.ararahq.arara.sdk.services.WalletService; import lombok.Getter; import java.time.Duration; @@ -20,6 +27,13 @@ public class Arara { private final UserService users; private final CampaignService campaigns; private final TemplateService templates; + private final ContactService contacts; + private final ConversationService conversations; + private final WalletService wallet; + private final NumberService numbers; + private final SmartLinkService smartLinks; + private final ApiKeyService apiKeys; + private final OrganizationService organizations; private Arara(AraraConfig config) { if (config.getApiKey() == null || config.getApiKey().isEmpty()) { @@ -31,6 +45,13 @@ private Arara(AraraConfig config) { this.users = new UserService(httpClient); this.campaigns = new CampaignService(httpClient); this.templates = new TemplateService(httpClient); + this.contacts = new ContactService(httpClient); + this.conversations = new ConversationService(httpClient); + this.wallet = new WalletService(httpClient); + this.numbers = new NumberService(httpClient); + this.smartLinks = new SmartLinkService(httpClient); + this.apiKeys = new ApiKeyService(httpClient); + this.organizations = new OrganizationService(httpClient); } /** diff --git a/src/main/java/com/ararahq/arara/sdk/http/AraraHttpClient.java b/src/main/java/com/ararahq/arara/sdk/http/AraraHttpClient.java index ea8de77..3860822 100644 --- a/src/main/java/com/ararahq/arara/sdk/http/AraraHttpClient.java +++ b/src/main/java/com/ararahq/arara/sdk/http/AraraHttpClient.java @@ -56,25 +56,56 @@ public AraraHttpClient(AraraConfig config) { * Performs a GET request. */ public T get(String path, Class responseType) { - Request request = new Request.Builder() - .url(baseUrl + path) - .get() - .build(); - return execute(request, responseType); + return execute(buildGet(path), responseType); + } + + /** + * Performs a GET request with a generic response type. + */ + public T get(String path, TypeReference responseType) { + return execute(buildGet(path), responseType); } /** * Performs a POST request with JSON body. */ public T post(String path, Object body, Class responseType) { - return requestWithBody("POST", path, body, responseType); + return execute(buildBody("POST", path, body), responseType); + } + + /** + * Performs a POST request with a generic response type. + */ + public T post(String path, Object body, TypeReference responseType) { + return execute(buildBody("POST", path, body), responseType); + } + + /** + * Performs a PUT request with JSON body. + */ + public T put(String path, Object body, Class responseType) { + return execute(buildBody("PUT", path, body), responseType); + } + + /** + * Performs a PUT request with a generic response type. + */ + public T put(String path, Object body, TypeReference responseType) { + return execute(buildBody("PUT", path, body), responseType); } /** * Performs a PATCH request with JSON body. */ public T patch(String path, Object body, Class responseType) { - return requestWithBody("PATCH", path, body, responseType); + return execute(buildBody("PATCH", path, body), responseType); + } + + /** + * Performs a PATCH request with a generic response type. + */ + public T patch(String path, Object body, TypeReference responseType) { + return execute(buildBody("PATCH", path, body), responseType); } /** @@ -88,33 +119,64 @@ public void delete(String path) { execute(request, Void.class); } - private T requestWithBody(String method, String path, Object body, Class responseType) { - try { - String json = objectMapper.writeValueAsString(body); - RequestBody requestBody = RequestBody.create(json, JSON); + private Request buildGet(String path) { + return new Request.Builder() + .url(baseUrl + path) + .get() + .build(); + } - Request request = new Request.Builder() + private Request buildBody(String method, String path, Object body) { + try { + RequestBody requestBody = body == null + ? RequestBody.create("", JSON) + : RequestBody.create(objectMapper.writeValueAsString(body), JSON); + return new Request.Builder() .url(baseUrl + path) .method(method, requestBody) .build(); - - return execute(request, responseType); } catch (IOException e) { throw new AraraException("Error serializing object to JSON", e); } } private T execute(Request request, Class responseType) { + if (responseType == Void.class) { + call(request, true); + return null; + } + String body = call(request, false); + if (body == null || body.isEmpty()) { + return null; + } + try { + return objectMapper.readValue(body, responseType); + } catch (IOException e) { + throw new AraraNetworkException("Error deserializing Arara API response", e); + } + } + + private T execute(Request request, TypeReference responseType) { + String body = call(request, false); + if (body == null || body.isEmpty()) { + return null; + } + try { + return objectMapper.readValue(body, responseType); + } catch (IOException e) { + throw new AraraNetworkException("Error deserializing Arara API response", e); + } + } + + private String call(Request request, boolean discardBody) { try (Response response = httpClient.newCall(request).execute()) { if (!response.isSuccessful()) { handleErrorResponse(response); } - - if (responseType == Void.class || response.body() == null) { + if (discardBody || response.body() == null) { return null; } - - return objectMapper.readValue(response.body().string(), responseType); + return response.body().string(); } catch (IOException e) { log.error("Network error accessing Arara API: {}", request.url(), e); throw new AraraNetworkException("Communication failure with Arara API", e); diff --git a/src/main/java/com/ararahq/arara/sdk/models/AutoRechargeSettings.java b/src/main/java/com/ararahq/arara/sdk/models/AutoRechargeSettings.java new file mode 100644 index 0000000..88159c3 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/AutoRechargeSettings.java @@ -0,0 +1,21 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.math.BigDecimal; +import java.time.Instant; + +/** + * Current auto-recharge configuration for the wallet. + */ +@Value +@Builder +@Jacksonized +public class AutoRechargeSettings { + boolean enabled; + BigDecimal threshold; + BigDecimal amount; + Instant lastAttemptAt; + String lastFailureReason; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/BusinessProfilePatch.java b/src/main/java/com/ararahq/arara/sdk/models/BusinessProfilePatch.java new file mode 100644 index 0000000..ffc20ca --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/BusinessProfilePatch.java @@ -0,0 +1,25 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; +import java.util.Map; + +/** + * Payload for patching the organization's WhatsApp business profile. + */ +@Value +@Builder +@Jacksonized +public class BusinessProfilePatch { + String displayName; + String vertical; + String description; + String aboutShort; + String email; + List websites; + Map businessHours; + String profilePhotoUrl; + String awayMessage; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/BusinessProfileResponse.java b/src/main/java/com/ararahq/arara/sdk/models/BusinessProfileResponse.java new file mode 100644 index 0000000..eb9b4b2 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/BusinessProfileResponse.java @@ -0,0 +1,32 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.time.Instant; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +/** + * The organization's WhatsApp business profile and Meta sync state. + */ +@Value +@Builder +@Jacksonized +public class BusinessProfileResponse { + UUID id; + String displayName; + String vertical; + String description; + String aboutShort; + String email; + List websites; + Map businessHours; + String profilePhotoUrl; + String awayMessage; + String metaSyncStatus; + Instant metaSyncedAt; + String metaSyncError; + Instant updatedAt; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactMessageItem.java b/src/main/java/com/ararahq/arara/sdk/models/ContactMessageItem.java new file mode 100644 index 0000000..77ae607 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactMessageItem.java @@ -0,0 +1,21 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.UUID; + +/** + * A single message exchanged with a contact. + */ +@Value +@Builder +@Jacksonized +public class ContactMessageItem { + UUID id; + String direction; + String status; + String templateName; + String body; + String createdAt; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactMessagesResponse.java b/src/main/java/com/ararahq/arara/sdk/models/ContactMessagesResponse.java new file mode 100644 index 0000000..9d1e706 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactMessagesResponse.java @@ -0,0 +1,18 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; + +/** + * Recent message history for a contact. + */ +@Value +@Builder +@Jacksonized +public class ContactMessagesResponse { + String phone; + int total; + List messages; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactPatchRequest.java b/src/main/java/com/ararahq/arara/sdk/models/ContactPatchRequest.java new file mode 100644 index 0000000..b6fddc3 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactPatchRequest.java @@ -0,0 +1,18 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; + +/** + * Payload for patching an existing contact. + */ +@Value +@Builder +@Jacksonized +public class ContactPatchRequest { + String name; + String email; + List tags; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactRequest.java b/src/main/java/com/ararahq/arara/sdk/models/ContactRequest.java new file mode 100644 index 0000000..7cdc588 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactRequest.java @@ -0,0 +1,19 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.Map; + +/** + * Payload for creating or updating a contact in a batch import. + */ +@Value +@Builder +@Jacksonized +public class ContactRequest { + String name; + String phone; + String email; + Map attributes; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactResponse.java b/src/main/java/com/ararahq/arara/sdk/models/ContactResponse.java new file mode 100644 index 0000000..6ebdec6 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactResponse.java @@ -0,0 +1,34 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +/** + * Represents a single contact and its engagement metadata. + */ +@Value +@Builder +@Jacksonized +public class ContactResponse { + UUID id; + String name; + String phone; + String email; + Map attributes; + List tags; + String createdAt; + String lifecycle; + String source; + long outboundCount; + long inboundCount; + String firstSeenAt; + String lastOutboundAt; + String lastInboundAt; + String lastMessageAt; + String optOutAt; + String lastTemplateName; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactsBatchError.java b/src/main/java/com/ararahq/arara/sdk/models/ContactsBatchError.java new file mode 100644 index 0000000..f0cd096 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactsBatchError.java @@ -0,0 +1,17 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * A single rejected row from a contact batch import. + */ +@Value +@Builder +@Jacksonized +public class ContactsBatchError { + int index; + String phone; + String reason; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactsBatchResponse.java b/src/main/java/com/ararahq/arara/sdk/models/ContactsBatchResponse.java new file mode 100644 index 0000000..93bf0af --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactsBatchResponse.java @@ -0,0 +1,21 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; +import java.util.UUID; + +/** + * Summary of a contact batch import. + */ +@Value +@Builder +@Jacksonized +public class ContactsBatchResponse { + UUID importId; + int created; + int updated; + int skipped; + List errors; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactsListResponse.java b/src/main/java/com/ararahq/arara/sdk/models/ContactsListResponse.java new file mode 100644 index 0000000..3b2b577 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactsListResponse.java @@ -0,0 +1,20 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; + +/** + * Paginated list of contacts. + */ +@Value +@Builder +@Jacksonized +public class ContactsListResponse { + List contacts; + long total; + int page; + int size; + int totalPages; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationCandidate.java b/src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationCandidate.java new file mode 100644 index 0000000..8365327 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationCandidate.java @@ -0,0 +1,18 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * A contact eligible for a reactivation campaign. + */ +@Value +@Builder +@Jacksonized +public class ContactsReactivationCandidate { + String phone; + String name; + String lastMessageAt; + String lastTemplateName; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationResponse.java b/src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationResponse.java new file mode 100644 index 0000000..01ac767 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactsReactivationResponse.java @@ -0,0 +1,17 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; + +/** + * List of contacts eligible for reactivation. + */ +@Value +@Builder +@Jacksonized +public class ContactsReactivationResponse { + long total; + List candidates; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ContactsStatsResponse.java b/src/main/java/com/ararahq/arara/sdk/models/ContactsStatsResponse.java new file mode 100644 index 0000000..d8f17a0 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ContactsStatsResponse.java @@ -0,0 +1,20 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * Aggregate contact counts by lifecycle stage. + */ +@Value +@Builder +@Jacksonized +public class ContactsStatsResponse { + long total; + long newCount; + long engaged; + long silent; + long dormant; + long optedOut; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/ConversationReplyRequest.java b/src/main/java/com/ararahq/arara/sdk/models/ConversationReplyRequest.java new file mode 100644 index 0000000..3d693e7 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/ConversationReplyRequest.java @@ -0,0 +1,17 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.UUID; + +/** + * Payload for replying with free text inside an open conversation window. + */ +@Value +@Builder +@Jacksonized +public class ConversationReplyRequest { + UUID conversationId; + String body; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/CreateWhatsAppSmartLinkRequest.java b/src/main/java/com/ararahq/arara/sdk/models/CreateWhatsAppSmartLinkRequest.java new file mode 100644 index 0000000..ecd9a7f --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/CreateWhatsAppSmartLinkRequest.java @@ -0,0 +1,18 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * Payload for creating a WhatsApp smart link. + */ +@Value +@Builder +@Jacksonized +public class CreateWhatsAppSmartLinkRequest { + String name; + String phoneNumber; + String defaultText; + String qrCodeColor; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/GeneratedApiKey.java b/src/main/java/com/ararahq/arara/sdk/models/GeneratedApiKey.java new file mode 100644 index 0000000..cc3bde1 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/GeneratedApiKey.java @@ -0,0 +1,15 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * A freshly generated API key, shown once in plaintext. + */ +@Value +@Builder +@Jacksonized +public class GeneratedApiKey { + String plainTextKey; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/NumberCard.java b/src/main/java/com/ararahq/arara/sdk/models/NumberCard.java new file mode 100644 index 0000000..978be3b --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/NumberCard.java @@ -0,0 +1,31 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.time.Instant; + +/** + * A dedicated or shared phone number with health metadata. + */ +@Value +@Builder +@Jacksonized +public class NumberCard { + String id; + String name; + String alias; + String description; + String phoneNumber; + String type; + boolean isDefault; + String status; + String qualityScore; + String messagingTier; + Instant verifiedAt; + Instant lastHealthCheckAt; + String provider; + Instant createdAt; + long messagesLast7d; + long messagesLast30d; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/NumbersResponse.java b/src/main/java/com/ararahq/arara/sdk/models/NumbersResponse.java new file mode 100644 index 0000000..65c19e3 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/NumbersResponse.java @@ -0,0 +1,17 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; + +/** + * Number cards plus plan slot info. + */ +@Value +@Builder +@Jacksonized +public class NumbersResponse { + List numbers; + NumbersSlot slot; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/NumbersSlot.java b/src/main/java/com/ararahq/arara/sdk/models/NumbersSlot.java new file mode 100644 index 0000000..7325239 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/NumbersSlot.java @@ -0,0 +1,21 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * Plan slot usage for dedicated numbers. + */ +@Value +@Builder +@Jacksonized +public class NumbersSlot { + int used; + int max; + String planLabel; + boolean atCap; + boolean noEntitlement; + int monthlyPriceCents; + int monthlyTotalCents; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/OrganizationPlanResponse.java b/src/main/java/com/ararahq/arara/sdk/models/OrganizationPlanResponse.java new file mode 100644 index 0000000..5fa09c5 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/OrganizationPlanResponse.java @@ -0,0 +1,23 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.time.Instant; +import java.util.List; + +/** + * Current plan, per-category pricing and enabled features for the organization. + */ +@Value +@Builder +@Jacksonized +public class OrganizationPlanResponse { + String current; + int monthlyPriceCents; + int marketingPriceCents; + int utilityPriceCents; + int authPriceCents; + List features; + Instant nextBillingAt; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/RequestNumberRequest.java b/src/main/java/com/ararahq/arara/sdk/models/RequestNumberRequest.java new file mode 100644 index 0000000..36ccec6 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/RequestNumberRequest.java @@ -0,0 +1,19 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * Payload for requesting a new dedicated number. + */ +@Value +@Builder +@Jacksonized +public class RequestNumberRequest { + String reason; + String expectedVolume; + String areaCode; + String displayName; + String profilePictureUrl; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/UpdateAutoRechargeRequest.java b/src/main/java/com/ararahq/arara/sdk/models/UpdateAutoRechargeRequest.java new file mode 100644 index 0000000..52167b3 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/UpdateAutoRechargeRequest.java @@ -0,0 +1,18 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.math.BigDecimal; + +/** + * Payload for updating auto-recharge settings. + */ +@Value +@Builder +@Jacksonized +public class UpdateAutoRechargeRequest { + Boolean enabled; + BigDecimal threshold; + BigDecimal amount; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/UpdateNumberRequest.java b/src/main/java/com/ararahq/arara/sdk/models/UpdateNumberRequest.java new file mode 100644 index 0000000..06aca99 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/UpdateNumberRequest.java @@ -0,0 +1,18 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * Payload for updating a number's alias, name, description or default flag. + */ +@Value +@Builder +@Jacksonized +public class UpdateNumberRequest { + String alias; + Boolean isDefault; + String name; + String description; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/UpdateWhatsAppSmartLinkRequest.java b/src/main/java/com/ararahq/arara/sdk/models/UpdateWhatsAppSmartLinkRequest.java new file mode 100644 index 0000000..7adfc55 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/UpdateWhatsAppSmartLinkRequest.java @@ -0,0 +1,17 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; + +/** + * Payload for updating a WhatsApp smart link. + */ +@Value +@Builder +@Jacksonized +public class UpdateWhatsAppSmartLinkRequest { + String name; + String defaultText; + String qrCodeColor; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/WalletTransaction.java b/src/main/java/com/ararahq/arara/sdk/models/WalletTransaction.java new file mode 100644 index 0000000..eb0edf5 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/WalletTransaction.java @@ -0,0 +1,23 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.math.BigDecimal; +import java.time.Instant; + +/** + * A single wallet ledger entry. + */ +@Value +@Builder +@Jacksonized +public class WalletTransaction { + String id; + BigDecimal amount; + String type; + String description; + String referenceId; + String mode; + Instant createdAt; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/WalletTransactionPage.java b/src/main/java/com/ararahq/arara/sdk/models/WalletTransactionPage.java new file mode 100644 index 0000000..cbdfdfa --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/WalletTransactionPage.java @@ -0,0 +1,20 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.util.List; + +/** + * Paginated wallet transaction history. + */ +@Value +@Builder +@Jacksonized +public class WalletTransactionPage { + List content; + int page; + int size; + long totalElements; + int totalPages; +} diff --git a/src/main/java/com/ararahq/arara/sdk/models/WhatsAppSmartLinkResponse.java b/src/main/java/com/ararahq/arara/sdk/models/WhatsAppSmartLinkResponse.java new file mode 100644 index 0000000..06746d4 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/models/WhatsAppSmartLinkResponse.java @@ -0,0 +1,25 @@ +package com.ararahq.arara.sdk.models; + +import lombok.Builder; +import lombok.Value; +import lombok.extern.jackson.Jacksonized; +import java.time.Instant; +import java.util.UUID; + +/** + * A WhatsApp smart link with its short URL and click count. + */ +@Value +@Builder +@Jacksonized +public class WhatsAppSmartLinkResponse { + UUID id; + String name; + String phoneNumber; + String defaultText; + String qrCodeColor; + String code; + String shortUrl; + Instant createdAt; + long clicks; +} diff --git a/src/main/java/com/ararahq/arara/sdk/services/ApiKeyService.java b/src/main/java/com/ararahq/arara/sdk/services/ApiKeyService.java new file mode 100644 index 0000000..3e3cb7e --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/services/ApiKeyService.java @@ -0,0 +1,43 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.GeneratedApiKey; +import com.fasterxml.jackson.core.type.TypeReference; + +import java.util.List; +import java.util.Map; + +/** + * Service for managing API keys. + */ +public class ApiKeyService { + private static final String BASE = "/v1/api-keys"; + + private final AraraHttpClient httpClient; + + public ApiKeyService(AraraHttpClient httpClient) { + this.httpClient = httpClient; + } + + /** + * Lists API keys. GET /v1/api-keys + */ + public List> list() { + return httpClient.get(BASE, new TypeReference>>() { + }); + } + + /** + * Creates an API key. POST /v1/api-keys?mode=LIVE + */ + public GeneratedApiKey create(String mode) { + return httpClient.post(BASE + "?mode=" + mode, null, GeneratedApiKey.class); + } + + /** + * Creates a LIVE API key. POST /v1/api-keys?mode=LIVE + */ + public GeneratedApiKey create() { + return create("LIVE"); + } +} diff --git a/src/main/java/com/ararahq/arara/sdk/services/ContactService.java b/src/main/java/com/ararahq/arara/sdk/services/ContactService.java new file mode 100644 index 0000000..ee11ecf --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/services/ContactService.java @@ -0,0 +1,93 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.ContactMessagesResponse; +import com.ararahq.arara.sdk.models.ContactPatchRequest; +import com.ararahq.arara.sdk.models.ContactRequest; +import com.ararahq.arara.sdk.models.ContactResponse; +import com.ararahq.arara.sdk.models.ContactsBatchResponse; +import com.ararahq.arara.sdk.models.ContactsListResponse; +import com.ararahq.arara.sdk.models.ContactsReactivationResponse; +import com.ararahq.arara.sdk.models.ContactsStatsResponse; +import com.ararahq.arara.sdk.utils.ValidationUtils; +import com.fasterxml.jackson.core.type.TypeReference; + +import java.util.List; +import java.util.Map; + +/** + * Service for managing contacts and their engagement history. + */ +public class ContactService { + private final AraraHttpClient httpClient; + + public ContactService(AraraHttpClient httpClient) { + this.httpClient = httpClient; + } + + /** + * Lists contacts. GET /v1/contacts + */ + public ContactsListResponse list(int page, int size, String query, String lifecycle) { + StringBuilder path = new StringBuilder("/v1/contacts?page=").append(page).append("&size=").append(size); + if (query != null) { + path.append("&q=").append(query); + } + if (lifecycle != null) { + path.append("&lifecycle=").append(lifecycle); + } + return httpClient.get(path.toString(), ContactsListResponse.class); + } + + /** + * Imports a batch of contacts. POST /v1/contacts/batch + */ + public ContactsBatchResponse importBatch(List contacts) { + ValidationUtils.checkNotNull(contacts, "contacts"); + return httpClient.post("/v1/contacts/batch", contacts, ContactsBatchResponse.class); + } + + /** + * Returns aggregate contact stats. GET /v1/contacts/stats + */ + public ContactsStatsResponse stats() { + return httpClient.get("/v1/contacts/stats", ContactsStatsResponse.class); + } + + /** + * Lists contacts eligible for reactivation. GET /v1/contacts/reactivation + */ + public ContactsReactivationResponse reactivationCandidates(int limit) { + return httpClient.get("/v1/contacts/reactivation?limit=" + limit, ContactsReactivationResponse.class); + } + + /** + * Lists distinct contact tags. GET /v1/contacts/tags + */ + public Map> listTags() { + return httpClient.get("/v1/contacts/tags", new TypeReference>>() { + }); + } + + /** + * Retrieves a contact by phone. GET /v1/contacts/{phone} + */ + public ContactResponse get(String phone) { + return httpClient.get("/v1/contacts/" + phone, ContactResponse.class); + } + + /** + * Patches a contact by phone. PATCH /v1/contacts/{phone} + */ + public ContactResponse update(String phone, ContactPatchRequest request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.patch("/v1/contacts/" + phone, request, ContactResponse.class); + } + + /** + * Lists recent messages for a contact. GET /v1/contacts/{phone}/messages + */ + public ContactMessagesResponse messages(String phone, int limit) { + return httpClient.get("/v1/contacts/" + phone + "/messages?limit=" + limit, ContactMessagesResponse.class); + } +} diff --git a/src/main/java/com/ararahq/arara/sdk/services/ConversationService.java b/src/main/java/com/ararahq/arara/sdk/services/ConversationService.java new file mode 100644 index 0000000..a55578f --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/services/ConversationService.java @@ -0,0 +1,77 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.ConversationReplyRequest; +import com.ararahq.arara.sdk.utils.ValidationUtils; +import com.fasterxml.jackson.core.type.TypeReference; + +import java.util.List; +import java.util.Map; + +/** + * Service for managing inbox conversations. + */ +public class ConversationService { + private static final TypeReference> MAP_TYPE = + new TypeReference>() { + }; + + private final AraraHttpClient httpClient; + + public ConversationService(AraraHttpClient httpClient) { + this.httpClient = httpClient; + } + + /** + * Lists conversations. GET /v1/conversations + */ + public Map list(String status, String leadStatus, int page, int size) { + StringBuilder path = new StringBuilder("/v1/conversations?page=").append(page).append("&size=").append(size); + if (status != null) { + path.append("&status=").append(status); + } + if (leadStatus != null) { + path.append("&leadStatus=").append(leadStatus); + } + return httpClient.get(path.toString(), MAP_TYPE); + } + + /** + * Returns lead counts by status. GET /v1/conversations/lead-stats + */ + public Map leadStats() { + return httpClient.get("/v1/conversations/lead-stats", MAP_TYPE); + } + + /** + * Lists messages of a conversation. GET /v1/conversations/{conversationId}/messages + */ + public Map messages(String conversationId, int page, int size) { + return httpClient.get( + "/v1/conversations/" + conversationId + "/messages?page=" + page + "&size=" + size, MAP_TYPE); + } + + /** + * Sends a free-text reply. POST /v1/conversations/reply + */ + public Map reply(ConversationReplyRequest request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.post("/v1/conversations/reply", request, MAP_TYPE); + } + + /** + * Updates a conversation status. PATCH /v1/conversations/{conversationId}/status + */ + public Map updateStatus(String conversationId, String status) { + return httpClient.patch( + "/v1/conversations/" + conversationId + "/status", Map.of("status", status), MAP_TYPE); + } + + /** + * Checks 24h window status for phones. POST /v1/conversations/window-status + */ + public Map windowStatus(List phones) { + ValidationUtils.checkNotNull(phones, "phones"); + return httpClient.post("/v1/conversations/window-status", Map.of("phones", phones), MAP_TYPE); + } +} diff --git a/src/main/java/com/ararahq/arara/sdk/services/NumberService.java b/src/main/java/com/ararahq/arara/sdk/services/NumberService.java new file mode 100644 index 0000000..4d20f50 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/services/NumberService.java @@ -0,0 +1,81 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.NumbersResponse; +import com.ararahq.arara.sdk.models.RequestNumberRequest; +import com.ararahq.arara.sdk.models.UpdateNumberRequest; +import com.ararahq.arara.sdk.utils.ValidationUtils; +import com.fasterxml.jackson.core.type.TypeReference; + +import java.util.List; +import java.util.Map; + +/** + * Service for managing the organization's dedicated numbers. + */ +public class NumberService { + private static final String BASE = "/v1/organizations/me/numbers"; + private static final TypeReference> MAP_TYPE = + new TypeReference>() { + }; + private static final TypeReference>> MAP_LIST_TYPE = + new TypeReference>>() { + }; + + private final AraraHttpClient httpClient; + + public NumberService(AraraHttpClient httpClient) { + this.httpClient = httpClient; + } + + /** + * Lists numbers and plan slot info. GET /v1/organizations/me/numbers + */ + public NumbersResponse list() { + return httpClient.get(BASE, NumbersResponse.class); + } + + /** + * Updates a number. PATCH /v1/organizations/me/numbers/{id} + */ + public Map update(String id, UpdateNumberRequest request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.patch(BASE + "/" + id, request, MAP_TYPE); + } + + /** + * Soft-deletes a number. DELETE /v1/organizations/me/numbers/{id} + */ + public void delete(String id) { + httpClient.delete(BASE + "/" + id); + } + + /** + * Requests a new dedicated number. POST /v1/organizations/me/numbers/request + */ + public Map request(RequestNumberRequest request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.post(BASE + "/request", request, MAP_TYPE); + } + + /** + * Lists pending and resolved number requests. GET /v1/organizations/me/numbers/requests + */ + public List> listRequests() { + return httpClient.get(BASE + "/requests", MAP_LIST_TYPE); + } + + /** + * Triggers a provider sync. POST /v1/organizations/me/numbers/{id}/sync + */ + public Map sync(String id) { + return httpClient.post(BASE + "/" + id + "/sync", null, MAP_TYPE); + } + + /** + * Returns warming recommendations. GET /v1/organizations/me/numbers/{id}/warming + */ + public Map warming(String id) { + return httpClient.get(BASE + "/" + id + "/warming", MAP_TYPE); + } +} diff --git a/src/main/java/com/ararahq/arara/sdk/services/OrganizationService.java b/src/main/java/com/ararahq/arara/sdk/services/OrganizationService.java new file mode 100644 index 0000000..395a2fc --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/services/OrganizationService.java @@ -0,0 +1,53 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.BusinessProfilePatch; +import com.ararahq.arara.sdk.models.BusinessProfileResponse; +import com.ararahq.arara.sdk.models.OrganizationPlanResponse; +import com.ararahq.arara.sdk.utils.ValidationUtils; +import com.fasterxml.jackson.core.type.TypeReference; + +import java.util.Map; + +/** + * Service for the authenticated organization's plan and business profile. + */ +public class OrganizationService { + private final AraraHttpClient httpClient; + + public OrganizationService(AraraHttpClient httpClient) { + this.httpClient = httpClient; + } + + /** + * Returns the organization's business profile. GET /v1/organizations/me/business-profile + */ + public BusinessProfileResponse me() { + return httpClient.get("/v1/organizations/me/business-profile", BusinessProfileResponse.class); + } + + /** + * Patches the organization's business profile. PATCH /v1/organizations/me/business-profile + */ + public BusinessProfileResponse updateBusinessProfile(BusinessProfilePatch request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.patch( + "/v1/organizations/me/business-profile", request, BusinessProfileResponse.class); + } + + /** + * Returns the organization's current plan. GET /v1/organizations/me/plan + */ + public OrganizationPlanResponse getPlan() { + return httpClient.get("/v1/organizations/me/plan", OrganizationPlanResponse.class); + } + + /** + * Downgrades the organization to a plan. PATCH /v1/organizations/me/plan + */ + public Map changePlan(String plan) { + return httpClient.patch( + "/v1/organizations/me/plan", Map.of("plan", plan), new TypeReference>() { + }); + } +} diff --git a/src/main/java/com/ararahq/arara/sdk/services/SmartLinkService.java b/src/main/java/com/ararahq/arara/sdk/services/SmartLinkService.java new file mode 100644 index 0000000..e58ff09 --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/services/SmartLinkService.java @@ -0,0 +1,56 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.CreateWhatsAppSmartLinkRequest; +import com.ararahq.arara.sdk.models.UpdateWhatsAppSmartLinkRequest; +import com.ararahq.arara.sdk.models.WhatsAppSmartLinkResponse; +import com.ararahq.arara.sdk.utils.ValidationUtils; +import com.fasterxml.jackson.core.type.TypeReference; + +import java.util.List; +import java.util.Map; + +/** + * Service for managing WhatsApp smart links. + */ +public class SmartLinkService { + private static final String BASE = "/v1/smart-links/whatsapp"; + + private final AraraHttpClient httpClient; + + public SmartLinkService(AraraHttpClient httpClient) { + this.httpClient = httpClient; + } + + /** + * Creates a smart link. POST /v1/smart-links/whatsapp + */ + public WhatsAppSmartLinkResponse create(CreateWhatsAppSmartLinkRequest request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.post(BASE, request, WhatsAppSmartLinkResponse.class); + } + + /** + * Updates a smart link. PUT /v1/smart-links/whatsapp/{id} + */ + public WhatsAppSmartLinkResponse update(String id, UpdateWhatsAppSmartLinkRequest request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.put(BASE + "/" + id, request, WhatsAppSmartLinkResponse.class); + } + + /** + * Lists smart links. GET /v1/smart-links/whatsapp + */ + public List list() { + return httpClient.get(BASE, new TypeReference>() { + }); + } + + /** + * Returns click stats for a smart link. GET /v1/smart-links/whatsapp/{id}/stats + */ + public Map stats(String id) { + return httpClient.get(BASE + "/" + id + "/stats", new TypeReference>() { + }); + } +} diff --git a/src/main/java/com/ararahq/arara/sdk/services/WalletService.java b/src/main/java/com/ararahq/arara/sdk/services/WalletService.java new file mode 100644 index 0000000..8e485fc --- /dev/null +++ b/src/main/java/com/ararahq/arara/sdk/services/WalletService.java @@ -0,0 +1,41 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.AutoRechargeSettings; +import com.ararahq.arara.sdk.models.UpdateAutoRechargeRequest; +import com.ararahq.arara.sdk.models.WalletTransactionPage; +import com.ararahq.arara.sdk.utils.ValidationUtils; + +/** + * Service for wallet balance transactions and auto-recharge settings. + */ +public class WalletService { + private final AraraHttpClient httpClient; + + public WalletService(AraraHttpClient httpClient) { + this.httpClient = httpClient; + } + + /** + * Lists wallet transactions. GET /v1/wallet/transactions + */ + public WalletTransactionPage transactions(int page, int size) { + return httpClient.get( + "/v1/wallet/transactions?page=" + page + "&size=" + size, WalletTransactionPage.class); + } + + /** + * Returns auto-recharge settings. GET /v1/wallet/auto-recharge + */ + public AutoRechargeSettings getAutoRecharge() { + return httpClient.get("/v1/wallet/auto-recharge", AutoRechargeSettings.class); + } + + /** + * Updates auto-recharge settings. PATCH /v1/wallet/auto-recharge + */ + public AutoRechargeSettings updateAutoRecharge(UpdateAutoRechargeRequest request) { + ValidationUtils.checkNotNull(request, "request"); + return httpClient.patch("/v1/wallet/auto-recharge", request, AutoRechargeSettings.class); + } +} From 28d078cbb42b76be5616d0180d6973435527f6f4 Mon Sep 17 00:00:00 2001 From: Micael Marques Date: Thu, 16 Jul 2026 01:20:14 -0300 Subject: [PATCH 3/3] test: cobre services novos e exclui DTOs Lombok do jacoco --- lombok.config | 2 + .../arara/sdk/http/AraraHttpClientTest.java | 123 +++++++++++ .../arara/sdk/services/ApiKeyServiceTest.java | 78 +++++++ .../sdk/services/ContactServiceTest.java | 203 ++++++++++++++++++ .../sdk/services/ConversationServiceTest.java | 157 ++++++++++++++ .../arara/sdk/services/NumberServiceTest.java | 156 ++++++++++++++ .../sdk/services/OrganizationServiceTest.java | 115 ++++++++++ .../sdk/services/SmartLinkServiceTest.java | 123 +++++++++++ .../arara/sdk/services/WalletServiceTest.java | 104 +++++++++ 9 files changed, 1061 insertions(+) create mode 100644 lombok.config create mode 100644 src/test/java/com/ararahq/arara/sdk/services/ApiKeyServiceTest.java create mode 100644 src/test/java/com/ararahq/arara/sdk/services/ContactServiceTest.java create mode 100644 src/test/java/com/ararahq/arara/sdk/services/ConversationServiceTest.java create mode 100644 src/test/java/com/ararahq/arara/sdk/services/NumberServiceTest.java create mode 100644 src/test/java/com/ararahq/arara/sdk/services/OrganizationServiceTest.java create mode 100644 src/test/java/com/ararahq/arara/sdk/services/SmartLinkServiceTest.java create mode 100644 src/test/java/com/ararahq/arara/sdk/services/WalletServiceTest.java diff --git a/lombok.config b/lombok.config new file mode 100644 index 0000000..a6645eb --- /dev/null +++ b/lombok.config @@ -0,0 +1,2 @@ +lombok.addLombokGeneratedAnnotation = true +config.stopBubbling = true diff --git a/src/test/java/com/ararahq/arara/sdk/http/AraraHttpClientTest.java b/src/test/java/com/ararahq/arara/sdk/http/AraraHttpClientTest.java index cfaf92b..aba0231 100644 --- a/src/test/java/com/ararahq/arara/sdk/http/AraraHttpClientTest.java +++ b/src/test/java/com/ararahq/arara/sdk/http/AraraHttpClientTest.java @@ -5,8 +5,10 @@ import com.ararahq.arara.sdk.exceptions.AraraAuthException; import com.ararahq.arara.sdk.exceptions.AraraNetworkException; import com.ararahq.arara.sdk.exceptions.AraraRateLimitException; +import com.fasterxml.jackson.core.type.TypeReference; import okhttp3.mockwebserver.MockResponse; import okhttp3.mockwebserver.MockWebServer; +import okhttp3.mockwebserver.RecordedRequest; import org.junit.jupiter.api.AfterEach; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.DisplayName; @@ -14,11 +16,14 @@ import java.io.IOException; import java.time.Duration; +import java.util.List; +import java.util.Map; import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertNotNull; import static org.junit.jupiter.api.Assertions.assertNull; import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; @DisplayName("AraraHttpClient Tests") class AraraHttpClientTest { @@ -232,6 +237,124 @@ void shouldNotRetryOnClientError() { assertEquals(1, mockWebServer.getRequestCount()); } + @Test + @DisplayName("should handle GET with generic TypeReference") + void shouldHandleGetWithTypeReference() { + mockWebServer.enqueue(new MockResponse() + .setBody("{\"name\":\"Generic\"}") + .setResponseCode(200)); + + Map response = client.get("test", new TypeReference>() { + }); + assertEquals("Generic", response.get("name")); + } + + @Test + @DisplayName("should return null when body is empty for TypeReference GET") + void shouldReturnNullForEmptyTypeReferenceBody() { + mockWebServer.enqueue(new MockResponse().setResponseCode(200)); + + Map response = client.get("test", new TypeReference>() { + }); + assertNull(response); + } + + @Test + @DisplayName("should handle POST with generic TypeReference") + void shouldHandlePostWithTypeReference() { + mockWebServer.enqueue(new MockResponse() + .setBody("[{\"name\":\"One\"}]") + .setResponseCode(200)); + + List> response = client.post("test", Map.of("k", "v"), + new TypeReference>>() { + }); + assertEquals("One", response.get(0).get("name")); + } + + @Test + @DisplayName("should handle successful PUT") + void shouldHandleSuccessfulPut() { + mockWebServer.enqueue(new MockResponse() + .setBody("{\"name\":\"Put\"}") + .setResponseCode(200)); + + TestResponse response = client.put("test", new TestResponse("Data"), TestResponse.class); + assertEquals("Put", response.name); + } + + @Test + @DisplayName("should handle PUT with generic TypeReference") + void shouldHandlePutWithTypeReference() { + mockWebServer.enqueue(new MockResponse() + .setBody("{\"name\":\"PutGeneric\"}") + .setResponseCode(200)); + + Map response = client.put("test", Map.of("k", "v"), + new TypeReference>() { + }); + assertEquals("PutGeneric", response.get("name")); + } + + @Test + @DisplayName("should handle successful PATCH") + void shouldHandleSuccessfulPatch() { + mockWebServer.enqueue(new MockResponse() + .setBody("{\"name\":\"Patched\"}") + .setResponseCode(200)); + + TestResponse response = client.patch("test", new TestResponse("Data"), TestResponse.class); + assertEquals("Patched", response.name); + } + + @Test + @DisplayName("should handle PATCH with generic TypeReference") + void shouldHandlePatchWithTypeReference() { + mockWebServer.enqueue(new MockResponse() + .setBody("{\"name\":\"PatchGeneric\"}") + .setResponseCode(200)); + + Map response = client.patch("test", Map.of("k", "v"), + new TypeReference>() { + }); + assertEquals("PatchGeneric", response.get("name")); + } + + @Test + @DisplayName("should send empty JSON body when payload is null") + void shouldSendEmptyBodyWhenPayloadNull() throws InterruptedException { + mockWebServer.enqueue(new MockResponse() + .setBody("{\"name\":\"NullBody\"}") + .setResponseCode(200)); + + TestResponse response = client.post("test", null, TestResponse.class); + + assertEquals("NullBody", response.name); + RecordedRequest recorded = mockWebServer.takeRequest(); + assertEquals("POST", recorded.getMethod()); + assertEquals("", recorded.getBody().readUtf8()); + } + + @Test + @DisplayName("should handle DELETE discarding the response body") + void shouldHandleDelete() throws InterruptedException { + mockWebServer.enqueue(new MockResponse().setResponseCode(204)); + + client.delete("test/1"); + + RecordedRequest recorded = mockWebServer.takeRequest(); + assertEquals("DELETE", recorded.getMethod()); + assertTrue(recorded.getPath().endsWith("test/1")); + } + + @Test + @DisplayName("should propagate error status on DELETE failure") + void shouldPropagateDeleteError() { + mockWebServer.enqueue(new MockResponse().setResponseCode(404)); + + assertThrows(AraraApiException.class, () -> client.delete("test/1")); + } + static class TestResponse { public String name; diff --git a/src/test/java/com/ararahq/arara/sdk/services/ApiKeyServiceTest.java b/src/test/java/com/ararahq/arara/sdk/services/ApiKeyServiceTest.java new file mode 100644 index 0000000..dd0befc --- /dev/null +++ b/src/test/java/com/ararahq/arara/sdk/services/ApiKeyServiceTest.java @@ -0,0 +1,78 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.GeneratedApiKey; +import com.fasterxml.jackson.core.type.TypeReference; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.ArgumentMatchers.isNull; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +@DisplayName("ApiKeyService Tests") +class ApiKeyServiceTest { + + private static final String BASE = "/v1/api-keys"; + + @Mock + private AraraHttpClient httpClient; + + private ApiKeyService apiKeyService; + + @BeforeEach + void setUp() { + apiKeyService = new ApiKeyService(httpClient); + } + + @Test + @DisplayName("should list API keys") + void shouldListApiKeys() { + List> expected = Arrays.asList(Map.of("id", "key_1")); + when(httpClient.get(eq(BASE), any(TypeReference.class))).thenReturn(expected); + + List> result = apiKeyService.list(); + + assertEquals(1, result.size()); + verify(httpClient, times(1)).get(eq(BASE), any(TypeReference.class)); + } + + @Test + @DisplayName("should create an API key with an explicit mode") + void shouldCreateWithMode() { + GeneratedApiKey expected = GeneratedApiKey.builder().plainTextKey("ara_live_abc").build(); + when(httpClient.post(eq(BASE + "?mode=TEST"), isNull(), eq(GeneratedApiKey.class))) + .thenReturn(expected); + + GeneratedApiKey result = apiKeyService.create("TEST"); + + assertEquals("ara_live_abc", result.getPlainTextKey()); + verify(httpClient, times(1)).post(eq(BASE + "?mode=TEST"), isNull(), eq(GeneratedApiKey.class)); + } + + @Test + @DisplayName("should create a LIVE API key by default") + void shouldCreateLiveByDefault() { + GeneratedApiKey expected = GeneratedApiKey.builder().plainTextKey("ara_live_xyz").build(); + when(httpClient.post(eq(BASE + "?mode=LIVE"), isNull(), eq(GeneratedApiKey.class))) + .thenReturn(expected); + + GeneratedApiKey result = apiKeyService.create(); + + assertEquals("ara_live_xyz", result.getPlainTextKey()); + verify(httpClient, times(1)).post(eq(BASE + "?mode=LIVE"), isNull(), eq(GeneratedApiKey.class)); + } +} diff --git a/src/test/java/com/ararahq/arara/sdk/services/ContactServiceTest.java b/src/test/java/com/ararahq/arara/sdk/services/ContactServiceTest.java new file mode 100644 index 0000000..4f5c996 --- /dev/null +++ b/src/test/java/com/ararahq/arara/sdk/services/ContactServiceTest.java @@ -0,0 +1,203 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.exceptions.AraraException; +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.ContactMessagesResponse; +import com.ararahq.arara.sdk.models.ContactPatchRequest; +import com.ararahq.arara.sdk.models.ContactRequest; +import com.ararahq.arara.sdk.models.ContactResponse; +import com.ararahq.arara.sdk.models.ContactsBatchResponse; +import com.ararahq.arara.sdk.models.ContactsListResponse; +import com.ararahq.arara.sdk.models.ContactsReactivationResponse; +import com.ararahq.arara.sdk.models.ContactsStatsResponse; +import com.fasterxml.jackson.core.type.TypeReference; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +@DisplayName("ContactService Tests") +class ContactServiceTest { + + @Mock + private AraraHttpClient httpClient; + + private ContactService contactService; + + @BeforeEach + void setUp() { + contactService = new ContactService(httpClient); + } + + @Test + @DisplayName("should list contacts with base pagination when filters are null") + void shouldListContactsWithoutFilters() { + ContactsListResponse expected = ContactsListResponse.builder() + .total(0) + .page(0) + .size(20) + .build(); + when(httpClient.get("/v1/contacts?page=0&size=20", ContactsListResponse.class)) + .thenReturn(expected); + + ContactsListResponse result = contactService.list(0, 20, null, null); + + assertNotNull(result); + verify(httpClient, times(1)).get("/v1/contacts?page=0&size=20", ContactsListResponse.class); + } + + @Test + @DisplayName("should append query and lifecycle filters to the path") + void shouldListContactsWithFilters() { + String path = "/v1/contacts?page=1&size=10&q=john&lifecycle=engaged"; + ContactsListResponse expected = ContactsListResponse.builder().total(5).build(); + when(httpClient.get(path, ContactsListResponse.class)).thenReturn(expected); + + ContactsListResponse result = contactService.list(1, 10, "john", "engaged"); + + assertEquals(5, result.getTotal()); + verify(httpClient, times(1)).get(path, ContactsListResponse.class); + } + + @Test + @DisplayName("should import a batch of contacts") + void shouldImportBatch() { + List contacts = Arrays.asList( + ContactRequest.builder().name("Ana").phone("+5511999998888").build()); + ContactsBatchResponse expected = ContactsBatchResponse.builder() + .importId(UUID.randomUUID()) + .created(1) + .build(); + when(httpClient.post("/v1/contacts/batch", contacts, ContactsBatchResponse.class)) + .thenReturn(expected); + + ContactsBatchResponse result = contactService.importBatch(contacts); + + assertEquals(1, result.getCreated()); + verify(httpClient, times(1)).post("/v1/contacts/batch", contacts, ContactsBatchResponse.class); + } + + @Test + @DisplayName("should reject null batch import") + void shouldRejectNullBatch() { + assertThrows(AraraException.class, () -> contactService.importBatch(null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should return aggregate contact stats") + void shouldReturnStats() { + ContactsStatsResponse expected = ContactsStatsResponse.builder() + .total(100) + .engaged(40) + .build(); + when(httpClient.get("/v1/contacts/stats", ContactsStatsResponse.class)).thenReturn(expected); + + ContactsStatsResponse result = contactService.stats(); + + assertEquals(100, result.getTotal()); + verify(httpClient, times(1)).get("/v1/contacts/stats", ContactsStatsResponse.class); + } + + @Test + @DisplayName("should list reactivation candidates with limit") + void shouldListReactivationCandidates() { + ContactsReactivationResponse expected = ContactsReactivationResponse.builder().total(3).build(); + when(httpClient.get("/v1/contacts/reactivation?limit=25", ContactsReactivationResponse.class)) + .thenReturn(expected); + + ContactsReactivationResponse result = contactService.reactivationCandidates(25); + + assertEquals(3, result.getTotal()); + verify(httpClient, times(1)) + .get("/v1/contacts/reactivation?limit=25", ContactsReactivationResponse.class); + } + + @Test + @DisplayName("should list distinct contact tags") + void shouldListTags() { + Map> expected = Map.of("tags", Arrays.asList("vip", "lead")); + when(httpClient.get(eq("/v1/contacts/tags"), any(TypeReference.class))).thenReturn(expected); + + Map> result = contactService.listTags(); + + assertEquals(Arrays.asList("vip", "lead"), result.get("tags")); + verify(httpClient, times(1)).get(eq("/v1/contacts/tags"), any(TypeReference.class)); + } + + @Test + @DisplayName("should retrieve a contact by phone") + void shouldGetContactByPhone() { + ContactResponse expected = ContactResponse.builder() + .id(UUID.randomUUID()) + .phone("+5511999998888") + .name("Ana") + .build(); + when(httpClient.get("/v1/contacts/+5511999998888", ContactResponse.class)).thenReturn(expected); + + ContactResponse result = contactService.get("+5511999998888"); + + assertEquals("Ana", result.getName()); + verify(httpClient, times(1)).get("/v1/contacts/+5511999998888", ContactResponse.class); + } + + @Test + @DisplayName("should patch a contact by phone") + void shouldUpdateContact() { + ContactPatchRequest request = ContactPatchRequest.builder() + .name("Ana Maria") + .tags(Arrays.asList("vip")) + .build(); + ContactResponse expected = ContactResponse.builder().name("Ana Maria").build(); + when(httpClient.patch("/v1/contacts/+5511999998888", request, ContactResponse.class)) + .thenReturn(expected); + + ContactResponse result = contactService.update("+5511999998888", request); + + assertEquals("Ana Maria", result.getName()); + verify(httpClient, times(1)) + .patch("/v1/contacts/+5511999998888", request, ContactResponse.class); + } + + @Test + @DisplayName("should reject null patch request") + void shouldRejectNullUpdate() { + assertThrows(AraraException.class, () -> contactService.update("+5511999998888", null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should list recent messages for a contact") + void shouldListContactMessages() { + ContactMessagesResponse expected = ContactMessagesResponse.builder() + .phone("+5511999998888") + .total(2) + .build(); + when(httpClient.get("/v1/contacts/+5511999998888/messages?limit=50", ContactMessagesResponse.class)) + .thenReturn(expected); + + ContactMessagesResponse result = contactService.messages("+5511999998888", 50); + + assertEquals(2, result.getTotal()); + verify(httpClient, times(1)) + .get("/v1/contacts/+5511999998888/messages?limit=50", ContactMessagesResponse.class); + } +} diff --git a/src/test/java/com/ararahq/arara/sdk/services/ConversationServiceTest.java b/src/test/java/com/ararahq/arara/sdk/services/ConversationServiceTest.java new file mode 100644 index 0000000..cf8c616 --- /dev/null +++ b/src/test/java/com/ararahq/arara/sdk/services/ConversationServiceTest.java @@ -0,0 +1,157 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.exceptions.AraraException; +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.ConversationReplyRequest; +import com.fasterxml.jackson.core.type.TypeReference; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +@DisplayName("ConversationService Tests") +class ConversationServiceTest { + + @Mock + private AraraHttpClient httpClient; + + private ConversationService conversationService; + + @BeforeEach + void setUp() { + conversationService = new ConversationService(httpClient); + } + + @Test + @DisplayName("should list conversations with base pagination when filters are null") + void shouldListWithoutFilters() { + Map expected = Map.of("data", Arrays.asList()); + when(httpClient.get(eq("/v1/conversations?page=0&size=20"), any(TypeReference.class))) + .thenReturn(expected); + + Map result = conversationService.list(null, null, 0, 20); + + assertNotNull(result); + verify(httpClient, times(1)).get(eq("/v1/conversations?page=0&size=20"), any(TypeReference.class)); + } + + @Test + @DisplayName("should append status and leadStatus filters to the path") + void shouldListWithFilters() { + String path = "/v1/conversations?page=1&size=15&status=OPEN&leadStatus=HOT"; + Map expected = Map.of("total", 4); + when(httpClient.get(eq(path), any(TypeReference.class))).thenReturn(expected); + + Map result = conversationService.list("OPEN", "HOT", 1, 15); + + assertEquals(4, result.get("total")); + verify(httpClient, times(1)).get(eq(path), any(TypeReference.class)); + } + + @Test + @DisplayName("should return lead counts by status") + void shouldReturnLeadStats() { + Map expected = Map.of("HOT", 2); + when(httpClient.get(eq("/v1/conversations/lead-stats"), any(TypeReference.class))) + .thenReturn(expected); + + Map result = conversationService.leadStats(); + + assertEquals(2, result.get("HOT")); + verify(httpClient, times(1)).get(eq("/v1/conversations/lead-stats"), any(TypeReference.class)); + } + + @Test + @DisplayName("should list messages of a conversation") + void shouldListMessages() { + String path = "/v1/conversations/conv_1/messages?page=0&size=30"; + Map expected = Map.of("total", 12); + when(httpClient.get(eq(path), any(TypeReference.class))).thenReturn(expected); + + Map result = conversationService.messages("conv_1", 0, 30); + + assertEquals(12, result.get("total")); + verify(httpClient, times(1)).get(eq(path), any(TypeReference.class)); + } + + @Test + @DisplayName("should send a free-text reply") + void shouldReply() { + ConversationReplyRequest request = ConversationReplyRequest.builder() + .conversationId(UUID.randomUUID()) + .body("Hi there") + .build(); + Map expected = Map.of("status", "SENT"); + when(httpClient.post(eq("/v1/conversations/reply"), eq(request), any(TypeReference.class))) + .thenReturn(expected); + + Map result = conversationService.reply(request); + + assertEquals("SENT", result.get("status")); + verify(httpClient, times(1)) + .post(eq("/v1/conversations/reply"), eq(request), any(TypeReference.class)); + } + + @Test + @DisplayName("should reject null reply request") + void shouldRejectNullReply() { + assertThrows(AraraException.class, () -> conversationService.reply(null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should update a conversation status") + void shouldUpdateStatus() { + Map expected = Map.of("status", "CLOSED"); + when(httpClient.patch( + eq("/v1/conversations/conv_9/status"), eq(Map.of("status", "CLOSED")), any(TypeReference.class))) + .thenReturn(expected); + + Map result = conversationService.updateStatus("conv_9", "CLOSED"); + + assertEquals("CLOSED", result.get("status")); + verify(httpClient, times(1)).patch( + eq("/v1/conversations/conv_9/status"), eq(Map.of("status", "CLOSED")), any(TypeReference.class)); + } + + @Test + @DisplayName("should check 24h window status for phones") + void shouldCheckWindowStatus() { + List phones = Arrays.asList("+5511999998888", "+5511988887777"); + Map expected = Map.of("open", 1); + when(httpClient.post( + eq("/v1/conversations/window-status"), eq(Map.of("phones", phones)), any(TypeReference.class))) + .thenReturn(expected); + + Map result = conversationService.windowStatus(phones); + + assertEquals(1, result.get("open")); + verify(httpClient, times(1)).post( + eq("/v1/conversations/window-status"), eq(Map.of("phones", phones)), any(TypeReference.class)); + } + + @Test + @DisplayName("should reject null phones list for window status") + void shouldRejectNullPhones() { + assertThrows(AraraException.class, () -> conversationService.windowStatus(null)); + verifyNoInteractions(httpClient); + } +} diff --git a/src/test/java/com/ararahq/arara/sdk/services/NumberServiceTest.java b/src/test/java/com/ararahq/arara/sdk/services/NumberServiceTest.java new file mode 100644 index 0000000..006a6eb --- /dev/null +++ b/src/test/java/com/ararahq/arara/sdk/services/NumberServiceTest.java @@ -0,0 +1,156 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.exceptions.AraraException; +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.NumberCard; +import com.ararahq.arara.sdk.models.NumbersResponse; +import com.ararahq.arara.sdk.models.NumbersSlot; +import com.ararahq.arara.sdk.models.RequestNumberRequest; +import com.ararahq.arara.sdk.models.UpdateNumberRequest; +import com.fasterxml.jackson.core.type.TypeReference; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.ArgumentMatchers.isNull; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +@DisplayName("NumberService Tests") +class NumberServiceTest { + + private static final String BASE = "/v1/organizations/me/numbers"; + + @Mock + private AraraHttpClient httpClient; + + private NumberService numberService; + + @BeforeEach + void setUp() { + numberService = new NumberService(httpClient); + } + + @Test + @DisplayName("should list numbers and slot info") + void shouldListNumbers() { + NumbersResponse expected = NumbersResponse.builder() + .numbers(Arrays.asList(NumberCard.builder().id("num_1").phoneNumber("+551140001000").build())) + .slot(NumbersSlot.builder().used(1).max(3).build()) + .build(); + when(httpClient.get(BASE, NumbersResponse.class)).thenReturn(expected); + + NumbersResponse result = numberService.list(); + + assertEquals(1, result.getNumbers().size()); + assertEquals(3, result.getSlot().getMax()); + verify(httpClient, times(1)).get(BASE, NumbersResponse.class); + } + + @Test + @DisplayName("should update a number") + void shouldUpdateNumber() { + UpdateNumberRequest request = UpdateNumberRequest.builder().alias("Support").isDefault(true).build(); + Map expected = Map.of("id", "num_1"); + when(httpClient.patch(eq(BASE + "/num_1"), eq(request), any(TypeReference.class))) + .thenReturn(expected); + + Map result = numberService.update("num_1", request); + + assertEquals("num_1", result.get("id")); + verify(httpClient, times(1)).patch(eq(BASE + "/num_1"), eq(request), any(TypeReference.class)); + } + + @Test + @DisplayName("should reject null update request") + void shouldRejectNullUpdate() { + assertThrows(AraraException.class, () -> numberService.update("num_1", null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should soft-delete a number") + void shouldDeleteNumber() { + numberService.delete("num_1"); + + verify(httpClient, times(1)).delete(BASE + "/num_1"); + } + + @Test + @DisplayName("should request a new dedicated number") + void shouldRequestNumber() { + RequestNumberRequest request = RequestNumberRequest.builder() + .reason("scale") + .expectedVolume("1000") + .areaCode("11") + .build(); + Map expected = Map.of("status", "PENDING"); + when(httpClient.post(eq(BASE + "/request"), eq(request), any(TypeReference.class))) + .thenReturn(expected); + + Map result = numberService.request(request); + + assertEquals("PENDING", result.get("status")); + verify(httpClient, times(1)).post(eq(BASE + "/request"), eq(request), any(TypeReference.class)); + } + + @Test + @DisplayName("should reject null request-number payload") + void shouldRejectNullRequest() { + assertThrows(AraraException.class, () -> numberService.request(null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should list pending and resolved number requests") + void shouldListRequests() { + List> expected = Arrays.asList(Map.of("id", "req_1")); + when(httpClient.get(eq(BASE + "/requests"), any(TypeReference.class))).thenReturn(expected); + + List> result = numberService.listRequests(); + + assertEquals(1, result.size()); + verify(httpClient, times(1)).get(eq(BASE + "/requests"), any(TypeReference.class)); + } + + @Test + @DisplayName("should trigger a provider sync with null body") + void shouldSyncNumber() { + Map expected = Map.of("synced", true); + when(httpClient.post(eq(BASE + "/num_1/sync"), isNull(), any(TypeReference.class))) + .thenReturn(expected); + + Map result = numberService.sync("num_1"); + + assertEquals(true, result.get("synced")); + verify(httpClient, times(1)).post(eq(BASE + "/num_1/sync"), isNull(), any(TypeReference.class)); + } + + @Test + @DisplayName("should return warming recommendations") + void shouldReturnWarming() { + Map expected = Map.of("recommendedDailyCap", 50); + when(httpClient.get(eq(BASE + "/num_1/warming"), any(TypeReference.class))).thenReturn(expected); + + Map result = numberService.warming("num_1"); + + assertNotNull(result); + assertEquals(50, result.get("recommendedDailyCap")); + verify(httpClient, times(1)).get(eq(BASE + "/num_1/warming"), any(TypeReference.class)); + } +} diff --git a/src/test/java/com/ararahq/arara/sdk/services/OrganizationServiceTest.java b/src/test/java/com/ararahq/arara/sdk/services/OrganizationServiceTest.java new file mode 100644 index 0000000..d5e20e0 --- /dev/null +++ b/src/test/java/com/ararahq/arara/sdk/services/OrganizationServiceTest.java @@ -0,0 +1,115 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.exceptions.AraraException; +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.BusinessProfilePatch; +import com.ararahq.arara.sdk.models.BusinessProfileResponse; +import com.ararahq.arara.sdk.models.OrganizationPlanResponse; +import com.fasterxml.jackson.core.type.TypeReference; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.util.Map; +import java.util.UUID; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +@DisplayName("OrganizationService Tests") +class OrganizationServiceTest { + + @Mock + private AraraHttpClient httpClient; + + private OrganizationService organizationService; + + @BeforeEach + void setUp() { + organizationService = new OrganizationService(httpClient); + } + + @Test + @DisplayName("should return the organization business profile") + void shouldReturnBusinessProfile() { + BusinessProfileResponse expected = BusinessProfileResponse.builder() + .id(UUID.randomUUID()) + .displayName("Arara") + .build(); + when(httpClient.get("/v1/organizations/me/business-profile", BusinessProfileResponse.class)) + .thenReturn(expected); + + BusinessProfileResponse result = organizationService.me(); + + assertEquals("Arara", result.getDisplayName()); + verify(httpClient, times(1)) + .get("/v1/organizations/me/business-profile", BusinessProfileResponse.class); + } + + @Test + @DisplayName("should patch the organization business profile") + void shouldUpdateBusinessProfile() { + BusinessProfilePatch request = BusinessProfilePatch.builder() + .displayName("Arara HQ") + .vertical("TECH") + .build(); + BusinessProfileResponse expected = BusinessProfileResponse.builder().displayName("Arara HQ").build(); + when(httpClient.patch("/v1/organizations/me/business-profile", request, BusinessProfileResponse.class)) + .thenReturn(expected); + + BusinessProfileResponse result = organizationService.updateBusinessProfile(request); + + assertEquals("Arara HQ", result.getDisplayName()); + verify(httpClient, times(1)) + .patch("/v1/organizations/me/business-profile", request, BusinessProfileResponse.class); + } + + @Test + @DisplayName("should reject null business profile patch") + void shouldRejectNullPatch() { + assertThrows(AraraException.class, () -> organizationService.updateBusinessProfile(null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should return the organization current plan") + void shouldReturnPlan() { + OrganizationPlanResponse expected = OrganizationPlanResponse.builder() + .current("VOO") + .monthlyPriceCents(34900) + .build(); + when(httpClient.get("/v1/organizations/me/plan", OrganizationPlanResponse.class)).thenReturn(expected); + + OrganizationPlanResponse result = organizationService.getPlan(); + + assertEquals("VOO", result.getCurrent()); + verify(httpClient, times(1)).get("/v1/organizations/me/plan", OrganizationPlanResponse.class); + } + + @Test + @DisplayName("should change the organization plan") + void shouldChangePlan() { + Map expected = Map.of("current", "DECOLAGEM"); + when(httpClient.patch( + eq("/v1/organizations/me/plan"), eq(Map.of("plan", "DECOLAGEM")), any(TypeReference.class))) + .thenReturn(expected); + + Map result = organizationService.changePlan("DECOLAGEM"); + + assertNotNull(result); + assertEquals("DECOLAGEM", result.get("current")); + verify(httpClient, times(1)).patch( + eq("/v1/organizations/me/plan"), eq(Map.of("plan", "DECOLAGEM")), any(TypeReference.class)); + } +} diff --git a/src/test/java/com/ararahq/arara/sdk/services/SmartLinkServiceTest.java b/src/test/java/com/ararahq/arara/sdk/services/SmartLinkServiceTest.java new file mode 100644 index 0000000..54fa5d4 --- /dev/null +++ b/src/test/java/com/ararahq/arara/sdk/services/SmartLinkServiceTest.java @@ -0,0 +1,123 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.exceptions.AraraException; +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.CreateWhatsAppSmartLinkRequest; +import com.ararahq.arara.sdk.models.UpdateWhatsAppSmartLinkRequest; +import com.ararahq.arara.sdk.models.WhatsAppSmartLinkResponse; +import com.fasterxml.jackson.core.type.TypeReference; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +@DisplayName("SmartLinkService Tests") +class SmartLinkServiceTest { + + private static final String BASE = "/v1/smart-links/whatsapp"; + + @Mock + private AraraHttpClient httpClient; + + private SmartLinkService smartLinkService; + + @BeforeEach + void setUp() { + smartLinkService = new SmartLinkService(httpClient); + } + + @Test + @DisplayName("should create a smart link") + void shouldCreateSmartLink() { + CreateWhatsAppSmartLinkRequest request = CreateWhatsAppSmartLinkRequest.builder() + .name("Promo") + .phoneNumber("+551140001000") + .defaultText("Hi") + .build(); + WhatsAppSmartLinkResponse expected = WhatsAppSmartLinkResponse.builder() + .id(UUID.randomUUID()) + .name("Promo") + .code("abc123") + .build(); + when(httpClient.post(BASE, request, WhatsAppSmartLinkResponse.class)).thenReturn(expected); + + WhatsAppSmartLinkResponse result = smartLinkService.create(request); + + assertEquals("Promo", result.getName()); + verify(httpClient, times(1)).post(BASE, request, WhatsAppSmartLinkResponse.class); + } + + @Test + @DisplayName("should reject null create request") + void shouldRejectNullCreate() { + assertThrows(AraraException.class, () -> smartLinkService.create(null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should update a smart link via PUT") + void shouldUpdateSmartLink() { + UpdateWhatsAppSmartLinkRequest request = UpdateWhatsAppSmartLinkRequest.builder() + .name("Promo v2") + .defaultText("Hello") + .build(); + WhatsAppSmartLinkResponse expected = WhatsAppSmartLinkResponse.builder().name("Promo v2").build(); + when(httpClient.put(BASE + "/link_1", request, WhatsAppSmartLinkResponse.class)).thenReturn(expected); + + WhatsAppSmartLinkResponse result = smartLinkService.update("link_1", request); + + assertEquals("Promo v2", result.getName()); + verify(httpClient, times(1)).put(BASE + "/link_1", request, WhatsAppSmartLinkResponse.class); + } + + @Test + @DisplayName("should reject null update request") + void shouldRejectNullUpdate() { + assertThrows(AraraException.class, () -> smartLinkService.update("link_1", null)); + verifyNoInteractions(httpClient); + } + + @Test + @DisplayName("should list smart links") + void shouldListSmartLinks() { + List expected = Arrays.asList( + WhatsAppSmartLinkResponse.builder().name("Promo").build()); + when(httpClient.get(eq(BASE), any(TypeReference.class))).thenReturn(expected); + + List result = smartLinkService.list(); + + assertEquals(1, result.size()); + verify(httpClient, times(1)).get(eq(BASE), any(TypeReference.class)); + } + + @Test + @DisplayName("should return click stats for a smart link") + void shouldReturnStats() { + Map expected = Map.of("clicks", 42); + when(httpClient.get(eq(BASE + "/link_1/stats"), any(TypeReference.class))).thenReturn(expected); + + Map result = smartLinkService.stats("link_1"); + + assertNotNull(result); + assertEquals(42, result.get("clicks")); + verify(httpClient, times(1)).get(eq(BASE + "/link_1/stats"), any(TypeReference.class)); + } +} diff --git a/src/test/java/com/ararahq/arara/sdk/services/WalletServiceTest.java b/src/test/java/com/ararahq/arara/sdk/services/WalletServiceTest.java new file mode 100644 index 0000000..388dc27 --- /dev/null +++ b/src/test/java/com/ararahq/arara/sdk/services/WalletServiceTest.java @@ -0,0 +1,104 @@ +package com.ararahq.arara.sdk.services; + +import com.ararahq.arara.sdk.exceptions.AraraException; +import com.ararahq.arara.sdk.http.AraraHttpClient; +import com.ararahq.arara.sdk.models.AutoRechargeSettings; +import com.ararahq.arara.sdk.models.UpdateAutoRechargeRequest; +import com.ararahq.arara.sdk.models.WalletTransactionPage; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.math.BigDecimal; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +@DisplayName("WalletService Tests") +class WalletServiceTest { + + @Mock + private AraraHttpClient httpClient; + + private WalletService walletService; + + @BeforeEach + void setUp() { + walletService = new WalletService(httpClient); + } + + @Test + @DisplayName("should list wallet transactions with pagination") + void shouldListTransactions() { + WalletTransactionPage expected = WalletTransactionPage.builder() + .page(0) + .size(20) + .totalElements(3) + .build(); + when(httpClient.get("/v1/wallet/transactions?page=0&size=20", WalletTransactionPage.class)) + .thenReturn(expected); + + WalletTransactionPage result = walletService.transactions(0, 20); + + assertEquals(3, result.getTotalElements()); + verify(httpClient, times(1)) + .get("/v1/wallet/transactions?page=0&size=20", WalletTransactionPage.class); + } + + @Test + @DisplayName("should return auto-recharge settings") + void shouldGetAutoRecharge() { + AutoRechargeSettings expected = AutoRechargeSettings.builder() + .enabled(true) + .threshold(BigDecimal.valueOf(10)) + .amount(BigDecimal.valueOf(50)) + .build(); + when(httpClient.get("/v1/wallet/auto-recharge", AutoRechargeSettings.class)).thenReturn(expected); + + AutoRechargeSettings result = walletService.getAutoRecharge(); + + assertTrue(result.isEnabled()); + assertEquals(BigDecimal.valueOf(50), result.getAmount()); + verify(httpClient, times(1)).get("/v1/wallet/auto-recharge", AutoRechargeSettings.class); + } + + @Test + @DisplayName("should update auto-recharge settings") + void shouldUpdateAutoRecharge() { + UpdateAutoRechargeRequest request = UpdateAutoRechargeRequest.builder() + .enabled(true) + .threshold(BigDecimal.valueOf(15)) + .amount(BigDecimal.valueOf(100)) + .build(); + AutoRechargeSettings expected = AutoRechargeSettings.builder() + .enabled(true) + .amount(BigDecimal.valueOf(100)) + .build(); + when(httpClient.patch("/v1/wallet/auto-recharge", request, AutoRechargeSettings.class)) + .thenReturn(expected); + + AutoRechargeSettings result = walletService.updateAutoRecharge(request); + + assertNotNull(result); + assertEquals(BigDecimal.valueOf(100), result.getAmount()); + verify(httpClient, times(1)) + .patch("/v1/wallet/auto-recharge", request, AutoRechargeSettings.class); + } + + @Test + @DisplayName("should reject null auto-recharge update request") + void shouldRejectNullUpdate() { + assertThrows(AraraException.class, () -> walletService.updateAutoRecharge(null)); + verifyNoInteractions(httpClient); + } +}