feat: release version 2.7.0 with endpoint integration and enhancements

- Added new endpoint integration for Contentstack API.
- Introduced a script to refresh the bundled regions.json from the Contentstack artifact registry.
- Enhanced Config class to track if the host has been overridden.
- Implemented Endpoint class to resolve Contentstack API endpoints dynamically.
- Added integration tests for endpoint resolution and service availability.
- Updated Stack class to prioritize explicit host settings over region resolution.
- Updated CHANGELOG.md to reflect the new version and changes.

Author: reeshika-h

CHANGELOG.md

@@ -1,5 +1,10 @@
 # CHANGELOG
 
+## v2.7.0
+
+### Jun 15, 2026
+- Enhancement: Endpoint integration
+
 ## v2.6.0
 
 ### Feb 23, 2026

pom.xml

@@ -5,7 +5,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.contentstack.sdk</groupId>
     <artifactId>java</artifactId>
-    <version>2.6.0</version>
+    <version>2.7.0</version>
     <packaging>jar</packaging>
     <name>contentstack-java</name>
     <description>Java SDK for Contentstack Content Delivery API</description>
@@ -462,6 +462,34 @@
                 <artifactId>maven-jxr-plugin</artifactId>
                 <version>2.3</version>
             </plugin>
+
+            <!--
+                Refresh the bundled regions.json from the Contentstack artifact registry.
+                Run whenever Contentstack adds new regions or service keys, then commit
+                the updated src/main/resources/assets/regions.json.
+
+                Usage:
+                    mvn exec:exec@refresh-regions
+            -->
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <version>3.1.0</version>
+                <executions>
+                    <execution>
+                        <id>refresh-regions</id>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>bash</executable>
+                            <arguments>
+                                <argument>${project.basedir}/scripts/download-regions.sh</argument>
+                            </arguments>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
         </plugins>
     </build>
 

scripts/download-regions.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# Download the latest regions.json from the Contentstack artifacts registry and
+# write it to src/main/resources/assets/regions.json so it gets bundled into
+# the SDK jar on the next build.
+#
+# Usage:
+#   ./scripts/download-regions.sh
+#   mvn exec:exec@refresh-regions
+#
+# Run this whenever Contentstack announces new regions or service keys, then
+# commit the updated file:
+#   git add src/main/resources/assets/regions.json
+#   git commit -m "chore: refresh regions.json"
+
+set -euo pipefail
+
+REGIONS_URL="https://artifacts.contentstack.com/regions.json"
+DEST="$(dirname "$0")/../src/main/resources/assets/regions.json"
+DEST="$(cd "$(dirname "$DEST")" && pwd)/$(basename "$DEST")"
+
+echo "Downloading regions.json from ${REGIONS_URL} ..."
+
+if command -v curl &>/dev/null; then
+    curl --silent --show-error --fail --location \
+         --retry 3 --retry-delay 2 \
+         -o "${DEST}" "${REGIONS_URL}"
+elif command -v wget &>/dev/null; then
+    wget --quiet --tries=3 --waitretry=2 -O "${DEST}" "${REGIONS_URL}"
+else
+    echo "Error: neither curl nor wget found. Install one and retry." >&2
+    exit 1
+fi
+
+# Validate the downloaded file contains a "regions" array
+if ! python3 -c "import sys, json; d=json.load(open('${DEST}')); assert 'regions' in d and len(d['regions']) > 0" 2>/dev/null &&
+   ! python  -c "import sys, json; d=json.load(open('${DEST}')); assert 'regions' in d and len(d['regions']) > 0" 2>/dev/null; then
+    # Fallback validation without Python — just check the key exists
+    if ! grep -q '"regions"' "${DEST}"; then
+        echo "Error: downloaded file does not look like a valid regions.json" >&2
+        rm -f "${DEST}"
+        exit 1
+    fi
+fi
+
+REGION_COUNT=$(grep -o '"id"' "${DEST}" | wc -l | tr -d ' ')
+echo "contentstack-java: regions.json updated (${REGION_COUNT} regions) → ${DEST}"

src/main/java/com/contentstack/sdk/Config.java

@@ -18,6 +18,7 @@ public class Config {
     protected String livePreviewContentType = null;
     protected String livePreviewEntryUid = null;
     protected String host = "cdn.contentstack.io";
+    protected boolean hostOverridden = false;
     protected String version = "v3";
     protected String scheme = "https://";
     protected String endpoint;
@@ -167,6 +168,7 @@ public String getHost() {
     public void setHost(String hostName) {
         if (hostName != null && !hostName.isEmpty()) {
             host = hostName;
+            hostOverridden = true;
         }
     }
 

src/main/java/com/contentstack/sdk/Contentstack.java

@@ -1,5 +1,6 @@
 package com.contentstack.sdk;
 
+import java.util.Map;
 import java.util.Objects;
 
 /**
@@ -98,6 +99,60 @@ private static void validateCredentials(String stackApiKey, String deliveryToken
         }
     }
 
+    /**
+     * Returns the Contentstack API URL for the given region and service.
+     *
+     * <p>Delegates to {@link Endpoint#getContentstackEndpoint(String, String)} — provided as a
+     * convenience so callers can reach endpoint resolution through the same top-level class they
+     * use to create stacks.
+     *
+     * @param region  region ID or alias (e.g. {@code "na"}, {@code "eu"}, {@code "azure-na"})
+     * @param service service key (e.g. {@code "contentDelivery"}, {@code "contentManagement"})
+     * @return full URL including {@code https://} scheme
+     * @throws IllegalArgumentException if the region or service is not recognised
+     */
+    public static String getContentstackEndpoint(String region, String service) {
+        return Endpoint.getContentstackEndpoint(region, service);
+    }
+
+    /**
+     * Returns the Contentstack API URL for the given region and service, optionally stripping
+     * the {@code https://} scheme.
+     *
+     * @param region      region ID or alias
+     * @param service     service key
+     * @param omitHttps   when {@code true}, returns the bare host without {@code https://}
+     * @return URL or bare host
+     * @throws IllegalArgumentException if the region or service is not recognised
+     */
+    public static String getContentstackEndpoint(String region, String service, boolean omitHttps) {
+        return Endpoint.getContentstackEndpoint(region, service, omitHttps);
+    }
+
+    /**
+     * Returns all service endpoints for the given region as an ordered map of service key to URL.
+     *
+     * @param region region ID or alias
+     * @return map of service key → full URL
+     * @throws IllegalArgumentException if the region is not recognised
+     */
+    public static Map<String, String> getContentstackEndpoints(String region) {
+        return Endpoint.getAllEndpoints(region);
+    }
+
+    /**
+     * Returns all service endpoints for the given region, optionally stripping the
+     * {@code https://} scheme from every URL.
+     *
+     * @param region    region ID or alias
+     * @param omitHttps when {@code true}, returns bare hosts without {@code https://}
+     * @return map of service key → URL or bare host
+     * @throws IllegalArgumentException if the region is not recognised
+     */
+    public static Map<String, String> getContentstackEndpoints(String region, boolean omitHttps) {
+        return Endpoint.getAllEndpoints(region, omitHttps);
+    }
+
     private static Stack initializeStack(String stackApiKey, String deliveryToken, String environment, Config config) {
         Stack stack = new Stack(stackApiKey.trim());
         stack.setHeader("api_key", stackApiKey);