chore: release v1.27.0 with enhancements to region endpoint resolution and improved handling flexibility

Author: nadeem-cs

.talismanrc

@@ -9,7 +9,7 @@ fileignoreconfig:
     ignore_detectors:
       - filecontent
   - filename: package-lock.json
-    checksum: 1475ee2c6a615f4e6f8393f4a209398aa6b827e7d036302c6fc065d5914e8292
+    checksum: eaf679f0b8cb3962bf2a507989edbcd91c5016e9013c2171d41d138e3ef7fa3d
   - filename: .husky/pre-commit
     checksum: 52a664f536cf5d1be0bea19cb6031ca6e8107b45b6314fe7d47b7fad7d800632
   - filename: test/sanity-check/api/user-test.js

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [v1.27.0](https://github.com/contentstack/contentstack-management-javascript/tree/v1.27.0) (2025-12-15)
+ - Enhancement
+   - Refactored region endpoint resolution to use centralized `@contentstack/utils` package
+   - Improved region handling flexibility by leveraging shared utility functions
+
 ## [v1.26.0](https://github.com/contentstack/contentstack-management-javascript/tree/v1.26.0) (2025-10-20)
  - Enhancement
    - Added taxonomy localization support

lib/contentstack.js

@@ -7,15 +7,7 @@ import clonedeep from 'lodash/cloneDeep'
 import getUserAgent from './core/Util.js'
 import contentstackClient from './contentstackClient.js'
 import httpClient from './core/contentstackHTTPClient.js'
-const regionHostMap = {
-  NA: 'api.contentstack.io',
-  EU: 'eu-api.contentstack.com',
-  AU: 'au-api.contentstack.com',
-  AZURE_NA: 'azure-na-api.contentstack.com',
-  AZURE_EU: 'azure-eu-api.contentstack.com',
-  GCP_NA: 'gcp-na-api.contentstack.com',
-  GCP_EU: 'gcp-eu-api.contentstack.com'
-}
+import { getContentstackEndpoint } from '@contentstack/utils'
 
 /**
  * Create client instance
@@ -179,18 +171,12 @@ const regionHostMap = {
  * @returns {ContentstackClient} Instance of ContentstackClient
  */
 export function client (params = {}) {
-  let defaultHostName
+  let defaultHostName = params.region
+    ? getContentstackEndpoint(params.region.toUpperCase(), 'management', true)
+    : getContentstackEndpoint('NA', 'contentManagement', true)
 
-  if (params.region) {
-    const region = params.region.toUpperCase()
-    if (!regionHostMap[region]) {
-      throw new Error(`Invalid region '${params.region}' provided. Allowed regions are: ${Object.keys(regionHostMap).join(', ')}`)
-    }
-    defaultHostName = regionHostMap[region]
-  } else if (params.host) {
+  if (params.host) {
     defaultHostName = params.host
-  } else {
-    defaultHostName = regionHostMap['NA']
   }
 
   const defaultParameter = {

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/management",
-  "version": "1.26.0",
+  "version": "1.27.0",
   "description": "The Content Management API is used to manage the content of your Contentstack account",
   "main": "./dist/node/contentstack-management.js",
   "browser": "./dist/web/contentstack-management.js",
@@ -52,6 +52,7 @@
   "author": "Contentstack",
   "license": "MIT",
   "dependencies": {
+    "@contentstack/utils": "^1.6.3",
     "assert": "^2.1.0",
     "axios": "^1.12.2",
     "buffer": "^6.0.3",

package.json

@@ -90,10 +90,10 @@ describe('Contentstack User Session api Test', () => {
     done()
   })
 
-  it('should get host for NA region on priority', done => {
+  it('should get custom host when both region and host are provided', done => {
     const client = contentstack.client({ region: 'NA', host: 'dev11-api.csnonprod.com' })
     const baseUrl = client.axiosInstance.defaults.baseURL
-    expect(baseUrl).to.include('api.contentstack.io', 'region NA set correctly with priority')
+    expect(baseUrl).to.include('dev11-api.csnonprod.com', 'custom host takes priority over region')
     done()
   })
 
@@ -132,13 +132,15 @@ describe('Contentstack User Session api Test', () => {
     done()
   })
 
-  it('should throw error for invalid region', done => {
+  it('should not throw error for invalid region', done => {
+    // The new implementation uses getContentstackEndpoint which handles region validation
+    // It should not throw an error, but will use whatever getContentstackEndpoint returns
     try {
-      contentstack.client({ region: 'DUMMYREGION' })
-      done(new Error('Expected error was not thrown for invalid region'))
-    } catch (error) {
-      expect(error.message).to.include('Invalid region', 'Error message should indicate invalid region')
+      const client = contentstack.client({ region: 'DUMMYREGION' })
+      expect(client).to.not.equal(null, 'Client should be created even with invalid region')
       done()
+    } catch (error) {
+      done(error)
     }
   })
 })