Feat/taxonomy publishing

lib/stack/taxonomy/index.js

@@ -266,6 +266,53 @@ export function Taxonomy (http, data = {}) {
         throw error(err)
       }
     }
+
+    /**
+     * @description The Publish taxonomy call initiates a job to publish a taxonomy and/or specific terms to the specified environments and locales.
+     * @memberof Taxonomy
+     * @func publish
+     * @param {Object} data - Publish details
+     * @param {string} [api_version=''] - Optional API version (e.g., '3.2')
+     * @returns {Promise<Object>} Response object with publish job details
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * const publishData = {
+     *   locales: ["en-us"],
+     *   environments: ["development"],
+     *   items: [
+     *     {
+     *       uid: "taxonomy_testing",
+     *       term_uid: "vehicles"
+     *     },
+     *     {
+     *       uid: "taxonomy_testing",
+     *       term_uid: "cars"
+     *     }
+     *   ]
+     * }
+     * client.stack({ api_key: 'api_key'}).taxonomy().publish(publishData, '3.2')
+     * .then((response) => console.log(response))
+     */
+    this.publish = async function (data, api_version = '') {
+      try {
+        const headers = {
+          headers: { ...cloneDeep(this.stackHeaders) }
+        }
+        if (api_version) {
+          headers.headers.api_version = api_version
+        }
+        const response = await http.post(`${this.urlPath}/publish`, data, headers)
+        if (response.data) {
+          return response.data
+        } else {
+          throw error(response)
+        }
+      } catch (err) {
+        throw error(err)
+      }
+    }
   }
 }
 export function TaxonomyCollection (http, data) {

test/sanity-check/api/terms-test.js

@@ -2,6 +2,7 @@ import { describe, it, beforeEach } from 'mocha'
 import { expect } from 'chai'
 import { jsonReader } from '../utility/fileOperations/readwrite'
 import { contentstackClient } from '../utility/ContentstackClient.js'
+import { environmentCreate } from '../mock/environment.js'
 import { stageBranch } from '../mock/branch.js'
 
 var client = {}
@@ -42,6 +43,7 @@ describe('Terms API Test', () => {
   })
   it('should create taxonomy', async () => {
     const response = await client.stack({ api_key: process.env.API_KEY }).taxonomy().create({ taxonomy })
+    await client.stack({ api_key: process.env.API_KEY }).environment().create(environmentCreate)
     expect(response.uid).to.be.equal(taxonomy.uid)
     await new Promise(resolve => setTimeout(resolve, 5000))
   }, 10000)
@@ -127,6 +129,35 @@ describe('Terms API Test', () => {
       .catch(done)
   })
 
+  it('should publish with api_version', done => {
+    const publishData = {
+      locales: ['en-us'],
+      environments: ['development'],
+      items: [
+        {
+          uid: taxonomy.uid,
+          term_uid: 'term_test'
+        },
+        {
+          uid: taxonomy.uid,
+          term_uid: 'term_test_child1'
+        },
+        {
+          uid: taxonomy.uid,
+          term_uid: 'term_test_child2'
+        }
+      ]
+    }
+    makeTaxonomy()
+      .publish(publishData, '3.2')
+      .then((response) => {
+        expect(response.notice).to.not.equal(null)
+        expect(response.job_id).to.not.equal(undefined)
+        done()
+      })
+      .catch(done)
+  })
+
   it('should search the term with the string passed', done => {
     makeTerms(taxonomy.uid).search(termString)
       .then((response) => {
@@ -195,6 +226,10 @@ function makeTerms (taxonomyUid, termUid = null) {
   return client.stack({ api_key: process.env.API_KEY }).taxonomy(taxonomyUid).terms(termUid)
 }
 
+function makeTaxonomy () {
+  return client.stack({ api_key: process.env.API_KEY }).taxonomy()
+}
+
 describe('Terms Query Parameters Sanity Tests', () => {
   beforeEach(async () => {
     const user = jsonReader('loggedinuser.json')
@@ -359,6 +394,7 @@ describe('Terms Query Parameters Sanity Tests', () => {
       skip: 0,
       limit: 10
     })
+    await client.stack({ api_key: process.env.API_KEY }).environment(environmentCreate.environment.name).delete()
     expect(terms).to.have.property('items')
     expect(terms.items).to.be.an('array')
     // Count property might not be available in all environments

test/unit/taxonomy-test.js

@@ -759,6 +759,33 @@ describe('Contentstack Taxonomy test', () => {
       })
       .catch(done)
   })
+
+  it('Taxonomy publish test with api_version', done => {
+    var mock = new MockAdapter(Axios)
+    mock.onPost('/taxonomies/publish').reply(200, {
+      notice: 'Taxonomy publish job initiated successfully.',
+      job_id: 'job_456'
+    })
+    const publishData = {
+      locales: ['en-us', 'fr-fr'],
+      environments: ['production'],
+      scheduled_at: '2025-10-01T10:00:00.000Z',
+      items: [
+        {
+          uid: 'taxonomy_testing',
+          term_uid: 'vehicles'
+        }
+      ]
+    }
+    makeTaxonomy()
+      .publish(publishData, '3.2')
+      .then((response) => {
+        expect(response.notice).to.be.equal('Taxonomy publish job initiated successfully.')
+        expect(response.job_id).to.be.equal('job_456')
+        done()
+      })
+      .catch(done)
+  })
 })
 
 function makeTaxonomy (data = {}) {

types/stack/taxonomy/index.d.ts

@@ -10,10 +10,27 @@ export interface Taxonomy extends SystemFields, SystemFunction<Taxonomy> {
 
 export interface Taxonomies extends Creatable<Taxonomy, {taxonomy: TaxonomyData}>, Queryable<Taxonomy, {taxonomy: TaxonomyData}> {
     import(data: TaxonomyData, params?: any): Promise<Taxonomy>
+    publish(data: TaxonomyPublishData, api_version?: string): Promise<TaxonomyPublishResponse>
 }
 
 export interface TaxonomyData extends AnyProperty {
     name: string
     uid: string
     description: string
 }
+
+export interface TaxonomyPublishData {
+    locales: Array<string>
+    environments: Array<string>
+    items: Array<TaxonomyPublishItem>    
+}
+
+export interface TaxonomyPublishItem {
+    uid: string
+    term_uid: string
+}
+
+export interface TaxonomyPublishResponse extends AnyProperty {
+    notice?: string
+    job_id?: string
+}