Merge branch 'next' of https://github.com/contentstack/contentstack-management-javascript-variants into next-feature-update

Author: sunil-lakshman

.github/workflows/codeql-analysis.yml

@@ -3,7 +3,7 @@ on:
   pull_request:
     types: [opened]
 jobs:
-  security:
+  security-jira:
     if: ${{ github.actor == 'dependabot[bot]' || github.actor == 'snyk-bot' || contains(github.event.pull_request.head.ref, 'snyk-fix-')  || contains(github.event.pull_request.head.ref, 'snyk-upgrade-')}}
     runs-on: ubuntu-latest
     steps:
@@ -26,3 +26,8 @@ jobs:
             PR: ${{ github.event.pull_request.html_url }}
 
           fields: "${{ secrets.JIRA_FIELDS }}"
+      - name: Transition issue
+        uses: atlassian/gajira-transition@v3
+        with:
+          issue: ${{ steps.create.outputs.issue }}
+          transition: ${{ secrets.JIRA_TRANSITION }}

.github/workflows/jira.yml

@@ -13,7 +13,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
         with:
-          node-version: '12.x'
+          node-version: '18.x'
           registry-url: 'https://registry.npmjs.org'
       - run: npm ci
       - run: npm publish
@@ -25,7 +25,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
         with:
-          node-version: '12.x'
+          node-version: '18.x'
           registry-url: 'https://npm.pkg.github.com'
           scope: '@contentstack'
       - run: npm ci

.github/workflows/npm-publish.yml

@@ -3,7 +3,7 @@ on:
   pull_request:
     types: [opened, synchronize, reopened]
 jobs:
-  security:
+  security-sca:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@master

.github/workflows/sca-scan.yml

@@ -13,7 +13,7 @@ jobs:
       - uses: actions/checkout@v2     # checkout the repo
       - uses: actions/setup-node@v3
         with:
-          node-version: '12.x'
+          node-version: '18.x'
           registry-url: 'https://registry.npmjs.org'
       - run: npm ci                   # install packages
       - run: npm run test:unit:report:json                 # run tests (configured to use jest-junit reporter)

.github/workflows/unit-test.yml

@@ -1,3 +1,4 @@
+# contentstack-management-javascript-variants
 [![Contentstack](https://www.contentstack.com/docs/static/images/contentstack.png)](https://www.contentstack.com/)
 
 ## Contentstack Management JavaScript SDK

README.md

@@ -205,7 +205,6 @@ export const fetch = (http, type, params = {}) => {
       if (this.organization_uid) {
         headers.headers.organization_uid = this.organization_uid
       }
-
       const response = await http.get(this.urlPath, headers)
       if (response.data) {
         if (type === 'entry') {

lib/entity.js

@@ -12,6 +12,7 @@ import { create,
 import FormData from 'form-data'
 import { createReadStream } from 'fs'
 import error from '../../../core/contentstackError'
+import { Variants } from './variants/index'
 
 /**
  * An entry is the actual piece of content created using one of the defined content types. Read more about <a href='https://www.contentstack.com/docs/guide/content-management'>Entries</a>.
@@ -265,6 +266,66 @@ export function Entry (http, data) {
         throw error(err)
       }
     }
+
+    /**
+     * @description The variants requestan entry call is used to fetch a specific entry with variants from a content type.
+     * @memberof Entry
+     * @func variants
+     * @returns {Promise<Object>} Response Object.
+     * @param {Object} publishing_rule Details for the publish request
+     * @param {String} locale Enter the code of the locale that the entry belongs to.
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     * client.stack({ api_key: 'api_key'}).contentType('content_type_uid').entry('uid').variants('uid').fetch()
+     * .then((response) => console.log(response.notice));
+     */
+    this.variants = (uid = null) => {
+      const data = { stackHeaders: this.stackHeaders }
+      data.content_type_uid = this.content_type_uid
+      data.entry_uid = this.uid
+      if (uid) {
+        data.variants_uid = uid
+      }
+      return new Variants(http, data)
+    }
+
+    /**
+     * @description The includeVariants an entry call is used to fetch a specific base entry with variants from a content type.
+     * @memberof Variants
+     * @func includeVariants
+     * @returns {Object} Response Object.
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack({ api_key: 'api_key'}).contentType('content_type_uid').entry('uid').includeVariants('true','variants_uid')
+     * .then((response) => console.log(response))
+     */
+
+    this.includeVariants = async (include_variant, variants_uid) => {
+      try {
+        const headers = {
+          ...cloneDeep(this.stackHeaders) // Clone existing headers
+        };
+    
+        // Add custom header
+        headers['x-cs-variant-uid'] = variants_uid; // add variant UID
+        let params = {};
+        if (include_variant) {
+          params.include_variant = include_variant; // if include_variant present
+        }
+        const response = await http.get(this.urlPath, { headers, params });
+        if (response.data) {
+          return response.data;
+        } else {
+          throw error(response);
+        }
+      } catch (err) {
+        error(err);
+      }
+    };
+    
   } else {
     /**
      * @description The Create an entry call creates a new entry for the selected content type.

lib/stack/contentType/entry/index.js

@@ -0,0 +1,165 @@
+import cloneDeep from 'lodash/cloneDeep'
+import {
+    update,
+    deleteEntity,
+    fetch,
+    upload,
+    query,
+    parseData
+}
+from '../../../../entity'
+import FormData from 'form-data'
+import {
+    createReadStream
+} from 'fs'
+import error from '../../../../core/contentstackError'
+/**
+ * An variants is the actual piece of content created using one of the defined content types. Read more about <a href='https://www.contentstack.com/docs/guide/content-management'>Entries</a>.
+ * @namespace Variants
+ */
+export function Variants(http, data) {
+    Object.assign(this, cloneDeep(data))
+    this.urlPath = `/content_types/${this.content_type_uid}/entries/${this.entry_uid}/variants`
+    if (data && data.variants_uid) {
+        this.urlPath += `/${this.variants_uid}`
+        /**
+         * @description The Create an variants call creates a new variants for the selected content type.
+         * @memberof Variants
+         * @func update
+         * @returns {Promise<Variants.Variants>} Promise for Variants instance
+         * @example
+         * import * as contentstack from '@contentstack/management'
+         * const client = contentstack.client()
+         * const data = {
+         *      "entry": {
+         *          "title": "example",
+         *          "url": "/example",
+         *          "_variant": {
+         *          "_change_set": [
+         *              "title",
+         *              "url"
+         *              ]
+         *          }
+         *          }
+         *      }
+         * client.stack({ api_key: 'api_key'}).contentType('content_type_uid').entry('entry_uid').variants('uid').update(data)
+         * .then((variants) => console.log(variants))
+         */
+        this.update = async (data) => {
+            try {
+              const response = await http.put(this.urlPath,
+                 data,
+                {
+                  headers: {
+                    ...cloneDeep(this.stackHeaders)
+                  }
+                })
+              if (response.data) {
+                return response.data
+              } else {
+                return error(response)
+              }
+            } catch (err) {
+              return error(err)
+            }
+          }
+
+        /**
+         * @description The Delete an variants call is used to delete a specific variants from a content type.
+         * @memberof Variants
+         * @func delete
+         * @returns {Object} Response Object.
+         * @example
+         * import * as contentstack from '@contentstack/management'
+         * const client = contentstack.client()
+         *
+         * client.stack({ api_key: 'api_key'}).contentType('content_type_uid').entry('entry_uid').variants('uid').delete()
+         * .then((response) => console.log(response.notice))
+         */
+        this.delete = deleteEntity(http)
+
+        /**
+         * @description The fetch Variants call fetches Variants details.
+         * @memberof Variants
+         * @func fetch
+         * @returns {Promise<Variants.Variants>} Promise for Variants instance
+         * @example
+         * import * as contentstack from '@contentstack/management'
+         * const client = contentstack.client()
+         *
+         * client.stack({ api_key: 'api_key'}).contentType('content_type_uid').entry('entry_uid').variants('uid').fetch()
+         * .then((variants) => console.log(variants))
+         *
+         */
+        this.fetch = fetch(http, 'variants')
+
+        /**
+         * @description The version Variants call fetches Variants version details.
+         * @memberof Variants
+         * @func versions
+         * @returns {Promise<Variants.Variants>} Promise for Variants instance
+         * @example
+         * import * as contentstack from '@contentstack/management'
+         * const client = contentstack.client()
+         *
+         * client.stack({ api_key: 'api_key'}).contentType('content_type_uid').entry('entry_uid').variants('uid').versions()
+         * .then((variants) => console.log(variants))
+         *
+         */
+        this.versions = async () => {
+            try {
+              const response = await http.get(`${this.urlPath}/versions`, {
+                headers: {
+                  ...cloneDeep(this.stackHeaders)
+                }
+              })
+              if (response.data) {
+                return response.data
+              } else {
+                return error(response)
+              }
+            } catch (err) {
+              return error(err)
+            }
+          }
+
+    } else {
+        /**
+         * @description The Query on Variants will allow to fetch details of all or specific Variants
+         * @memberof Variants
+         * @func query
+         * @param {Int} locale Enter the code of the language of which the entries need to be included. Only the entries published in this locale will be displayed.
+         * @param {Object} query Queries that you can use to fetch filtered results.
+         * @returns {Array<Variants>} Array of Variants.
+         *
+         * @example
+         * import * as contentstack from '@contentstack/management'
+         * const client = contentstack.client()
+         *
+         * client.stack().contentType('content_type_uid').entry('entry_uid').variants().query({ query: { title: 'Variants title' } }).find()
+         * .then((entries) => console.log(entries))
+         */
+        this.query = query({ http: http, wrapperCollection: VariantsCollection })
+    }
+}
+export function VariantsCollection(http, data) {
+    const obj = cloneDeep(data.entries) || []
+    const variantCollection = obj.map((variant) => {
+        return new Variants(http, {
+            content_type_uid: variant.content_type_uid,
+            entry_uid: variant.entry_uid,
+            variants_uid: variant.uid,
+            stackHeaders: data.stackHeaders
+        })
+    })
+    return variantCollection
+}
+
+export function createFormData(variants) {
+    return () => {
+        const formData = new FormData()
+        const uploadStream = createReadStream(variants)
+        formData.append('variants', uploadStream)
+        return formData
+    }
+}