chore: remove legacy multi-endpoint helper methods (#71)

Author: saurabhjain1592

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to the AxonFlow Java SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2026-02-04
+
+### Changed
+
+- Removed legacy internal endpoint helper methods `getOrchestratorUrl()` and `getPortalUrl()` from `AxonFlow`
+- Portal and orchestrator request builders now directly use `config.getEndpoint()`, matching ADR-026 Single Entry Point architecture
+
 ## [3.0.0] - 2026-02-03
 
 ### Breaking Changes

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.getaxonflow</groupId>
     <artifactId>axonflow-sdk</artifactId>
-    <version>3.0.0</version>
+    <version>3.1.0</version>
     <packaging>jar</packaging>
 
     <name>AxonFlow Java SDK</name>

src/main/java/com/getaxonflow/sdk/AxonFlow.java

@@ -2111,7 +2111,7 @@ public PortalLoginResponse loginToPortal(String orgId, String password) throws I
         RequestBody body = RequestBody.create(json, JSON);
 
         Request request = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/auth/login")
+                .url(config.getEndpoint() + "/api/v1/auth/login")
                 .post(body)
                 .header("Content-Type", "application/json")
                 .build();
@@ -2153,7 +2153,7 @@ public void logoutFromPortal() {
 
         try {
             Request request = new Request.Builder()
-                    .url(getPortalUrl() + "/api/v1/auth/logout")
+                    .url(config.getEndpoint() + "/api/v1/auth/logout")
                     .post(RequestBody.create("", JSON))
                     .header("Cookie", "axonflow_session=" + sessionCookie)
                     .build();
@@ -2196,7 +2196,7 @@ public ValidateGitProviderResponse validateGitProvider(ValidateGitProviderReques
         RequestBody body = RequestBody.create(json, JSON);
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/git-providers/validate")
+                .url(config.getEndpoint() + "/api/v1/code-governance/git-providers/validate")
                 .post(body);
 
         addPortalSessionCookie(builder);
@@ -2221,7 +2221,7 @@ public ConfigureGitProviderResponse configureGitProvider(ConfigureGitProviderReq
         RequestBody body = RequestBody.create(json, JSON);
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/git-providers")
+                .url(config.getEndpoint() + "/api/v1/code-governance/git-providers")
                 .post(body);
 
         addPortalSessionCookie(builder);
@@ -2242,7 +2242,7 @@ public ListGitProvidersResponse listGitProviders() throws IOException {
         logger.debug("Listing Git providers");
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/git-providers")
+                .url(config.getEndpoint() + "/api/v1/code-governance/git-providers")
                 .get();
 
         addPortalSessionCookie(builder);
@@ -2263,7 +2263,7 @@ public void deleteGitProvider(GitProviderType providerType) throws IOException {
         logger.debug("Deleting Git provider: {}", providerType);
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/git-providers/" + providerType.getValue())
+                .url(config.getEndpoint() + "/api/v1/code-governance/git-providers/" + providerType.getValue())
                 .delete();
 
         addPortalSessionCookie(builder);
@@ -2288,7 +2288,7 @@ public CreatePRResponse createPR(CreatePRRequest request) throws IOException {
         RequestBody body = RequestBody.create(json, JSON);
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/prs")
+                .url(config.getEndpoint() + "/api/v1/code-governance/prs")
                 .post(body);
 
         addPortalSessionCookie(builder);
@@ -2309,7 +2309,7 @@ public ListPRsResponse listPRs(ListPRsOptions options) throws IOException {
         requirePortalLogin();
         logger.debug("Listing PRs");
 
-        StringBuilder url = new StringBuilder(getPortalUrl() + "/api/v1/code-governance/prs");
+        StringBuilder url = new StringBuilder(config.getEndpoint() + "/api/v1/code-governance/prs");
         StringBuilder query = new StringBuilder();
 
         if (options != null) {
@@ -2361,7 +2361,7 @@ public PRRecord getPR(String prId) throws IOException {
         logger.debug("Getting PR: {}", prId);
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/prs/" + prId)
+                .url(config.getEndpoint() + "/api/v1/code-governance/prs/" + prId)
                 .get();
 
         addPortalSessionCookie(builder);
@@ -2385,7 +2385,7 @@ public PRRecord syncPRStatus(String prId) throws IOException {
         RequestBody body = RequestBody.create("{}", JSON);
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/prs/" + prId + "/sync")
+                .url(config.getEndpoint() + "/api/v1/code-governance/prs/" + prId + "/sync")
                 .post(body);
 
         addPortalSessionCookie(builder);
@@ -2409,7 +2409,7 @@ public PRRecord closePR(String prId, boolean deleteBranch) throws IOException {
         requirePortalLogin();
         logger.debug("Closing PR: {} (deleteBranch={})", prId, deleteBranch);
 
-        String url = getPortalUrl() + "/api/v1/code-governance/prs/" + prId;
+        String url = config.getEndpoint() + "/api/v1/code-governance/prs/" + prId;
         if (deleteBranch) {
             url += "?delete_branch=true";
         }
@@ -2436,7 +2436,7 @@ public CodeGovernanceMetrics getCodeGovernanceMetrics() throws IOException {
         logger.debug("Getting code governance metrics");
 
         Request.Builder builder = new Request.Builder()
-                .url(getPortalUrl() + "/api/v1/code-governance/metrics")
+                .url(config.getEndpoint() + "/api/v1/code-governance/metrics")
                 .get();
 
         addPortalSessionCookie(builder);
@@ -2457,7 +2457,7 @@ public ExportResponse exportCodeGovernanceData(ExportOptions options) throws IOE
         requirePortalLogin();
         logger.debug("Exporting code governance data");
 
-        StringBuilder url = new StringBuilder(getPortalUrl() + "/api/v1/code-governance/export");
+        StringBuilder url = new StringBuilder(config.getEndpoint() + "/api/v1/code-governance/export");
         StringBuilder query = new StringBuilder();
 
         if (options != null) {
@@ -2501,7 +2501,7 @@ public String exportCodeGovernanceDataCSV(ExportOptions options) throws IOExcept
         requirePortalLogin();
         logger.debug("Exporting code governance data as CSV");
 
-        StringBuilder url = new StringBuilder(getPortalUrl() + "/api/v1/code-governance/export");
+        StringBuilder url = new StringBuilder(config.getEndpoint() + "/api/v1/code-governance/export");
         StringBuilder query = new StringBuilder();
 
         appendQueryParam(query, "format", "csv");
@@ -2539,21 +2539,13 @@ public String exportCodeGovernanceDataCSV(ExportOptions options) throws IOExcept
     // Execution Replay API
     // ========================================================================
 
-    /**
-     * Gets the endpoint URL for API requests.
-     * All routes now go through a single endpoint (ADR-026 Single Entry Point).
-     */
-    private String getOrchestratorUrl() {
-        return config.getEndpoint();
-    }
-
     /**
      * Builds a request for the orchestrator API.
      */
     private Request buildOrchestratorRequest(String method, String path, Object body) {
-        HttpUrl url = HttpUrl.parse(getOrchestratorUrl() + path);
+        HttpUrl url = HttpUrl.parse(config.getEndpoint() + path);
         if (url == null) {
-            throw new ConfigurationException("Invalid URL: " + getOrchestratorUrl() + path);
+            throw new ConfigurationException("Invalid URL: " + config.getEndpoint() + path);
         }
 
         Request.Builder builder = new Request.Builder()
@@ -2597,14 +2589,6 @@ private Request buildOrchestratorRequest(String method, String path, Object body
         return builder.build();
     }
 
-    /**
-     * Gets the endpoint URL for portal API requests.
-     * All routes now go through a single endpoint (ADR-026 Single Entry Point).
-     */
-    private String getPortalUrl() {
-        return config.getEndpoint();
-    }
-
     /**
      * Requires portal login before making code governance requests.
      */
@@ -2630,9 +2614,9 @@ private void addPortalSessionCookie(Request.Builder builder) {
     private Request buildPortalRequest(String method, String path, Object body) {
         requirePortalLogin();
 
-        HttpUrl url = HttpUrl.parse(getPortalUrl() + path);
+        HttpUrl url = HttpUrl.parse(config.getEndpoint() + path);
         if (url == null) {
-            throw new ConfigurationException("Invalid URL: " + getPortalUrl() + path);
+            throw new ConfigurationException("Invalid URL: " + config.getEndpoint() + path);
         }
 
         Request.Builder builder = new Request.Builder()