@contentstack/cli-cm-export 2.0.0-beta.12 → 2.0.0-beta.14

package/README.md

@@ -48,7 +48,7 @@ $ npm install -g @contentstack/cli-cm-export
 $ csdx COMMAND
 running command...
 $ csdx (--version)
-@contentstack/cli-cm-export/2.0.0-beta.12 linux-x64 node-v22.22.1
+@contentstack/cli-cm-export/2.0.0-beta.14 linux-x64 node-v22.22.1
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND

package/lib/config/index.js

@@ -201,6 +201,7 @@ const config = {
         stack: {
             dirName: 'stack',
             fileName: 'stack.json',
+            invalidKeys: ['SYS_ACL', 'user_uids', 'owner_uid', 'description', 'master_key'],
         },
         dependency: {
             entries: ['stack', 'locales', 'content-types'],

package/lib/export/modules/assets.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const map_1 = tslib_1.__importDefault(require("lodash/map"));
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const cli_utilities_1 = require("@contentstack/cli-utilities");
 const chunk_1 = tslib_1.__importDefault(require("lodash/chunk"));
 const first_1 = tslib_1.__importDefault(require("lodash/first"));
 const merge_1 = tslib_1.__importDefault(require("lodash/merge"));
@@ -15,7 +15,7 @@ const includes_1 = tslib_1.__importDefault(require("lodash/includes"));
 const progress_stream_1 = tslib_1.__importDefault(require("progress-stream"));
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const cli_utilities_1 = require("@contentstack/cli-utilities");
+const cli_utilities_2 = require("@contentstack/cli-utilities");
 const constants_1 = require("../../constants");
 const config_1 = tslib_1.__importDefault(require("../../config"));
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
@@ -38,10 +38,10 @@ class ExportAssets extends base_class_1.default {
     }
     async start() {
         this.assetsRootPath = (0, node_path_1.resolve)(this.exportConfig.exportDir, this.exportConfig.branchName || '', this.assetConfig.dirName);
-        cli_utilities_1.log.debug(`Assets root path resolved to: ${this.assetsRootPath}`, this.exportConfig.context);
-        cli_utilities_1.log.debug('Fetching assets and folders count...', this.exportConfig.context);
+        cli_utilities_2.log.debug(`Assets root path resolved to: ${this.assetsRootPath}`, this.exportConfig.context);
+        cli_utilities_2.log.debug('Fetching assets and folders count...', this.exportConfig.context);
         // NOTE step 1: Get assets and it's folder count in parallel
-        const [assetsCount, assetsFolderCount] = await this.withLoadingSpinner(`${chalk_1.default.bold('ASSETS')}: Analyzing stack content...`, () => Promise.all([this.getAssetsCount(), this.getAssetsCount(true)]));
+        const [assetsCount, assetsFolderCount] = await this.withLoadingSpinner(`${(0, cli_utilities_1.getChalk)().bold('ASSETS')}: Analyzing stack content...`, () => Promise.all([this.getAssetsCount(), this.getAssetsCount(true)]));
         // Create nested progress manager
         const progress = this.createNestedProgress(this.currentModuleName);
         // Add sub-processes
@@ -71,7 +71,7 @@ class ExportAssets extends base_class_1.default {
             }
             // Get versioned assets
             if (!(0, isEmpty_1.default)(this.versionedAssets) && this.assetConfig.includeVersionedAssets) {
-                cli_utilities_1.log.debug('Fetching versioned assets metadata...', this.exportConfig.context);
+                cli_utilities_2.log.debug('Fetching versioned assets metadata...', this.exportConfig.context);
                 progress.updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.ASSET_METADATA].FETCHING_VERSION, utils_1.PROCESS_NAMES.ASSET_METADATA);
                 await this.getVersionedAssets();
             }
@@ -80,7 +80,7 @@ class ExportAssets extends base_class_1.default {
                 progress
                     .startProcess(utils_1.PROCESS_NAMES.ASSET_DOWNLOADS)
                     .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.ASSET_DOWNLOADS].DOWNLOADING, utils_1.PROCESS_NAMES.ASSET_DOWNLOADS);
-                cli_utilities_1.log.debug('Starting download of all assets...', this.exportConfig.context);
+                cli_utilities_2.log.debug('Starting download of all assets...', this.exportConfig.context);
                 await this.downloadAssets();
                 progress.completeProcess(utils_1.PROCESS_NAMES.ASSET_DOWNLOADS, true);
             }
@@ -99,9 +99,9 @@ class ExportAssets extends base_class_1.default {
         if (!totalCount)
             return Promise.resolve();
         const queryParam = Object.assign(Object.assign({}, this.commonQueryParam), { query: { is_dir: true } });
-        cli_utilities_1.log.debug(`Fetching asset folders with query: ${JSON.stringify(queryParam)}`, this.exportConfig.context);
+        cli_utilities_2.log.debug(`Fetching asset folders with query: ${JSON.stringify(queryParam)}`, this.exportConfig.context);
         const onSuccess = ({ response: { items } }) => {
-            cli_utilities_1.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} asset folders`, this.exportConfig.context);
+            cli_utilities_2.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} asset folders`, this.exportConfig.context);
             if (!(0, isEmpty_1.default)(items)) {
                 this.assetsFolder.push(...items);
                 items.forEach((folder) => {
@@ -113,7 +113,7 @@ class ExportAssets extends base_class_1.default {
         const onReject = ({ error }) => {
             var _a;
             (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(false, 'asset folder', (error === null || error === void 0 ? void 0 : error.message) || utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.ASSET_FOLDERS].FAILED, utils_1.PROCESS_NAMES.ASSET_FOLDERS);
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
+            (0, cli_utilities_2.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
         };
         return this.makeConcurrentCall({
             totalCount,
@@ -128,10 +128,10 @@ class ExportAssets extends base_class_1.default {
         }).then(() => {
             if (!(0, isEmpty_1.default)(this.assetsFolder)) {
                 const path = (0, node_path_1.resolve)(this.assetsRootPath, 'folders.json');
-                cli_utilities_1.log.debug(`Writing asset folders to ${path}`, this.exportConfig.context);
-                new cli_utilities_1.FsUtility({ basePath: this.assetsRootPath }).writeFile(path, this.assetsFolder);
+                cli_utilities_2.log.debug(`Writing asset folders to ${path}`, this.exportConfig.context);
+                new cli_utilities_2.FsUtility({ basePath: this.assetsRootPath }).writeFile(path, this.assetsFolder);
             }
-            cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('ASSET_FOLDERS_EXPORT_COMPLETE', this.assetsFolder.length), this.exportConfig.context);
+            cli_utilities_2.log.info(cli_utilities_2.messageHandler.parse('ASSET_FOLDERS_EXPORT_COMPLETE', this.assetsFolder.length), this.exportConfig.context);
         });
     }
     /**
@@ -142,7 +142,7 @@ class ExportAssets extends base_class_1.default {
     getAssets(totalCount) {
         if (!totalCount)
             return Promise.resolve();
-        cli_utilities_1.log.debug(`Fetching ${totalCount} assets...`, this.exportConfig.context);
+        cli_utilities_2.log.debug(`Fetching ${totalCount} assets...`, this.exportConfig.context);
         let fs;
         let metaHandler;
         const queryParam = Object.assign(Object.assign({}, this.commonQueryParam), { include_publish_details: true, except: { BASE: this.assetConfig.invalidKeys } });
@@ -150,7 +150,7 @@ class ExportAssets extends base_class_1.default {
         if (this.assetConfig.includeVersionedAssets) {
             const customHandler = (array) => {
                 const versionAssets = (0, filter_1.default)(array, ({ _version }) => _version > 1);
-                cli_utilities_1.log.debug(`Found ${versionAssets.length} versioned assets`, this.exportConfig.context);
+                cli_utilities_2.log.debug(`Found ${versionAssets.length} versioned assets`, this.exportConfig.context);
                 if (!(0, isEmpty_1.default)(versionAssets)) {
                     this.versionedAssets.push(...(0, map_1.default)(versionAssets, ({ uid, _version }) => ({
                         [uid]: _version,
@@ -162,13 +162,13 @@ class ExportAssets extends base_class_1.default {
         const onReject = ({ error }) => {
             var _a;
             (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(false, 'asset', (error === null || error === void 0 ? void 0 : error.message) || utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.ASSET_METADATA].FAILED, utils_1.PROCESS_NAMES.ASSET_METADATA);
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context), cli_utilities_1.messageHandler.parse('ASSET_QUERY_FAILED'));
+            (0, cli_utilities_2.handleAndLogError)(error, Object.assign({}, this.exportConfig.context), cli_utilities_2.messageHandler.parse('ASSET_QUERY_FAILED'));
         };
         const onSuccess = ({ response: { items } }) => {
-            cli_utilities_1.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} assets`, this.exportConfig.context);
+            cli_utilities_2.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} assets`, this.exportConfig.context);
             if (!fs && !(0, isEmpty_1.default)(items)) {
-                cli_utilities_1.log.debug('Initializing FsUtility for writing assets metadata', this.exportConfig.context);
-                fs = new cli_utilities_1.FsUtility({
+                cli_utilities_2.log.debug('Initializing FsUtility for writing assets metadata', this.exportConfig.context);
+                fs = new cli_utilities_2.FsUtility({
                     metaHandler,
                     moduleName: 'assets',
                     indexFileName: this.assetConfig.fileName,
@@ -178,7 +178,7 @@ class ExportAssets extends base_class_1.default {
                 });
             }
             if (!(0, isEmpty_1.default)(items)) {
-                cli_utilities_1.log.debug(`Writing ${items.length} assets into file`, this.exportConfig.context);
+                cli_utilities_2.log.debug(`Writing ${items.length} assets into file`, this.exportConfig.context);
                 fs === null || fs === void 0 ? void 0 : fs.writeIntoFile(items, { mapKeyVal: true });
                 // Track progress for each asset with process name
                 items.forEach((asset) => {
@@ -199,7 +199,7 @@ class ExportAssets extends base_class_1.default {
             concurrencyLimit: this.assetConfig.fetchConcurrency,
         }).then(() => {
             fs === null || fs === void 0 ? void 0 : fs.completeFile(true);
-            cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('ASSET_METADATA_EXPORT_COMPLETE'), this.exportConfig.context);
+            cli_utilities_2.log.info(cli_utilities_2.messageHandler.parse('ASSET_METADATA_EXPORT_COMPLETE'), this.exportConfig.context);
         });
     }
     /**
@@ -207,7 +207,7 @@ class ExportAssets extends base_class_1.default {
      * @returns Promise<any|void>
      */
     getVersionedAssets() {
-        cli_utilities_1.log.debug('Preparing to fetch versioned assets...', this.exportConfig.context);
+        cli_utilities_2.log.debug('Preparing to fetch versioned assets...', this.exportConfig.context);
         let fs;
         const queryParam = Object.assign(Object.assign({}, this.commonQueryParam), { include_publish_details: true, except: { BASE: this.assetConfig.invalidKeys } });
         const versionedAssets = (0, map_1.default)(this.versionedAssets, (element) => {
@@ -218,13 +218,13 @@ class ExportAssets extends base_class_1.default {
             }
             return batch;
         }).flat();
-        cli_utilities_1.log.debug(`Prepared ${versionedAssets.length} versioned asset queries`, this.exportConfig.context);
+        cli_utilities_2.log.debug(`Prepared ${versionedAssets.length} versioned asset queries`, this.exportConfig.context);
         const apiBatches = (0, chunk_1.default)(versionedAssets, this.assetConfig.fetchConcurrency);
         const promisifyHandler = (input) => {
             const { index, batchIndex, apiParams, isLastRequest } = input;
             const batch = apiBatches[batchIndex][index];
             const [uid, version] = (0, first_1.default)((0, entries_1.default)(batch));
-            cli_utilities_1.log.debug(`Fetching versioned asset [UID: ${uid}, Version: ${version}]`, this.exportConfig.context);
+            cli_utilities_2.log.debug(`Fetching versioned asset [UID: ${uid}, Version: ${version}]`, this.exportConfig.context);
             if (apiParams === null || apiParams === void 0 ? void 0 : apiParams.queryParam) {
                 apiParams.uid = uid;
                 apiParams.queryParam.version = version;
@@ -234,7 +234,7 @@ class ExportAssets extends base_class_1.default {
         };
         const onSuccess = ({ response }) => {
             if (!fs && !(0, isEmpty_1.default)(response)) {
-                fs = new cli_utilities_1.FsUtility({
+                fs = new cli_utilities_2.FsUtility({
                     moduleName: 'assets',
                     indexFileName: constants_1.PATH_CONSTANTS.FILES.VERSIONED_ASSETS,
                     chunkFileSize: this.assetConfig.chunkFileSize,
@@ -243,12 +243,12 @@ class ExportAssets extends base_class_1.default {
                 });
             }
             if (!(0, isEmpty_1.default)(response)) {
-                cli_utilities_1.log.debug(`Writing versioned asset: UID=${response.uid}, Version=${response._version}`, this.exportConfig.context);
+                cli_utilities_2.log.debug(`Writing versioned asset: UID=${response.uid}, Version=${response._version}`, this.exportConfig.context);
                 fs === null || fs === void 0 ? void 0 : fs.writeIntoFile([response], { mapKeyVal: true, keyName: ['uid', '_version'] });
             }
         };
         const onReject = ({ error }) => {
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context), cli_utilities_1.messageHandler.parse('ASSET_VERSIONED_QUERY_FAILED'));
+            (0, cli_utilities_2.handleAndLogError)(error, Object.assign({}, this.exportConfig.context), cli_utilities_2.messageHandler.parse('ASSET_VERSIONED_QUERY_FAILED'));
         };
         return this.makeConcurrentCall({
             apiBatches,
@@ -263,24 +263,24 @@ class ExportAssets extends base_class_1.default {
             concurrencyLimit: this.assetConfig.fetchConcurrency,
         }, promisifyHandler).then(() => {
             fs === null || fs === void 0 ? void 0 : fs.completeFile(true);
-            cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('ASSET_VERSIONED_METADATA_EXPORT_COMPLETE'), this.exportConfig.context);
+            cli_utilities_2.log.info(cli_utilities_2.messageHandler.parse('ASSET_VERSIONED_METADATA_EXPORT_COMPLETE'), this.exportConfig.context);
         });
     }
     getAssetsCount(isDir = false) {
         const queryParam = Object.assign(Object.assign({ limit: 1 }, this.commonQueryParam), { skip: 10 ** 100 });
         if (isDir)
             queryParam.query = { is_dir: true };
-        cli_utilities_1.log.debug(`Querying count of assets${isDir ? ' (folders only)' : ''} with params: ${JSON.stringify(queryParam)}`, this.exportConfig.context);
+        cli_utilities_2.log.debug(`Querying count of assets${isDir ? ' (folders only)' : ''} with params: ${JSON.stringify(queryParam)}`, this.exportConfig.context);
         return this.stack
             .asset()
             .query(queryParam)
             .count()
             .then(({ assets }) => {
-            cli_utilities_1.log.debug(`Received asset count: ${assets}`, this.exportConfig.context);
+            cli_utilities_2.log.debug(`Received asset count: ${assets}`, this.exportConfig.context);
             return assets;
         })
             .catch((error) => {
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context), cli_utilities_1.messageHandler.parse('ASSET_COUNT_QUERY_FAILED'));
+            (0, cli_utilities_2.handleAndLogError)(error, Object.assign({}, this.exportConfig.context), cli_utilities_2.messageHandler.parse('ASSET_COUNT_QUERY_FAILED'));
         });
     }
     /**
@@ -288,12 +288,12 @@ class ExportAssets extends base_class_1.default {
      * @returns Promise<any|void>
      */
     async downloadAssets() {
-        const fs = new cli_utilities_1.FsUtility({
+        const fs = new cli_utilities_2.FsUtility({
             fileExt: 'json',
             createDirIfNotExist: false,
             basePath: this.assetsRootPath,
         });
-        cli_utilities_1.log.debug('Reading asset metadata for download...', this.exportConfig.context);
+        cli_utilities_2.log.debug('Reading asset metadata for download...', this.exportConfig.context);
         const assetsMetaData = fs.getPlainMeta();
         let listOfAssets = (0, values_1.default)(assetsMetaData).flat();
         if (this.assetConfig.includeVersionedAssets) {
@@ -301,21 +301,21 @@ class ExportAssets extends base_class_1.default {
             listOfAssets.push(...(0, values_1.default)(versionedAssetsMetaData).flat());
         }
         listOfAssets = (0, uniqBy_1.default)(listOfAssets, 'url');
-        cli_utilities_1.log.debug(`Total unique assets to download: ${listOfAssets.length}`, this.exportConfig.context);
+        cli_utilities_2.log.debug(`Total unique assets to download: ${listOfAssets.length}`, this.exportConfig.context);
         const apiBatches = (0, chunk_1.default)(listOfAssets, this.assetConfig.downloadLimit);
-        const downloadedAssetsDirs = await (0, cli_utilities_1.getDirectories)((0, node_path_1.resolve)(this.assetsRootPath, 'files'));
+        const downloadedAssetsDirs = await (0, cli_utilities_2.getDirectories)((0, node_path_1.resolve)(this.assetsRootPath, 'files'));
         const onSuccess = ({ response: { data }, additionalInfo }) => {
             var _a;
             const { asset } = additionalInfo;
             const assetFolderPath = (0, node_path_1.resolve)(this.assetsRootPath, 'files', asset.uid);
             const assetFilePath = (0, node_path_1.resolve)(assetFolderPath, asset.filename);
-            cli_utilities_1.log.debug(`Saving asset to: ${assetFilePath}`, this.exportConfig.context);
+            cli_utilities_2.log.debug(`Saving asset to: ${assetFilePath}`, this.exportConfig.context);
             if (!(0, includes_1.default)(downloadedAssetsDirs, asset.uid)) {
                 fs.createFolderIfNotExist(assetFolderPath);
             }
             const assetWriterStream = (0, node_fs_1.createWriteStream)(assetFilePath);
             assetWriterStream.on('error', (error) => {
-                (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.exportConfig.context), { uid: asset.uid, filename: asset.fileName }), cli_utilities_1.messageHandler.parse('ASSET_DOWNLOAD_FAILED', asset.filename, asset.uid));
+                (0, cli_utilities_2.handleAndLogError)(error, Object.assign(Object.assign({}, this.exportConfig.context), { uid: asset.uid, filename: asset.fileName }), cli_utilities_2.messageHandler.parse('ASSET_DOWNLOAD_FAILED', asset.filename, asset.uid));
             });
             /**
              * NOTE if pipe not working as expected add the following code below to fix the issue
@@ -339,21 +339,21 @@ class ExportAssets extends base_class_1.default {
                 data.pipe(assetWriterStream);
             }
             (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `Downloaded asset: ${asset.filename || asset.uid}`, null, utils_1.PROCESS_NAMES.ASSET_DOWNLOADS);
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('ASSET_DOWNLOAD_SUCCESS', asset.filename, asset.uid), this.exportConfig.context);
+            cli_utilities_2.log.success(cli_utilities_2.messageHandler.parse('ASSET_DOWNLOAD_SUCCESS', asset.filename, asset.uid), this.exportConfig.context);
         };
         const onReject = ({ error, additionalInfo }) => {
             var _a;
             const { asset } = additionalInfo;
             (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(false, `Failed to download asset: ${asset.filename || asset.uid}`, null, utils_1.PROCESS_NAMES.ASSET_DOWNLOADS);
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.exportConfig.context), { uid: asset.uid, filename: asset.filename }), cli_utilities_1.messageHandler.parse('ASSET_DOWNLOAD_FAILED', asset.filename, asset.uid));
+            (0, cli_utilities_2.handleAndLogError)(error, Object.assign(Object.assign({}, this.exportConfig.context), { uid: asset.uid, filename: asset.filename }), cli_utilities_2.messageHandler.parse('ASSET_DOWNLOAD_FAILED', asset.filename, asset.uid));
         };
         const promisifyHandler = (input) => {
             const { index, batchIndex } = input;
             const asset = apiBatches[batchIndex][index];
             const url = this.assetConfig.securedAssets
-                ? `${asset.url}?authtoken=${cli_utilities_1.configHandler.get('authtoken')}`
+                ? `${asset.url}?authtoken=${cli_utilities_2.configHandler.get('authtoken')}`
                 : asset.url;
-            cli_utilities_1.log.debug(`Preparing to download asset: ${asset.filename} (UID: ${asset.uid}) from URL: ${url}`, this.exportConfig.context);
+            cli_utilities_2.log.debug(`Preparing to download asset: ${asset.filename} (UID: ${asset.uid}) from URL: ${url}`, this.exportConfig.context);
             return this.makeAPICall({
                 reject: onReject,
                 resolve: onSuccess,
@@ -368,7 +368,7 @@ class ExportAssets extends base_class_1.default {
             totalCount: listOfAssets.length,
             concurrencyLimit: this.assetConfig.downloadLimit,
         }, promisifyHandler).then(() => {
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('ASSET_DOWNLOAD_COMPLETE'), this.exportConfig.context);
+            cli_utilities_2.log.success(cli_utilities_2.messageHandler.parse('ASSET_DOWNLOAD_COMPLETE'), this.exportConfig.context);
         });
     }
 }

package/lib/export/modules/stack.d.ts

@@ -8,6 +8,16 @@ export default class ExportStack extends BaseClass {
     start(): Promise<void>;
     getStack(): Promise<any>;
     getLocales(skip?: number): Promise<any>;
-    exportStack(): Promise<any>;
+    /**
+     * Reuse stack snapshot from `getStack()` when present so we do not call `stack.fetch()` twice
+     * (same GET /stacks payload as writing stack.json). Falls back to `this.stack.fetch()` otherwise.
+     */
+    exportStack(preloadedStack?: Record<string, any> | null): Promise<any>;
+    private isStackFetchPayload;
+    /**
+     * Management-token exports cannot use Stack CMA endpoints for full metadata; write api_key from config only.
+     */
+    private writeStackJsonFromConfigApiKeyOnly;
+    private persistStackJsonPayload;
     exportStackSettings(): Promise<any>;
 }

package/lib/export/modules/stack.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const find_1 = tslib_1.__importDefault(require("lodash/find"));
+const omit_1 = tslib_1.__importDefault(require("lodash/omit"));
 const node_path_1 = require("node:path");
 const cli_utilities_1 = require("@contentstack/cli-utilities");
 const constants_1 = require("../../constants");
@@ -17,35 +18,31 @@ class ExportStack extends base_class_1.default {
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.STACK];
     }
     async start() {
+        var _a;
         try {
             cli_utilities_1.log.debug('Starting stack export process...', this.exportConfig.context);
-            // Initial analysis with loading spinner
+            // Initial analysis with loading spinner (skip getStack when using management token — no SDK snapshot)
             const [stackData] = await this.withLoadingSpinner('STACK: Analyzing stack configuration...', async () => {
-                const stackData = (0, cli_utilities_1.isAuthenticated)() ? await this.getStack() : null;
+                const stackData = this.exportConfig.management_token || !(0, cli_utilities_1.isAuthenticated)() ? null : await this.getStack();
                 return [stackData];
             });
             // Create nested progress manager
             const progress = this.createNestedProgress(this.currentModuleName);
-            // Add processes based on configuration
-            let processCount = 0;
-            if (stackData === null || stackData === void 0 ? void 0 : stackData.org_uid) {
-                cli_utilities_1.log.debug(`Found organization UID: '${stackData.org_uid}'.`, this.exportConfig.context);
-                this.exportConfig.org_uid = stackData.org_uid;
+            const orgUid = (_a = stackData === null || stackData === void 0 ? void 0 : stackData.org_uid) !== null && _a !== void 0 ? _a : stackData === null || stackData === void 0 ? void 0 : stackData.organization_uid;
+            if (orgUid) {
+                cli_utilities_1.log.debug(`Found organization UID: '${orgUid}'.`, this.exportConfig.context);
+                this.exportConfig.org_uid = orgUid;
                 this.exportConfig.sourceStackName = stackData.name;
                 cli_utilities_1.log.debug(`Set source stack name: ${stackData.name}`, this.exportConfig.context);
             }
             if (!this.exportConfig.management_token) {
                 progress.addProcess(utils_1.PROCESS_NAMES.STACK_SETTINGS, 1);
-                processCount++;
             }
+            progress.addProcess(utils_1.PROCESS_NAMES.STACK_DETAILS, 1);
             if (!this.exportConfig.preserveStackVersion && !this.exportConfig.hasOwnProperty('master_locale')) {
                 progress.addProcess(utils_1.PROCESS_NAMES.STACK_LOCALE, 1);
-                processCount++;
-            }
-            else if (this.exportConfig.preserveStackVersion) {
-                progress.addProcess(utils_1.PROCESS_NAMES.STACK_DETAILS, 1);
-                processCount++;
             }
+            let stackDetailsExportResult;
             // Execute processes
             if (!this.exportConfig.management_token) {
                 progress
@@ -53,9 +50,19 @@ class ExportStack extends base_class_1.default {
                     .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.STACK_SETTINGS].EXPORTING, utils_1.PROCESS_NAMES.STACK_SETTINGS);
                 await this.exportStackSettings();
                 progress.completeProcess(utils_1.PROCESS_NAMES.STACK_SETTINGS, true);
+                progress
+                    .startProcess(utils_1.PROCESS_NAMES.STACK_DETAILS)
+                    .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.STACK_DETAILS].EXPORTING, utils_1.PROCESS_NAMES.STACK_DETAILS);
+                stackDetailsExportResult = await this.exportStack(stackData);
+                progress.completeProcess(utils_1.PROCESS_NAMES.STACK_DETAILS, true);
             }
             else {
                 cli_utilities_1.log.info('Skipping stack settings export: Operation is not supported when using a management token.', this.exportConfig.context);
+                progress
+                    .startProcess(utils_1.PROCESS_NAMES.STACK_DETAILS)
+                    .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.STACK_DETAILS].EXPORTING, utils_1.PROCESS_NAMES.STACK_DETAILS);
+                stackDetailsExportResult = await this.writeStackJsonFromConfigApiKeyOnly();
+                progress.completeProcess(utils_1.PROCESS_NAMES.STACK_DETAILS, true);
             }
             if (!this.exportConfig.preserveStackVersion && !this.exportConfig.hasOwnProperty('master_locale')) {
                 progress
@@ -71,13 +78,8 @@ class ExportStack extends base_class_1.default {
                 return masterLocale;
             }
             else if (this.exportConfig.preserveStackVersion) {
-                progress
-                    .startProcess(utils_1.PROCESS_NAMES.STACK_DETAILS)
-                    .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.STACK_DETAILS].EXPORTING, utils_1.PROCESS_NAMES.STACK_DETAILS);
-                const stackResult = await this.exportStack();
-                progress.completeProcess(utils_1.PROCESS_NAMES.STACK_DETAILS, true);
                 this.completeProgress(true);
-                return stackResult;
+                return stackDetailsExportResult;
             }
             else {
                 cli_utilities_1.log.debug('Locale locale already set, skipping locale fetch', this.exportConfig.context);
@@ -161,22 +163,30 @@ class ExportStack extends base_class_1.default {
             throw error;
         });
     }
-    async exportStack() {
+    /**
+     * Reuse stack snapshot from `getStack()` when present so we do not call `stack.fetch()` twice
+     * (same GET /stacks payload as writing stack.json). Falls back to `this.stack.fetch()` otherwise.
+     */
+    async exportStack(preloadedStack) {
+        var _a;
         cli_utilities_1.log.debug(`Starting stack export for: '${this.exportConfig.apiKey}'...`, this.exportConfig.context);
         await utils_1.fsUtil.makeDirectory(this.stackFolderPath);
         cli_utilities_1.log.debug(`Created stack directory at: '${this.stackFolderPath}'`, this.exportConfig.context);
+        if (this.isStackFetchPayload(preloadedStack)) {
+            cli_utilities_1.log.debug('Reusing stack payload from analysis step (no extra stack.fetch).', this.exportConfig.context);
+            try {
+                return this.persistStackJsonPayload(preloadedStack);
+            }
+            catch (error) {
+                (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(false, 'stack export', (error === null || error === void 0 ? void 0 : error.message) || utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.STACK_DETAILS].FAILED, utils_1.PROCESS_NAMES.STACK_DETAILS);
+                (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
+                return undefined;
+            }
+        }
         return this.stack
             .fetch()
             .then((resp) => {
-            var _a;
-            const stackFilePath = (0, node_path_1.resolve)(this.stackFolderPath, this.stackConfig.fileName);
-            cli_utilities_1.log.debug(`Writing stack data to: '${stackFilePath}'`, this.exportConfig.context);
-            utils_1.fsUtil.writeFile(stackFilePath, resp);
-            // Track progress for stack export completion
-            (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `stack: ${this.exportConfig.apiKey}`, null, utils_1.PROCESS_NAMES.STACK_DETAILS);
-            cli_utilities_1.log.success(`Stack details exported successfully for stack ${this.exportConfig.apiKey}`, this.exportConfig.context);
-            cli_utilities_1.log.debug('Stack export completed successfully.', this.exportConfig.context);
-            return resp;
+            return this.persistStackJsonPayload(resp);
         })
             .catch((error) => {
             var _a;
@@ -185,6 +195,40 @@ class ExportStack extends base_class_1.default {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
         });
     }
+    isStackFetchPayload(data) {
+        return (typeof data === 'object' &&
+            data !== null &&
+            !Array.isArray(data) &&
+            ('api_key' in data || 'uid' in data));
+    }
+    /**
+     * Management-token exports cannot use Stack CMA endpoints for full metadata; write api_key from config only.
+     */
+    async writeStackJsonFromConfigApiKeyOnly() {
+        var _a;
+        if (!this.exportConfig.apiKey || typeof this.exportConfig.apiKey !== 'string') {
+            throw new Error('Stack API key is required to write stack.json when using a management token.');
+        }
+        cli_utilities_1.log.debug('Writing config-based stack.json (api_key only, no stack fetch).', this.exportConfig.context);
+        await utils_1.fsUtil.makeDirectory(this.stackFolderPath);
+        const payload = { api_key: this.exportConfig.apiKey };
+        const stackFilePath = (0, node_path_1.resolve)(this.stackFolderPath, this.stackConfig.fileName);
+        utils_1.fsUtil.writeFile(stackFilePath, payload);
+        (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `stack: ${this.exportConfig.apiKey}`, null, utils_1.PROCESS_NAMES.STACK_DETAILS);
+        cli_utilities_1.log.success(`Stack identifier written to stack.json from config for stack ${this.exportConfig.apiKey}`, this.exportConfig.context);
+        return payload;
+    }
+    persistStackJsonPayload(resp) {
+        var _a, _b;
+        const sanitized = (0, omit_1.default)(resp, (_a = this.stackConfig.invalidKeys) !== null && _a !== void 0 ? _a : []);
+        const stackFilePath = (0, node_path_1.resolve)(this.stackFolderPath, this.stackConfig.fileName);
+        cli_utilities_1.log.debug(`Writing stack data to: '${stackFilePath}'`, this.exportConfig.context);
+        utils_1.fsUtil.writeFile(stackFilePath, sanitized);
+        (_b = this.progressManager) === null || _b === void 0 ? void 0 : _b.tick(true, `stack: ${this.exportConfig.apiKey}`, null, utils_1.PROCESS_NAMES.STACK_DETAILS);
+        cli_utilities_1.log.success(`Stack details exported successfully for stack ${this.exportConfig.apiKey}`, this.exportConfig.context);
+        cli_utilities_1.log.debug('Stack export completed successfully.', this.exportConfig.context);
+        return sanitized;
+    }
     async exportStackSettings() {
         cli_utilities_1.log.info('Exporting stack settings...', this.exportConfig.context);
         await utils_1.fsUtil.makeDirectory(this.stackFolderPath);

package/lib/types/default-config.d.ts

@@ -132,6 +132,7 @@ export default interface DefaultConfig {
         stack: {
             dirName: string;
             fileName: string;
+            invalidKeys: string[];
             dependencies?: Modules[];
         };
         dependency: {

package/lib/types/index.d.ts

@@ -93,6 +93,7 @@ export interface CustomRoleConfig {
 export interface StackConfig {
     dirName: string;
     fileName: string;
+    invalidKeys: string[];
     dependencies?: Modules[];
     limit?: number;
 }

package/oclif.manifest.json

@@ -121,5 +121,5 @@
       ]
     }
   },
-  "version": "2.0.0-beta.12"
+  "version": "2.0.0-beta.14"
 }

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@contentstack/cli-cm-export",
   "description": "Contentstack CLI plugin to export content from stack",
-  "version": "2.0.0-beta.12",
+  "version": "2.0.0-beta.14",
   "author": "Contentstack",
   "bugs": "https://github.com/contentstack/cli/issues",
   "dependencies": {
-    "@contentstack/cli-command": "~2.0.0-beta.3",
-    "@contentstack/cli-utilities": "~2.0.0-beta.3",
-    "@contentstack/cli-variants": "~2.0.0-beta.9",
+    "@contentstack/cli-command": "~2.0.0-beta.5",
+    "@contentstack/cli-utilities": "~2.0.0-beta.5",
+    "@contentstack/cli-variants": "~2.0.0-beta.11",
     "@oclif/core": "^4.8.0",
     "async": "^3.2.6",
     "big-json": "^3.2.0",
     "bluebird": "^3.7.2",
-    "chalk": "^4.1.2",
+    "chalk": "^5.6.2",
     "lodash": "^4.17.23",
     "merge": "^2.1.1",
     "mkdirp": "^1.0.4",
@@ -21,8 +21,8 @@
     "winston": "^3.17.0"
   },
   "devDependencies": {
-    "@contentstack/cli-auth": "~2.0.0-beta.7",
-    "@contentstack/cli-config": "~2.0.0-beta.3",
+    "@contentstack/cli-auth": "~2.0.0-beta.9",
+    "@contentstack/cli-config": "~2.0.0-beta.5",
     "@contentstack/cli-dev-dependencies": "~2.0.0-beta.0",
     "@oclif/plugin-help": "^6.2.28",
     "@oclif/test": "^4.1.13",