Feat/dx 3797 update taxonomy api

.github/workflows/coverage-check.yml

@@ -0,0 +1,26 @@
+name: 'TS SDK - Unit Testing'
+
+on:
+  pull_request:
+    branches:
+      - development
+      - staging
+      - main
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      checks: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run unit tests with coverage
+        uses: ArtiomTr/jest-coverage-report-action@v2
+        id: coverage
+        with:
+          test-script: npm run test:unit
+          threshold: 95

.gitignore

@@ -14,4 +14,4 @@ coverage
 .dccache
 dist/*
 *.log
-.nx/
+.nx/

.talismanrc

@@ -1,6 +1,10 @@
 fileignoreconfig:
 - filename: package-lock.json
-  checksum: 32308dbe614c142c4804ff7c81baedddba058c5458e1d233fefb1d8070bf1905
+  checksum: cb21e1b4fc8240b8ee33c6f974a9d1cf25d96afb9161c85633cbb061f069bbc4
+- filename: test/unit/contentstack.spec.ts
+  checksum: d5b99c01459ab8bc597baaa9e6cc4aa91ac6d9bf78af08e1d0220d0c5db3d0b3
+- filename: test/unit/utils.spec.ts
+  checksum: 79ce5bd78376db37a34df82c0fea19031e995b66a5a246e73f8262fa05d65a9c
 - filename: test/unit/query-optimization-comprehensive.spec.ts
   checksum: f5aaf6c784d7c101a05ca513c584bbd6e95f963d1e42779f2596050d9bcbac96
 - filename: src/lib/entries.ts

CHANGELOG.md

@@ -1,6 +1,20 @@
-### Version: 4.10.1
-#### Date: Oct-01-2025
+### Version: 4.10.2
+#### Date: Dec-15-2025
+Build: bump @contentstack/core version to ^1.3.4
+
+### Version: 4.10.3
+#### Date: Nov-13-2025
+Fix: reverts the endpoints helper method integration
+
+### Version: 4.10.2
+#### Date: Nov-12-2025
 Enhancement: Added logHandler interceptors for request and response logging
+Enhancement: Upgraded @contentstack/utils dependency to version 1.6.2
+Refactor: Replaced region handling logic to use getContentstackEndpoint from @contentstack/utils
+
+### Version: 4.10.1
+#### Date: Oct-27-2025
+Fix: Upgrade dependecies
 
 ### Version: 4.10.0
 #### Date: Sep-22-2025

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/delivery-sdk",
-  "version": "4.10.1",
+  "version": "4.10.4",
   "type": "module",
   "license": "MIT",
   "main": "./dist/legacy/index.cjs",
@@ -35,9 +35,9 @@
     "husky-check": "npm run build && husky && chmod +x .husky/pre-commit"
   },
   "dependencies": {
-    "@contentstack/core": "^1.3.0",
-    "@contentstack/utils": "^1.4.1",
-    "axios": "^1.12.2",
+    "@contentstack/core": "^1.3.4",
+    "@contentstack/utils": "1.5.0",
+    "axios": "^1.13.1",
     "humps": "^2.0.1"
   },
   "files": [

src/lib/base-query.ts

@@ -2,6 +2,7 @@ import { AxiosInstance, getData } from '@contentstack/core';
 import { Pagination } from './pagination';
 import { FindResponse, params } from './types';
 import { encodeQueryParams } from './utils';
+import type { Query } from './query';
 
 export class BaseQuery extends Pagination {
   _parameters: params = {}; // Params of query class ?query={}
@@ -10,6 +11,14 @@ export class BaseQuery extends Pagination {
   protected _urlPath!: string;
   protected _variants!: string;
 
+  /**
+   * Helper method to cast this instance to Query type
+   * @private
+   */
+  protected asQuery(): Query {
+    return this as unknown as Query;
+  }
+
   /**
    * @method includeCount
    * @memberof BaseQuery
@@ -23,12 +32,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().includeCount().find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  includeCount(): BaseQuery {
+  includeCount(): Query {
     this._queryParams.include_count = 'true';
 
-    return this;
+    return this.asQuery();
   }
 
   /**
@@ -44,12 +53,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().orderByAscending().find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  orderByAscending(key: string): BaseQuery {
+  orderByAscending(key: string): Query {
     this._queryParams.asc = key;
 
-    return this;
+    return this.asQuery();
   }
 
   /**
@@ -65,12 +74,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().orderByDescending().find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  orderByDescending(key: string): BaseQuery {
+  orderByDescending(key: string): Query {
     this._queryParams.desc = key;
 
-    return this;
+    return this.asQuery();
   }
 
   /**
@@ -86,12 +95,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().limit(5).find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  limit(key: number): BaseQuery {
+  limit(key: number): Query {
     this._queryParams.limit = key;
 
-    return this;
+    return this.asQuery();
   }
 
   /**
@@ -107,12 +116,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().skip(5).find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  skip(key: number): BaseQuery {
+  skip(key: number): Query {
     this._queryParams.skip = key;
 
-    return this;
+    return this.asQuery();
   }
 
 
@@ -130,12 +139,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().param("key", "value").find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  param(key: string, value: string | number): BaseQuery {
+  param(key: string, value: string | number): Query {
     this._queryParams[key] = value;
 
-    return this;
+    return this.asQuery();
   }
 
   /**
@@ -151,12 +160,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().addParams({"key": "value"}).find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  addParams(paramObj: { [key: string]: string | boolean | number }): BaseQuery {
+  addParams(paramObj: { [key: string]: string | boolean | number }): Query {
     this._queryParams = { ...this._queryParams, ...paramObj };
 
-    return this;
+    return this.asQuery();
   }
 
   /**
@@ -172,12 +181,12 @@ export class BaseQuery extends Pagination {
    * // OR
    * const asset = await stack.asset().removeParam("query_param_key").find()
    *
-   * @returns {BaseQuery}
+   * @returns {Query}
    */
-  removeParam(key: string): BaseQuery {
+  removeParam(key: string): Query {
     delete this._queryParams[key];
 
-    return this;
+    return this.asQuery();
   }
 
   /**

src/lib/contentstack.ts

@@ -2,9 +2,10 @@ import { httpClient, retryRequestHandler, retryResponseErrorHandler, retryRespon
 import { AxiosRequestHeaders } from 'axios';
 import { handleRequest } from './cache';
 import { Stack as StackClass } from './stack';
-import { Policy, StackConfig, ContentstackPlugin } from './types';
+import { Policy, StackConfig, ContentstackPlugin, Region } from './types';
 import * as Utility from './utils';
-export * as Utils from '@contentstack/utils';
+import * as Utils from '@contentstack/utils';
+export { Utils };
 
 let version = '{{VERSION}}';
 
@@ -33,16 +34,17 @@ let version = '{{VERSION}}';
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function stack(config: StackConfig): StackClass {
+  const DEFAULT_HOST = Utility.getHostforRegion(config.region || Region.US, config.host);
+
   let defaultConfig = {
-    defaultHostname: 'cdn.contentstack.io',
+    defaultHostname: DEFAULT_HOST,
     headers: {} as AxiosRequestHeaders,
     params: {} as any,
     live_preview: {} as any,
     port: config.port as number,
     ...config
   };
 
-  defaultConfig.defaultHostname = config.host || Utility.getHost(config.region, config.host);
   config.host = defaultConfig.defaultHostname;
 
   if (config.apiKey) {

src/lib/stack.ts

@@ -233,4 +233,5 @@ import { Taxonomy } from './taxonomy';
     if (typeof debug === "boolean") this.config.debug = debug;
     return this;
   }
+
 }

src/lib/taxonomy-query.ts

@@ -21,7 +21,7 @@ export class TaxonomyQuery extends Query {
    * const result = await taxonomyQuery.find();
    */
   override async find<T>(): Promise<FindResponse<T>> {
-    this._urlPath = "/taxonomy-manager"; // TODO: change to /taxonomies
+    this._urlPath = "/taxonomies";
     const response = await getData(this._client, this._urlPath, {
       params: this._queryParams,
     });

src/lib/taxonomy.ts

@@ -21,7 +21,7 @@ export class Taxonomy {
   constructor(client: AxiosInstance, taxonomyUid: string) {
     this._client = client;
     this._taxonomyUid = taxonomyUid;
-    this._urlPath = `/taxonomy-manager/${this._taxonomyUid}`; // TODO: change to /taxonomies/${this._taxonomyUid}
+    this._urlPath = `/taxonomies/${this._taxonomyUid}`;
   }
 
   /**

src/lib/term-query.ts

@@ -19,7 +19,7 @@ export class TermQuery {
   constructor(client: AxiosInstance, taxonomyUid: string) {
     this._client = client;
     this._taxonomyUid = taxonomyUid;
-    this._urlPath = `/taxonomy-manager/${this._taxonomyUid}/terms`;
+    this._urlPath = `/taxonomies/${this._taxonomyUid}/terms`;
   }
 
   /**

src/lib/term.ts

@@ -20,7 +20,7 @@ export class Term {
     this._client = client;
     this._taxonomyUid = taxonomyUid;
     this._termUid = termUid;
-    this._urlPath = `/taxonomy-manager/${this._taxonomyUid}/terms/${this._termUid}`; // TODO: change to /taxonomies
+    this._urlPath = `/taxonomies/${this._taxonomyUid}/terms/${this._termUid}`;
   }
 
   /**

src/lib/utils.ts

@@ -1,6 +1,6 @@
 import { Region, params } from './types';
 
-export function getHost(region: Region = Region.US, host?: string) {
+export function getHostforRegion(region: Region = Region.US, host?: string): string {
   if (host) return host;
 
   let url = 'cdn.contentstack.io';