feat: Add descendants method to Term class and update related tests

Author: harshitha-cstk

src/lib/term.ts

@@ -47,11 +47,26 @@ export class Term {
     return response;
   }
 
+  /**
+   * @method descendants
+   * @memberof Term
+   * @description Fetches descendants for the term
+   * @returns {Promise<T>}
+   * @example
+   * import contentstack from '@contentstack/delivery-sdk'
+   *
+   * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
+   * const result = await stack.taxonomy('taxonomy_uid').term('term_uid').descendants();
+   */
+  async descendants<T>(): Promise<T> {
+    const response = await getData(this._client, `${this._urlPath}/descendants`);
+    if (response.descendants) return response.descendants as T;
+    return response;
+  }
+
   async fetch<T>(): Promise<T> {
     const response = await getData(this._client, this._urlPath);
-
     if (response.term) return response.term as T;
-
     return response;
   }
 }

test/api/taxonomy.spec.ts

@@ -16,7 +16,7 @@ describe('ContentType API test cases', () => {
   });
 
   it('should give a single taxonomy when taxonomy method is called with taxonomyUid', async () => {
-    const result = await makeTaxonomy('taxonomy_testing_3').fetch<TTaxonomy>();
+    const result = await makeTaxonomy('taxonomy_testing').fetch<TTaxonomy>();
     expect(result).toBeDefined();
   });
 });

test/api/term-query.spec.ts

@@ -6,7 +6,7 @@ const stack = stackInstance();
 
 describe("Terms API test cases", () => {
   it("should check for terms is defined", async () => {
-    const result = await makeTerms("taxonomy_testing_3").find<TTerm>();
+    const result = await makeTerms("taxonomy_testing").find<TTerm>();
     if (result.terms) {
       expect(result.terms).toBeDefined();
       expect(result.terms[0].taxonomy_uid).toBeDefined();

test/api/term.spec.ts

@@ -27,9 +27,16 @@ describe("Terms API test cases", () => {
     expect(result.terms).toBeDefined();
     expect(result.terms[0].name).toBeDefined();
   });
+
+  it("should get descendants for a term", async () => {
+    const result = await makeTerms("vrl").descendants<TTerms>();
+    expect(result).toBeDefined();
+    expect(result.terms).toBeDefined();
+    expect(result.terms[0].name).toBeDefined();
+  });
 });
 
 function makeTerms(termUid = ""): Term {
-  const terms = stack.taxonomy("taxonomy_testing_3").term(termUid);
+  const terms = stack.taxonomy("taxonomy_testing").term(termUid);
   return terms;
 }

test/unit/term.spec.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance, httpClient } from '@contentstack/core';
 import MockAdapter from 'axios-mock-adapter';
-import { termQueryFindResponseDataMock, termLocalesResponseDataMock, termAncestorsResponseDataMock } from '../utils/mocks';
+import { termQueryFindResponseDataMock, termLocalesResponseDataMock, termAncestorsResponseDataMock, termDescendantsResponseDataMock } from '../utils/mocks';
 import { MOCK_CLIENT_OPTIONS } from '../utils/constant';
 import { Term } from '../../src/lib/term';
 import { Taxonomy } from '../../src/lib/taxonomy';
@@ -39,4 +39,11 @@ describe('Term class', () => {
     const response = await term.ancestors();
     expect(response).toEqual(termAncestorsResponseDataMock);
   });
+
+  it('should fetch descendants for a term when descendants() is called', async () => {
+    mockClient.onGet('/taxonomy-manager/taxonomy_testing/terms/term1/descendants').reply(200, termDescendantsResponseDataMock);
+
+    const response = await term.descendants();
+    expect(response).toEqual(termDescendantsResponseDataMock);
+  });
 });

test/utils/mocks.ts

@@ -1738,6 +1738,93 @@ const termAncestorsResponseDataMock = {
   ]
 }
 
+const termDescendantsResponseDataMock = {
+  "terms": [
+    {
+      "taxonomy_uid": "taxonomy_testing",
+      "uid": "sleeper",
+      "ancestors": [
+        {
+          "uid": "taxonomy_testing",
+          "name": "taxonomy_testing",
+          "type": "TAXONOMY"
+        },
+        {
+          "uid": "vehicles",
+          "name": "vehicles",
+          "type": ""
+        },
+        {
+          "uid": "buses",
+          "name": "buses",
+          "type": ""
+        },
+        {
+          "uid": "vrl",
+          "name": "vrl",
+          "type": ""
+        }
+      ],
+      "name": "sleeper",
+      "parent_uid": "vrl",
+      "created_by": "created_by",
+      "created_at": "2025-10-28T07:58:46.870Z",
+      "updated_by": "updated_by",
+      "updated_at": "2025-10-28T07:58:46.870Z",
+      "children_count": 0,
+      "depth": 4,
+      "ACL": {},
+      "publish_details": {
+        "time": "2025-10-28T07:59:12.557Z",
+        "user": "user",
+        "environment": "environment",
+        "locale": "en-us"
+      }
+    },
+    {
+      "taxonomy_uid": "taxonomy_testing",
+      "uid": "intercity",
+      "ancestors": [
+        {
+          "uid": "taxonomy_testing",
+          "name": "taxonomy_testing",
+          "type": "TAXONOMY"
+        },
+        {
+          "uid": "vehicles",
+          "name": "vehicles",
+          "type": ""
+        },
+        {
+          "uid": "buses",
+          "name": "buses",
+          "type": ""
+        },
+        {
+          "uid": "vrl",
+          "name": "vrl",
+          "type": ""
+        }
+      ],
+      "name": "intercity",
+      "parent_uid": "vrl",
+      "created_by": "created_by",
+      "created_at": "2025-10-28T07:58:46.870Z",
+      "updated_by": "updated_by",
+      "updated_at": "2025-10-28T07:58:46.870Z",
+      "children_count": 0,
+      "depth": 4,
+      "ACL": {},
+      "publish_details": {
+        "time": "2025-10-28T07:59:12.565Z",
+        "user": "user",
+        "environment": "environment",
+        "locale": "en-us"
+      }
+    }
+  ]
+}
+
 const termQueryFindResponseDataMock = {
   "terms": [
     {
@@ -1785,4 +1872,5 @@ export {
   termQueryFindResponseDataMock,
   termLocalesResponseDataMock,
   termAncestorsResponseDataMock,
+  termDescendantsResponseDataMock,
 };