feat: ✨ terms support

lib/entity.js

@@ -84,7 +84,7 @@ export const create = ({ http, params }) => {
     try {
       const response = await http.post(this.urlPath, data, headers)
       if (response.data) {
-        return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid))
+        return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid, this.taxonomy_uid))
       } else {
         throw error(response)
       }
@@ -144,7 +144,7 @@ export const update = (http, type, params = {}) => {
       }
       })
       if (response.data) {
-        return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid))
+        return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid, this.taxonomy_uid))
       } else {
         throw error(response)
       }
@@ -204,7 +204,7 @@ export const fetch = (http, type, params = {}) => {
           response.data[type]['content_type'] = response.data['content_type']
           response.data[type]['schema'] = response.data['schema']
         }
-        return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid))
+        return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid, this.taxonomy_uid))
       } else {
         throw error(response)
       }
@@ -235,14 +235,17 @@ export const fetchAll = (http, wrapperCollection, params = {}) => {
   }
 }
 
-export function parseData (response, stackHeaders, contentTypeUID) {
+export function parseData (response, stackHeaders, contentTypeUID, taxonomy_uid) {
   const data = response.data || {}
   if (stackHeaders) {
     data.stackHeaders = stackHeaders
   }
   if (contentTypeUID) {
     data.content_type_uid = contentTypeUID
   }
+  if (taxonomy_uid) {
+    data.taxonomy_uid = taxonomy_uid
+  }
   return data
 }
 
@@ -266,4 +269,36 @@ export async function get (http, url, params, data) {
   } catch (err) {
     throw error(err)
   }
+}
+
+export const move = (http, type, force = false, params = {}) => {
+  return async function (param = {}) {
+    try {
+      let updateData = {}
+      const json = cloneDeep(this)
+      delete json.parent_uid
+      if (type) {
+        updateData[type] = json
+      } else {
+        updateData = json
+      }
+      const headers = {
+        headers: { ...cloneDeep(this.stackHeaders), ...cloneDeep(params) },
+        params: {
+          ...cloneDeep(param)
+        }
+      } || {}
+      if (force === true) {
+        headers.params.force = true
+      }
+      const response = await http.put(`${this.urlPath}/move`, updateData, headers)
+      if (response.data) {
+        return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid, this.taxonomy_uid))
+      } else {
+        throw error(response)
+      }
+    } catch (err) {
+      throw error(err)
+    }
+  }
 }

lib/stack/taxonomy/index.js

@@ -1,3 +1,4 @@
+/* eslint-disable camelcase */
 import cloneDeep from 'lodash/cloneDeep'
 import {
   create,
@@ -6,13 +7,17 @@ import {
   update,
   deleteEntity
 } from '../../entity'
+import { Terms, TermsCollection } from './terms'
 
-export function Taxonomy (http, data) {
+export function Taxonomy (http, data = {}) {
   this.stackHeaders = data.stackHeaders
   this.urlPath = `/taxonomies`
 
   if (data.taxonomy) {
     Object.assign(this, cloneDeep(data.taxonomy))
+    if (data.taxonomy.terms) {
+      this.terms = new TermsCollection(http, { terms: data.taxonomy.terms, stackHeaders: data.stackHeaders }, this.uid)
+    }
     this.urlPath = `/taxonomies/${this.uid}`
 
     /**
@@ -24,7 +29,7 @@ export function Taxonomy (http, data) {
      * import * as contentstack from '@contentstack/management'
      * const client = contentstack.client()
      *
-     * client.stack({ api_key: 'api_key'}).taxonomy('taxonomy_uid').fetch()
+     * client.stack({ api_key: 'api_key'}).taxonomy('taxonomyUid').fetch()
      * .then((taxonomy) => {
      *    taxonomy.name = 'taxonomy name'
      *    return taxonomy.update()
@@ -43,7 +48,7 @@ export function Taxonomy (http, data) {
      * import * as contentstack from '@contentstack/management'
      * const client = contentstack.client()
      *
-     * client.stack({ api_key: 'api_key'}).taxonomy('taxonomy_uid').delete()
+     * client.stack({ api_key: 'api_key'}).taxonomy('taxonomyUid').delete()
      * .then((response) => console.log(response.notice))
      *
      */
@@ -58,11 +63,20 @@ export function Taxonomy (http, data) {
      * import * as contentstack from '@contentstack/management'
      * const client = contentstack.client()
      *
-     * client.stack({ api_key: 'api_key'}).taxonomy('taxonomy_uid').fetch()
+     * client.stack({ api_key: 'api_key'}).taxonomy('taxonomyUid').fetch()
      * .then((taxonomy) => console.log(taxonomy))
      *
      */
     this.fetch = fetch(http, 'taxonomy')
+
+    this.terms = (uid = '') => {
+      const data = { stackHeaders: this.stackHeaders }
+      data.taxonomy_uid = this.uid
+      if (uid) {
+        data.term = { uid: uid }
+      }
+      return new Terms(http, data)
+    }
   } else {
     /**
      * @description The Create taxonomy call is used to create a taxonomy.

lib/stack/taxonomy/terms/index.js

@@ -0,0 +1,209 @@
+import cloneDeep from 'lodash/cloneDeep'
+import {
+  create,
+  fetch,
+  update,
+  query,
+  deleteEntity,
+  move,
+  parseData
+} from '../../../entity'
+
+export function Terms (http, data) {
+  this.stackHeaders = data.stackHeaders
+  this.taxonomy_uid = data.taxonomy_uid
+  this.urlPath = `/taxonomies/${this.taxonomy_uid}/terms`
+
+  if (data && data.term) {
+    Object.assign(this, cloneDeep(data.term))
+    this.urlPath = `/taxonomies/${this.taxonomy_uid}/terms/${this.uid}`
+
+    /**
+     * @description The Update terms call is used to update an existing term.
+     * @memberof Terms
+     * @func update
+     * @returns {Promise<Terms.Terms>} Promise for Terms instance
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack({ api_key: 'api_key'}).terms('terms_uid').fetch()
+     * .then((terms) => {
+     *    terms.name = 'terms name'
+     *    return terms.update()
+     * })
+     * .then((terms) => console.log(terms))
+     *
+     */
+    this.update = update(http, 'term')
+
+    /**
+     * @description The Delete terms call is used to delete an existing term.
+     * @memberof Terms
+     * @func delete
+     * @returns {Promise<Terms.Terms>} Response Object.
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack({ api_key: 'api_key'}).terms('terms_uid').delete()
+     * .then((response) => console.log(response.notice))
+     *
+     */
+    this.delete = deleteEntity(http)
+
+    /**
+     * @description The Fetch terms call is used to fetch an existing term.
+     * @memberof Terms
+     * @func fetch
+     * @returns {Promise<Terms.Terms>} Promise for Terms instance
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack({ api_key: 'api_key'}).terms('terms_uid').fetch()
+     * .then((terms) => console.log(terms))
+     *
+     */
+    this.fetch = fetch(http, 'term')
+
+    /**
+     * @description The ancestors call is used to get all the ancestor terms of an existing term.
+     * @memberof Terms
+     * @func ancestors
+     * @returns {Promise<Terms.Terms>} Promise for Terms instance
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack({ api_key: 'api_key'}).terms('terms_uid').ancestors()
+     * .then((terms) => console.log(terms))
+     *
+     */
+    this.ancestors = async (params = {}) => {
+      try {
+        const headers = {
+          headers: { ...cloneDeep(this.stackHeaders), ...cloneDeep(params) }
+        }
+        const response = await http.get(`${this.urlPath}/ancestors`, headers)
+        return parseData(response, this.stackHeaders)
+      } catch (err) {
+        console.error(err)
+        throw err
+      }
+    }
+
+    /**
+     * @description The move call is used to  existing term.
+     * @memberof Terms
+     * @func descendants
+     * @returns {Promise<Terms.Terms>} Promise for Terms instance
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack({ api_key: 'api_key'}).terms('terms_uid').descendants()
+     * .then((terms) => console.log(terms))
+     *
+     */
+    this.descendants = async (params = {}) => {
+      try {
+        const headers = {
+          headers: { ...cloneDeep(this.stackHeaders), ...cloneDeep(params) }
+        }
+        const response = await http.get(`${this.urlPath}/descendants`, headers)
+        return parseData(response, this.stackHeaders)
+      } catch (err) {
+        console.error(err)
+        throw err
+      }
+    }
+
+    /**
+     * @description The move call is used to update the parent uid.
+     * @memberof Terms
+     * @func anscestors
+     * @returns {Promise<Terms.Terms>} Promise for Terms instance
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * const term = {
+     *  parent_uid: 'parent_uid',
+     *  order: 2
+     * }
+     * client.stack({ api_key: 'api_key'}).terms('terms_uid').move(term)
+     * .then((terms) => console.log(terms))
+     *
+     */
+    this.move = move(http, 'term')
+  } else {
+    /**
+     * @description The Create terms call is used to create a terms.
+     * @memberof Terms
+     * @func create
+     * @returns {Promise<Terms.Terms>} Promise for Terms instance
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     * const terms = {
+     *    uid: 'terms_testing1',
+     *    name: 'terms testing',
+     *    description: 'Description for terms testing'
+     * }
+     * client.stack({ api_key: 'api_key'}).terms().create({terms})
+     * .then(terms) => console.log(terms)
+     *
+     */
+    this.create = create({ http })
+
+    /**
+     * @description The Query on Terms will allow to fetch details of all Terms.
+     * @memberof Terms
+     * @param {Object} params - URI parameters
+     * @prop {Object} params.query - Queries that you can use to fetch filtered results.
+     * @func query
+     * @returns {Array<Terms>} Array of Terms.
+     *
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack().terms().query().find()
+     * .then((terms) => console.log(terms)
+     */
+    this.query = query({ http: http, wrapperCollection: TermsCollection })
+  }
+  /**
+     * @description The Search terms call is used to search a term.
+     * @memberof Terms
+     * @func search
+     * @returns {Promise<Terms.Terms>} Promise for Terms instance
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     * const term_string = ''
+     * client.stack({ api_key: 'api_key'}).terms().search(term_string)
+     * .then(terms) => console.log(terms)
+     *
+     */
+  this.search = async (term = '', params = {}) => {
+    try {
+      const headers = {
+        headers: { ...cloneDeep(this.stackHeaders), ...cloneDeep(params) }
+      }
+      const response = await http.get(`taxonomies/${this.taxonomy_uid}/terms?term=${term}`, headers)
+      return parseData(response, this.stackHeaders)
+    } catch (err) {
+      console.error(err)
+      throw err
+    }
+  }
+}
+export function TermsCollection (http, data) {
+  const obj = cloneDeep(data.terms) || []
+  const termsCollection = obj.map((term) => {
+    return new Terms(http, { term: term, taxonomy_uid: data.taxonomy_uid, stackHeaders: data.stackHeaders })
+  })
+  return termsCollection
+}