Merge branch 'development' into fix/DX-2370

Author: cs-raj

.gitignore

@@ -67,4 +67,5 @@ tsconfig.json
 .next
 .dccache
 dist
-jsdocs
+jsdocs
+.early.coverage

.husky/pre-commit

@@ -1,11 +1,30 @@
 #!/usr/bin/env sh
-# Pre-commit hook to run Snyk and Talisman scans, completing both before deciding to commit
+# Pre-commit hook to run lint, Snyk and Talisman scans, completing all before deciding to commit
 
 # Function to check if a command exists
 command_exists() {
   command -v "$1" >/dev/null 2>&1
 }
 
+# Allow bypassing the hook with an environment variable
+if [ "$SKIP_HOOK" = "1" ]; then
+  echo "Skipping lint, Snyk and Talisman scans (SKIP_HOOK=1)."
+  exit 0
+fi
+
+# Run ESLint check first
+echo "Running ESLint check..."
+npm run lint
+lint_exit_code=$?
+
+if [ $lint_exit_code -ne 0 ]; then
+  echo "ESLint check failed. Please fix the linting issues and try again."
+  echo "You can run 'npm run format' to auto-fix most issues."
+  exit 1
+fi
+
+echo "ESLint check passed."
+
 # Check if Snyk is installed
 if ! command_exists snyk; then
   echo "Error: Snyk is not installed. Please install it and try again."
@@ -18,12 +37,6 @@ if ! command_exists talisman; then
   exit 1
 fi
 
-# Allow bypassing the hook with an environment variable
-if [ "$SKIP_HOOK" = "1" ]; then
-  echo "Skipping Snyk and Talisman scans (SKIP_HOOK=1)."
-  exit 0
-fi
-
 # Initialize variables to track scan results
 snyk_failed=false
 talisman_failed=false
@@ -63,7 +76,7 @@ if [ "$snyk_failed" = true ] || [ "$talisman_failed" = true ]; then
   exit 1
 fi
 
-# If both scans pass, allow the commit
-echo "All scans passed. Proceeding with commit.cd ."
+# If all checks pass, allow the commit
+echo "All checks passed (ESLint, Snyk, Talisman). Proceeding with commit."
 rm -f snyk_output.log talisman_output.log
 exit 0

.talismanrc

@@ -9,7 +9,17 @@ fileignoreconfig:
   ignore_detectors:
     - filecontent
 - filename: package-lock.json
-  checksum: 2f7e068e1479bf9a9acbba8ec797caa5cfbce0b435acb3b714e023aa44467e72
+  checksum: a184b5573183d051dc4f75af776a6b152e272eceef7b56fd3e1c80d88b392a58
 - filename: .husky/pre-commit
-  checksum: 5baabd7d2c391648163f9371f0e5e9484f8fb90fa2284cfc378732ec3192c193
-version: "1.0"
+  checksum: 52a664f536cf5d1be0bea19cb6031ca6e8107b45b6314fe7d47b7fad7d800632
+- filename: test/sanity-check/api/user-test.js
+  checksum: 6bb8251aad584e09f4d963a913bd0007e5f6e089357a44c3fb1529e3fda5509d
+- filename: lib/stack/asset/index.js
+  checksum: b3358310e9cb2fb493d70890b7219db71e2202360be764465d505ef71907eefe
+- filename: test/sanity-check/api/previewToken-test.js
+  checksum: 9a42e079b7c71f76932896a0d2390d86ac626678ab20d36821dcf962820a886c
+- filename: lib/stack/deliveryToken/index.js
+  checksum: 51ae00f07f4cc75c1cd832b311c2e2482f04a8467a0139da6013ceb88fbdda2f
+- filename: lib/stack/deliveryToken/previewToken/index.js
+  checksum: b506f33bffdd20dfc701f964370707f5d7b28a2c05c70665f0edb7b3c53c165b
+version: "1.0"

CHANGELOG.md

@@ -1,4 +1,36 @@
 # Changelog
+
+## [v1.23.1](https://github.com/contentstack/contentstack-management-javascript/tree/v1.24.0) (2025-07-28)
+ - Fix
+   - Add asset types support in bulk operations
+
+## [v1.23.0](https://github.com/contentstack/contentstack-management-javascript/tree/v1.23.0) (2025-07-28)
+ - Feature
+   - Added new getReferences method to Asset class for retrieving asset references
+   - Added comprehensive test coverage for Asset getReferences method across all test suites
+   - Dependency updates
+
+## [v1.22.0](https://github.com/contentstack/contentstack-management-javascript/tree/v1.22.0) (2025-07-07)
+ - Enhancement
+    - AWS-AU Region support added
+ - Fix
+   - Fixed branch header conflits
+## [v1.21.7](https://github.com/contentstack/contentstack-management-javascript/tree/v1.21.7) (2025-06-30)
+ - Fix
+   - Fixed Request-URI Too Large error
+
+## [v1.21.6](https://github.com/contentstack/contentstack-management-javascript/tree/v1.21.6) (2025-06-11)
+ - Fix
+   - Revert Retry Logic modification on x-ratelimit-remaining Header
+
+## [v1.21.5](https://github.com/contentstack/contentstack-management-javascript/tree/v1.21.5) (2025-06-09)
+ - Enhancement
+   - Preview token support added
+
+## [v1.21.4](https://github.com/contentstack/contentstack-management-javascript/tree/v1.21.4) (2025-06-02)
+ - Enhancement
+   - Retry Logic modification on x-ratelimit-remaining Header
+
 ## [v1.21.3](https://github.com/contentstack/contentstack-management-javascript/tree/v1.21.3) (2025-05-26)
  - Enhancement
    - Update addSettings Method to Support Generic Stack Settings Update

lib/contentstack.js

@@ -10,6 +10,7 @@ import httpClient from './core/contentstackHTTPClient.js'
 const regionHostMap = {
   NA: 'api.contentstack.io',
   EU: 'eu-api.contentstack.com',
+  AU: 'au-api.contentstack.com',
   AZURE_NA: 'azure-na-api.contentstack.com',
   AZURE_EU: 'azure-eu-api.contentstack.com',
   GCP_NA: 'gcp-na-api.contentstack.com',

lib/core/concurrency-queue.js

@@ -229,6 +229,7 @@ export function ConcurrencyQueue ({ axios, config }) {
     if (!this.config.retryOnError || networkError > this.config.retryLimit) {
       return Promise.reject(responseHandler(error))
     }
+    // Check rate limit remaining header before retrying
 
     // Error handling
     const wait = this.config.retryDelay

lib/entity.js

@@ -85,21 +85,20 @@ export const upload = async ({ http, urlPath, stackHeaders, formData, params, me
   }
 }
 
-export const create = ({ http, params = {}, createWithPreviewToken = false }) => {
+export const create = ({ http, params }) => {
   return async function (data, param) {
     this.stackHeaders = {
       ...this.stackHeaders
     }
-    const queryParams = {
-      ...(createWithPreviewToken ? { create_with_preview_token: true } : {}),
-      ...cloneDeep(param) // user param can override default
-    }
+
     const headers = {
       headers: {
         ...cloneDeep(params),
         ...cloneDeep(this.stackHeaders)
       },
-      params: queryParams
+      params: {
+        ...cloneDeep(param)
+      }
     } || {}
 
     try {
@@ -158,11 +157,6 @@ export const update = (http, type, params = {}) => {
     delete json.updated_at
     delete json.updated_by
 
-    // If param has data for this entity type, merge it with the json object
-    if (param && param[type]) {
-      Object.assign(json, param[type])
-    }
-
     if (type) {
       updateData[type] = json
       if (type === 'entry') updateData[type] = cleanAssets(updateData[type])
@@ -319,7 +313,6 @@ export const move = (http, type, force = false, params = {}) => {
     try {
       let updateData = {}
       const json = cloneDeep(this)
-      delete json.parent_uid
       if (type) {
         updateData[type] = json
       } else {
@@ -334,7 +327,7 @@ export const move = (http, type, force = false, params = {}) => {
       if (force === true) {
         headers.params.force = true
       }
-      const response = await http.put(`${this.urlPath}/move`, updateData, headers)
+      const response = await http.put(`${this.urlPath}/move`, param, headers)
       if (response.data) {
         return new this.constructor(http, parseData(response, this.stackHeaders, this.content_type_uid, this.taxonomy_uid, http))
       } else {

lib/stack/asset/index.js

@@ -152,6 +152,35 @@ export function Asset (http, data = {}) {
      *
      */
     this.unpublish = unpublish(http, 'asset')
+
+    /**
+     * @description The References function will get all the references for the asset.
+     * @memberof Asset
+     * @func references
+     * @returns {Promise<Array>} Array of references.
+     * @param {Object} param - Query parameters
+     * @example
+     * client.stack({ api_key: 'api_key'}).asset('uid').getReferences({ include_publish_details: true })
+     * .then((references) => console.log(references))
+     */
+    this.getReferences = async function (param = {}) {
+      try {
+        const headers = {
+          headers: { ...cloneDeep(this.stackHeaders) },
+          params: {
+            ...cloneDeep(param)
+          }
+        } || {}
+        const response = await http.get(this.urlPath + '/references', headers)
+        if (response.data) {
+          return response.data
+        } else {
+          throw error(response)
+        }
+      } catch (err) {
+        throw error(err)
+      }
+    }
   } else {
     /**
      *  @description The Folder allows to fetch and create folders in assets.

lib/stack/deliveryToken/index.js

@@ -1,5 +1,6 @@
 import cloneDeep from 'lodash/cloneDeep'
 import { create, update, deleteEntity, fetch, query } from '../../entity'
+import { PreviewToken } from './previewToken'
 
 /**
  * Delivery tokens provide read-only access to the associated environments. Read more about <a href='https://www.contentstack.com/docs/developers/create-tokens/about-delivery-tokens'>DeliveryToken</a>.
@@ -59,6 +60,22 @@ export function DeliveryToken (http, data = {}) {
      *
      */
     this.fetch = fetch(http, 'token')
+
+    /**
+     * @description The Create a PreviewToken call creates a new previewToken in a particular stack of your Contentstack account.
+     * @memberof DeliveryToken
+     * @func previewToken
+     * @returns {PreviewToken} Instance of PreviewToken.
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     * const deliveryToken = client.stack({ api_key: 'api_key'}).deliveryToken('delivery_token_uid')
+     * const previewToken = deliveryToken.previewToken()
+     * console.log(previewToken)
+     */
+    this.previewToken = () => {
+      return new PreviewToken(http, { stackHeaders: this.stackHeaders, token: { uid: this.uid } })
+    }
   } else {
     /**
      * @description The Create a DeliveryToken call creates a new deliveryToken in a particular stack of your Contentstack account.
@@ -84,7 +101,7 @@ export function DeliveryToken (http, data = {}) {
      * client.stack().deliveryToken().create({ token })
      * .then((deliveryToken) => console.log(deliveryToken))
      */
-    this.create = create({ http: http, createWithPreviewToken: true })
+    this.create = create({ http: http })
 
     /**
      * @description The ‘Get all deliveryToken’ request returns comprehensive information about all deliveryToken created in a stack.

lib/stack/deliveryToken/previewToken/index.js

@@ -0,0 +1,50 @@
+import cloneDeep from 'lodash/cloneDeep'
+import { create, deleteEntity } from '../../../entity'
+
+/**
+ * Preview tokens provide read-only access to the associated environments. Read more about <a href='https://www.contentstack.com/docs/developers/create-tokens/about-preview-tokens'>PreviewToken</a>.
+ * @namespace PreviewToken
+ */
+export function PreviewToken (http, data = {}) {
+  this.stackHeaders = data.stackHeaders
+  if (data.token) {
+    Object.assign(this, cloneDeep(data.token))
+    this.urlPath = `/stacks/delivery_tokens/${this.uid}/preview_token`
+
+    /**
+     * @description The Delete PreviewToken call is used to delete an existing PreviewToken permanently from your Stack.
+     * @memberof PreviewToken
+     * @func delete
+     * @returns {Object} Response Object.
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     *
+     * client.stack({ api_key: 'api_key'}).deliveryToken('delivery_token_uid').previewToken().delete()
+     * .then((response) => console.log(response.notice))
+     */
+    this.delete = deleteEntity(http)
+
+    /**
+     * @description The Create a PreviewToken call creates a new previewToken in a particular stack of your Contentstack account.
+     * @memberof PreviewToken
+     * @func create
+     * @returns {Promise<PreviewToken.PreviewToken>} Promise for PreviewToken instance
+     *
+     * @example
+     * import * as contentstack from '@contentstack/management'
+     * const client = contentstack.client()
+     * client.stack().deliveryToken('delivery_token_uid').previewToken().create()
+     * .then((previewToken) => console.log(previewToken))
+     */
+    this.create = create({ http: http })
+  }
+}
+
+export function PreviewTokenCollection (http, data) {
+  const obj = cloneDeep(data.tokens) || []
+  const previewTokenCollection = obj.map((userdata) => {
+    return new PreviewToken(http, { token: userdata, stackHeaders: data.stackHeaders })
+  })
+  return previewTokenCollection
+}