@contentstack/cli-cm-export 2.0.0-beta.6 → 2.0.0-beta.8

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.6 linux-x64 node-v22.22.0
+@contentstack/cli-cm-export/2.0.0-beta.8 linux-x64 node-v22.22.0
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND

package/lib/commands/cm/stacks/export.js

@@ -20,14 +20,15 @@ class ExportCommand extends cli_command_1.Command {
             const managementAPIClient = await (0, cli_utilities_1.managementSDKClient)(exportConfig);
             const moduleExporter = new export_1.ModuleExporter(managementAPIClient, exportConfig);
             await moduleExporter.start();
+            const sessionLogPath = (0, cli_utilities_1.getSessionLogPath)();
             cli_utilities_1.log.success(`The content of the stack ${exportConfig.apiKey} has been exported successfully!`);
             cli_utilities_1.log.info(`The exported content has been stored at '${exportDir}'`, exportConfig.context);
-            cli_utilities_1.log.success(`The log has been stored at '${(0, cli_utilities_1.getLogPath)()}'`, exportConfig.context);
+            cli_utilities_1.log.success(`The log has been stored at '${sessionLogPath}'`, exportConfig.context);
             // Print comprehensive summary at the end
             if (!exportConfig.branches)
                 cli_utilities_1.CLIProgressManager.printGlobalSummary();
             if (!((_a = cli_utilities_1.configHandler.get('log')) === null || _a === void 0 ? void 0 : _a.showConsoleLogs)) {
-                cli_utilities_1.cliux.print(`The log has been stored at '${(0, cli_utilities_1.getLogPath)()}'`, { color: 'green' });
+                cli_utilities_1.cliux.print(`The log has been stored at '${sessionLogPath}'`, { color: 'green' });
             }
             // Clear progress module setting now that export is complete
             (0, cli_utilities_1.clearProgressModuleSetting)();
@@ -36,9 +37,10 @@ class ExportCommand extends cli_command_1.Command {
             // Clear progress module setting even on error
             (0, cli_utilities_1.clearProgressModuleSetting)();
             (0, cli_utilities_1.handleAndLogError)(error);
+            const sessionLogPath = (0, cli_utilities_1.getSessionLogPath)();
             if (!((_b = cli_utilities_1.configHandler.get('log')) === null || _b === void 0 ? void 0 : _b.showConsoleLogs)) {
                 cli_utilities_1.cliux.print(`Error: ${error}`, { color: 'red' });
-                cli_utilities_1.cliux.print(`The log has been stored at '${(0, cli_utilities_1.getLogPath)()}'`, { color: 'green' });
+                cli_utilities_1.cliux.print(`The log has been stored at '${sessionLogPath}'`, { color: 'green' });
             }
         }
     }

package/lib/constants/index.d.ts

@@ -0,0 +1,57 @@
+export declare const PATH_CONSTANTS: {
+    /** Root mapper directory (contains module-specific mapper subdirs) */
+    readonly MAPPER: "mapper";
+    /** Common mapper file names */
+    readonly FILES: {
+        readonly SUCCESS: "success.json";
+        readonly FAILS: "fails.json";
+        readonly UID_MAPPING: "uid-mapping.json";
+        readonly URL_MAPPING: "url-mapping.json";
+        readonly UID_MAPPER: "uid-mapper.json";
+        readonly SCHEMA: "schema.json";
+        readonly SETTINGS: "settings.json";
+        readonly MODIFIED_SCHEMAS: "modified-schemas.json";
+        readonly UNIQUE_MAPPING: "unique-mapping.json";
+        readonly TAXONOMIES: "taxonomies.json";
+        readonly ENVIRONMENTS: "environments.json";
+        readonly PENDING_EXTENSIONS: "pending_extensions.js";
+        readonly PENDING_GLOBAL_FIELDS: "pending_global_fields.js";
+        readonly INDEX: "index.json";
+        readonly FOLDER_MAPPING: "folder-mapping.json";
+        readonly VERSIONED_ASSETS: "versioned-assets.json";
+    };
+    /** Module subdirectory names within mapper */
+    readonly MAPPER_MODULES: {
+        readonly ASSETS: "assets";
+        readonly ENTRIES: "entries";
+        readonly CONTENT_TYPES: "content_types";
+        readonly TAXONOMIES: "taxonomies";
+        readonly TAXONOMY_TERMS: "terms";
+        readonly GLOBAL_FIELDS: "global_fields";
+        readonly EXTENSIONS: "extensions";
+        readonly WORKFLOWS: "workflows";
+        readonly WEBHOOKS: "webhooks";
+        readonly LABELS: "labels";
+        readonly ENVIRONMENTS: "environments";
+        readonly MARKETPLACE_APPS: "marketplace_apps";
+        readonly CUSTOM_ROLES: "custom-roles";
+        readonly LANGUAGES: "languages";
+    };
+    /** Content directory names (used in both import and export) */
+    readonly CONTENT_DIRS: {
+        readonly ASSETS: "assets";
+        readonly ENTRIES: "entries";
+        readonly CONTENT_TYPES: "content_types";
+        readonly TAXONOMIES: "taxonomies";
+        readonly GLOBAL_FIELDS: "global_fields";
+        readonly EXTENSIONS: "extensions";
+        readonly WEBHOOKS: "webhooks";
+        readonly WORKFLOWS: "workflows";
+        readonly LABELS: "labels";
+        readonly ENVIRONMENTS: "environments";
+        readonly STACK: "stack";
+        readonly LOCALES: "locales";
+        readonly MARKETPLACE_APPS: "marketplace_apps";
+    };
+};
+export type PathConstants = typeof PATH_CONSTANTS;

package/lib/constants/index.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATH_CONSTANTS = void 0;
+exports.PATH_CONSTANTS = {
+    /** Root mapper directory (contains module-specific mapper subdirs) */
+    MAPPER: 'mapper',
+    /** Common mapper file names */
+    FILES: {
+        SUCCESS: 'success.json',
+        FAILS: 'fails.json',
+        UID_MAPPING: 'uid-mapping.json',
+        URL_MAPPING: 'url-mapping.json',
+        UID_MAPPER: 'uid-mapper.json',
+        SCHEMA: 'schema.json',
+        SETTINGS: 'settings.json',
+        MODIFIED_SCHEMAS: 'modified-schemas.json',
+        UNIQUE_MAPPING: 'unique-mapping.json',
+        TAXONOMIES: 'taxonomies.json',
+        ENVIRONMENTS: 'environments.json',
+        PENDING_EXTENSIONS: 'pending_extensions.js',
+        PENDING_GLOBAL_FIELDS: 'pending_global_fields.js',
+        INDEX: 'index.json',
+        FOLDER_MAPPING: 'folder-mapping.json',
+        VERSIONED_ASSETS: 'versioned-assets.json',
+    },
+    /** Module subdirectory names within mapper */
+    MAPPER_MODULES: {
+        ASSETS: 'assets',
+        ENTRIES: 'entries',
+        CONTENT_TYPES: 'content_types',
+        TAXONOMIES: 'taxonomies',
+        TAXONOMY_TERMS: 'terms',
+        GLOBAL_FIELDS: 'global_fields',
+        EXTENSIONS: 'extensions',
+        WORKFLOWS: 'workflows',
+        WEBHOOKS: 'webhooks',
+        LABELS: 'labels',
+        ENVIRONMENTS: 'environments',
+        MARKETPLACE_APPS: 'marketplace_apps',
+        CUSTOM_ROLES: 'custom-roles',
+        LANGUAGES: 'languages',
+    },
+    /** Content directory names (used in both import and export) */
+    CONTENT_DIRS: {
+        ASSETS: 'assets',
+        ENTRIES: 'entries',
+        CONTENT_TYPES: 'content_types',
+        TAXONOMIES: 'taxonomies',
+        GLOBAL_FIELDS: 'global_fields',
+        EXTENSIONS: 'extensions',
+        WEBHOOKS: 'webhooks',
+        WORKFLOWS: 'workflows',
+        LABELS: 'labels',
+        ENVIRONMENTS: 'environments',
+        STACK: 'stack',
+        LOCALES: 'locales',
+        MARKETPLACE_APPS: 'marketplace_apps',
+    },
+};

package/lib/export/modules/assets.js

@@ -16,6 +16,7 @@ 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 constants_1 = require("../../constants");
 const config_1 = tslib_1.__importDefault(require("../../config"));
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 const utils_1 = require("../../utils");
@@ -83,8 +84,7 @@ class ExportAssets extends base_class_1.default {
                 await this.downloadAssets();
                 progress.completeProcess(utils_1.PROCESS_NAMES.ASSET_DOWNLOADS, true);
             }
-            this.completeProgress(true);
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('ASSET_EXPORT_COMPLETE'), this.exportConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Asset export failed');
@@ -171,7 +171,7 @@ class ExportAssets extends base_class_1.default {
                 fs = new cli_utilities_1.FsUtility({
                     metaHandler,
                     moduleName: 'assets',
-                    indexFileName: 'assets.json',
+                    indexFileName: this.assetConfig.fileName,
                     basePath: this.assetsRootPath,
                     chunkFileSize: this.assetConfig.chunkFileSize,
                     metaPickKeys: (0, merge_1.default)(['uid', 'url', 'filename', 'parent_uid'], this.assetConfig.assetsMetaKeys),
@@ -236,7 +236,7 @@ class ExportAssets extends base_class_1.default {
             if (!fs && !(0, isEmpty_1.default)(response)) {
                 fs = new cli_utilities_1.FsUtility({
                     moduleName: 'assets',
-                    indexFileName: 'versioned-assets.json',
+                    indexFileName: constants_1.PATH_CONSTANTS.FILES.VERSIONED_ASSETS,
                     chunkFileSize: this.assetConfig.chunkFileSize,
                     basePath: (0, node_path_1.resolve)(this.assetsRootPath, 'versions'),
                     metaPickKeys: (0, merge_1.default)(['uid', 'url', 'filename', '_version', 'parent_uid'], this.assetConfig.assetsMetaKeys),

package/lib/export/modules/base-class.d.ts

@@ -9,6 +9,12 @@ export type ApiOptions = {
     reject: (error: any) => void;
     additionalInfo?: Record<any, any>;
 };
+export type CompleteProgressOptions = {
+    moduleName?: string;
+    customSuccessMessage?: string;
+    customWarningMessage?: string;
+    context?: Record<string, any>;
+};
 export type EnvType = {
     module: string;
     totalCount: number;
@@ -44,6 +50,17 @@ export default abstract class BaseClass {
      * Complete progress manager
      */
     protected completeProgress(success?: boolean, error?: string): void;
+    /**
+     * Complete progress and log success/warning message based on errors
+     * Checks the progress manager's failure count to determine if errors occurred
+     * @param options - Options object containing:
+     *   - moduleName: The module name to generate the message (e.g., 'Assets', 'Entries')
+     *                 If not provided, uses this.currentModuleName
+     *   - customSuccessMessage: Optional custom success message. If not provided, generates: "{moduleName} have been exported successfully!"
+     *   - customWarningMessage: Optional custom warning message. If not provided, generates: "{moduleName} have been exported with some errors. Please check the logs at: {sessionLogPath}"
+     *   - context: Optional context for logging
+     */
+    protected completeProgressWithMessage(options?: CompleteProgressOptions): void;
     protected withLoadingSpinner<T>(message: string, action: () => Promise<T>): Promise<T>;
     get stack(): any;
     delay(ms: number): Promise<void>;

package/lib/export/modules/base-class.js

@@ -49,6 +49,34 @@ class BaseClass {
         (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.complete(success, error);
         this.progressManager = null;
     }
+    /**
+     * Complete progress and log success/warning message based on errors
+     * Checks the progress manager's failure count to determine if errors occurred
+     * @param options - Options object containing:
+     *   - moduleName: The module name to generate the message (e.g., 'Assets', 'Entries')
+     *                 If not provided, uses this.currentModuleName
+     *   - customSuccessMessage: Optional custom success message. If not provided, generates: "{moduleName} have been exported successfully!"
+     *   - customWarningMessage: Optional custom warning message. If not provided, generates: "{moduleName} have been exported with some errors. Please check the logs at: {sessionLogPath}"
+     *   - context: Optional context for logging
+     */
+    completeProgressWithMessage(options) {
+        var _a, _b;
+        const logContext = (options === null || options === void 0 ? void 0 : options.context) || ((_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context) || {};
+        const failureCount = ((_b = this.progressManager) === null || _b === void 0 ? void 0 : _b.getFailureCount()) || 0;
+        const hasErrors = failureCount > 0;
+        const name = (options === null || options === void 0 ? void 0 : options.moduleName) || this.currentModuleName || 'Module';
+        // Generate default messages if not provided
+        const successMessage = (options === null || options === void 0 ? void 0 : options.customSuccessMessage) || `${name} have been exported successfully!`;
+        const sessionLogPath = (0, cli_utilities_1.getSessionLogPath)();
+        const warningMessage = (options === null || options === void 0 ? void 0 : options.customWarningMessage) || `${name} have been exported with some errors. Please check the logs at: ${sessionLogPath}`;
+        this.completeProgress(true);
+        if (hasErrors) {
+            cli_utilities_1.log.warn(warningMessage, logContext);
+        }
+        else {
+            cli_utilities_1.log.success(successMessage, logContext);
+        }
+    }
     async withLoadingSpinner(message, action) {
         var _a;
         const logConfig = cli_utilities_1.configHandler.get('log') || {};

package/lib/export/modules/content-types.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const path = tslib_1.__importStar(require("path"));
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 const utils_1 = require("../../utils");
 class ContentTypesExport extends base_class_1.default {
@@ -50,8 +51,7 @@ class ContentTypesExport extends base_class_1.default {
             progress.updateStatus('Fetching content types...');
             await this.getContentTypes();
             await this.writeContentTypes(this.contentTypes);
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('CONTENT_TYPE_EXPORT_COMPLETE'), this.exportConfig.context);
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
@@ -106,7 +106,7 @@ class ContentTypesExport extends base_class_1.default {
         await (0, utils_1.executeTask)(contentTypes, writeWithProgress.bind(this), {
             concurrency: this.exportConfig.writeConcurrency,
         });
-        const schemaFilePath = path.join(this.contentTypesDirPath, 'schema.json');
+        const schemaFilePath = path.join(this.contentTypesDirPath, constants_1.PATH_CONSTANTS.FILES.SCHEMA);
         cli_utilities_1.log.debug(`Writing aggregate schema to: ${schemaFilePath}`, this.exportConfig.context);
         return utils_1.fsUtil.writeFile(schemaFilePath, contentTypes);
     }

package/lib/export/modules/custom-roles.js

@@ -60,7 +60,7 @@ class ExportCustomRoles extends base_class_1.default {
             await this.getCustomRolesLocales();
             progress.completeProcess(utils_1.PROCESS_NAMES.PROCESS_MAPPINGS, true);
             cli_utilities_1.log.debug(`Custom roles export completed. Total custom roles: ${Object.keys(this.customRoles || {}).length}`, this.exportConfig.context);
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));

package/lib/export/modules/entries.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const path = tslib_1.__importStar(require("path"));
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const cli_variants_1 = require("@contentstack/cli-variants");
-const cli_utilities_2 = require("@contentstack/cli-utilities");
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 class EntriesExport extends base_class_1.default {
@@ -14,9 +14,9 @@ class EntriesExport extends base_class_1.default {
         this.stackAPIClient = stackAPIClient;
         this.exportConfig = exportConfig;
         this.entriesConfig = exportConfig.modules.entries;
-        this.entriesDirPath = path.resolve((0, cli_utilities_2.sanitizePath)(exportConfig.exportDir), (0, cli_utilities_2.sanitizePath)(exportConfig.branchName || ''), (0, cli_utilities_2.sanitizePath)(this.entriesConfig.dirName));
-        this.localesFilePath = path.resolve((0, cli_utilities_2.sanitizePath)(exportConfig.exportDir), (0, cli_utilities_2.sanitizePath)(exportConfig.branchName || ''), (0, cli_utilities_2.sanitizePath)(exportConfig.modules.locales.dirName), (0, cli_utilities_2.sanitizePath)(exportConfig.modules.locales.fileName));
-        this.schemaFilePath = path.resolve((0, cli_utilities_2.sanitizePath)(exportConfig.exportDir), (0, cli_utilities_2.sanitizePath)(exportConfig.branchName || ''), (0, cli_utilities_2.sanitizePath)(exportConfig.modules.content_types.dirName), 'schema.json');
+        this.entriesDirPath = path.resolve((0, cli_utilities_1.sanitizePath)(exportConfig.exportDir), (0, cli_utilities_1.sanitizePath)(exportConfig.branchName || ''), (0, cli_utilities_1.sanitizePath)(this.entriesConfig.dirName));
+        this.localesFilePath = path.resolve((0, cli_utilities_1.sanitizePath)(exportConfig.exportDir), (0, cli_utilities_1.sanitizePath)(exportConfig.branchName || ''), (0, cli_utilities_1.sanitizePath)(exportConfig.modules.locales.dirName), (0, cli_utilities_1.sanitizePath)(exportConfig.modules.locales.fileName));
+        this.schemaFilePath = path.resolve((0, cli_utilities_1.sanitizePath)(exportConfig.exportDir), (0, cli_utilities_1.sanitizePath)(exportConfig.branchName || ''), (0, cli_utilities_1.sanitizePath)(exportConfig.modules.content_types.dirName), constants_1.PATH_CONSTANTS.FILES.SCHEMA);
         this.projectInstance = new cli_variants_1.ExportProjects(this.exportConfig);
         this.exportConfig.context.module = utils_1.MODULE_CONTEXTS.ENTRIES;
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.ENTRIES];
@@ -86,8 +86,7 @@ class EntriesExport extends base_class_1.default {
                     this.variantEntries.completeExport();
                 }
             }
-            this.completeProgress(true);
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('ENTRIES_EXPORT_SUCCESS'), this.exportConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
@@ -206,12 +205,12 @@ class EntriesExport extends base_class_1.default {
         }
         if (Array.isArray(entriesSearchResponse === null || entriesSearchResponse === void 0 ? void 0 : entriesSearchResponse.items) && ((_b = entriesSearchResponse === null || entriesSearchResponse === void 0 ? void 0 : entriesSearchResponse.items) === null || _b === void 0 ? void 0 : _b.length) > 0) {
             if (options.skip === 0) {
-                const entryBasePath = path.join((0, cli_utilities_2.sanitizePath)(this.entriesDirPath), (0, cli_utilities_2.sanitizePath)(options.contentType), (0, cli_utilities_2.sanitizePath)(options.locale));
+                const entryBasePath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesDirPath), (0, cli_utilities_1.sanitizePath)(options.contentType), (0, cli_utilities_1.sanitizePath)(options.locale));
                 cli_utilities_1.log.debug(`Creating directory for entries at: ${entryBasePath}`, this.exportConfig.context);
                 await utils_1.fsUtil.makeDirectory(entryBasePath);
                 this.entriesFileHelper = new cli_utilities_1.FsUtility({
                     moduleName: 'entries',
-                    indexFileName: 'index.json',
+                    indexFileName: constants_1.PATH_CONSTANTS.FILES.INDEX,
                     basePath: entryBasePath,
                     chunkFileSize: this.entriesConfig.chunkFileSize,
                     keepMetadata: false,
@@ -228,7 +227,7 @@ class EntriesExport extends base_class_1.default {
             });
             if (this.entriesConfig.exportVersions) {
                 cli_utilities_1.log.debug('Exporting entry versions is enabled.', this.exportConfig.context);
-                let versionedEntryPath = path.join((0, cli_utilities_2.sanitizePath)(this.entriesDirPath), (0, cli_utilities_2.sanitizePath)(options.contentType), (0, cli_utilities_2.sanitizePath)(options.locale), 'versions');
+                let versionedEntryPath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesDirPath), (0, cli_utilities_1.sanitizePath)(options.contentType), (0, cli_utilities_1.sanitizePath)(options.locale), 'versions');
                 cli_utilities_1.log.debug(`Creating versioned entries directory at: ${versionedEntryPath}.`, this.exportConfig.context);
                 utils_1.fsUtil.makeDirectory(versionedEntryPath);
                 await this.fetchEntriesVersions(entriesSearchResponse.items, {
@@ -272,7 +271,7 @@ class EntriesExport extends base_class_1.default {
         cli_utilities_1.log.debug(`Fetching versions for ${entries.length} entries...`, this.exportConfig.context);
         const onSuccess = ({ response, apiData: entry }) => {
             var _a;
-            const versionFilePath = path.join((0, cli_utilities_2.sanitizePath)(options.versionedEntryPath), (0, cli_utilities_2.sanitizePath)(`${entry.uid}.json`));
+            const versionFilePath = path.join((0, cli_utilities_1.sanitizePath)(options.versionedEntryPath), (0, cli_utilities_1.sanitizePath)(`${entry.uid}.json`));
             cli_utilities_1.log.debug(`Writing versioned entry to: ${versionFilePath}`, this.exportConfig.context);
             utils_1.fsUtil.writeFile(versionFilePath, response);
             // Track version progress if the process exists

package/lib/export/modules/environments.js

@@ -47,9 +47,8 @@ class ExportEnvironments extends base_class_1.default {
                 const environmentsFilePath = (0, node_path_1.resolve)(this.environmentsFolderPath, this.environmentConfig.fileName);
                 cli_utilities_1.log.debug(`Writing environments to: ${environmentsFilePath}`, this.exportConfig.context);
                 utils_1.fsUtil.writeFile(environmentsFilePath, this.environments);
-                cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('ENVIRONMENT_EXPORT_COMPLETE', Object.keys(this.environments || {}).length), this.exportConfig.context);
             }
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));

package/lib/export/modules/extensions.js

@@ -48,9 +48,8 @@ class ExportExtensions extends base_class_1.default {
                 const extensionsFilePath = (0, node_path_1.resolve)(this.extensionsFolderPath, this.extensionConfig.fileName);
                 cli_utilities_1.log.debug(`Writing extensions to: ${extensionsFilePath}`, this.exportConfig.context);
                 utils_1.fsUtil.writeFile(extensionsFilePath, this.extensions);
-                cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('EXTENSION_EXPORT_COMPLETE', Object.keys(this.extensions || {}).length), this.exportConfig.context);
             }
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));

package/lib/export/modules/global-fields.js

@@ -50,8 +50,7 @@ class GlobalFieldsExport extends base_class_1.default {
             const globalFieldsFilePath = path.join(this.globalFieldsDirPath, this.globalFieldsConfig.fileName);
             cli_utilities_1.log.debug(`Writing global fields to: ${globalFieldsFilePath}`, this.exportConfig.context);
             utils_1.fsUtil.writeFile(globalFieldsFilePath, this.globalFields);
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('GLOBAL_FIELDS_EXPORT_COMPLETE', this.globalFields.length), this.exportConfig.context);
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             cli_utilities_1.log.debug('Error occurred during global fields export', this.exportConfig.context);

package/lib/export/modules/labels.js

@@ -47,9 +47,8 @@ class ExportLabels extends base_class_1.default {
                 const labelsFilePath = (0, node_path_1.resolve)(this.labelsFolderPath, this.labelConfig.fileName);
                 cli_utilities_1.log.debug(`Writing labels to: ${labelsFilePath}`, this.exportConfig.context);
                 utils_1.fsUtil.writeFile(labelsFilePath, this.labels);
-                cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('LABELS_EXPORT_COMPLETE', Object.keys(this.labels || {}).length), this.exportConfig.context);
             }
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));

package/lib/export/modules/locales.js

@@ -49,8 +49,7 @@ class LocaleExport extends base_class_1.default {
             utils_1.fsUtil.writeFile(localesFilePath, this.locales);
             cli_utilities_1.log.debug(`Writing master locale to: ${masterLocaleFilePath}`, this.exportConfig.context);
             utils_1.fsUtil.writeFile(masterLocaleFilePath, this.masterLocale);
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('LOCALES_EXPORT_COMPLETE', Object.keys(this.locales || {}).length, Object.keys(this.masterLocale || {}).length), this.exportConfig.context);
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));

package/lib/export/modules/marketplace-apps.js

@@ -64,8 +64,7 @@ class ExportMarketplaceApps extends base_class_1.default {
                 await this.getAppManifestAndAppConfig();
                 progress.completeProcess(utils_1.PROCESS_NAMES.FETCH_CONFIG_MANIFEST, true);
             }
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Marketplace apps export completed successfully', this.exportConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             cli_utilities_1.log.debug('Error occurred during marketplace apps export', this.exportConfig.context);

package/lib/export/modules/personalize.js

@@ -64,8 +64,7 @@ class ExportPersonalize extends base_class_1.default {
                 else {
                     cli_utilities_1.log.debug('No personalize modules configured for processing', this.exportConfig.context);
                 }
-                this.completeProgress(true);
-                cli_utilities_1.log.success('Personalize export completed successfully', this.exportConfig.context);
+                this.completeProgressWithMessage();
             }
             catch (moduleError) {
                 if (moduleError === 'Forbidden') {

package/lib/export/modules/stack.js

@@ -4,6 +4,7 @@ const tslib_1 = require("tslib");
 const find_1 = tslib_1.__importDefault(require("lodash/find"));
 const node_path_1 = require("node:path");
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 const utils_1 = require("../../utils");
 class ExportStack extends base_class_1.default {
@@ -81,8 +82,7 @@ class ExportStack extends base_class_1.default {
             else {
                 cli_utilities_1.log.debug('Locale locale already set, skipping locale fetch', this.exportConfig.context);
             }
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Stack export completed successfully', this.exportConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             cli_utilities_1.log.debug('Error occurred during stack export', this.exportConfig.context);
@@ -192,7 +192,7 @@ class ExportStack extends base_class_1.default {
             .settings()
             .then((resp) => {
             var _a;
-            utils_1.fsUtil.writeFile((0, node_path_1.resolve)(this.stackFolderPath, 'settings.json'), resp);
+            utils_1.fsUtil.writeFile((0, node_path_1.resolve)(this.stackFolderPath, constants_1.PATH_CONSTANTS.FILES.SETTINGS), resp);
             // Track progress for stack settings completion
             (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, 'stack settings', null, utils_1.PROCESS_NAMES.STACK_SETTINGS);
             cli_utilities_1.log.success('Exported stack settings successfully!', this.exportConfig.context);

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

@@ -10,6 +10,26 @@ export default class ExportTaxonomies extends BaseClass {
     private localesFilePath;
     constructor({ exportConfig, stackAPIClient }: ModuleClassParams);
     start(): Promise<void>;
+    /**
+     * Initialize export setup (create directories, get initial count)
+     */
+    private initializeExport;
+    /**
+     * Setup progress manager with processes
+     */
+    private setupProgress;
+    /**
+     * Determine if locale-based export is supported
+     */
+    private determineExportStrategy;
+    /**
+     * Fetch all taxonomies based on export strategy
+     */
+    private fetchAllTaxonomies;
+    /**
+     * Export all taxonomies with detailed information
+     */
+    private exportAllTaxonomies;
     /**
      * Process and export taxonomies for a specific locale
      */

package/lib/export/modules/taxonomies.js

@@ -17,44 +17,131 @@ class ExportTaxonomies extends base_class_1.default {
         this.taxonomiesConfig = exportConfig.modules.taxonomies;
         this.qs = { include_count: true, limit: this.taxonomiesConfig.limit || 100, skip: 0 };
         this.applyQueryFilters(this.qs, 'taxonomies');
-        this.exportConfig.context.module = 'taxonomies';
+        this.exportConfig.context.module = utils_1.MODULE_CONTEXTS.TAXONOMIES;
+        this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.TAXONOMIES];
         this.localesFilePath = (0, node_path_1.resolve)((0, cli_utilities_1.sanitizePath)(exportConfig.exportDir), (0, cli_utilities_1.sanitizePath)(exportConfig.branchName || ''), (0, cli_utilities_1.sanitizePath)(exportConfig.modules.locales.dirName), (0, cli_utilities_1.sanitizePath)(exportConfig.modules.locales.fileName));
     }
     async start() {
         var _a;
-        cli_utilities_1.log.debug('Starting export process for taxonomies...', this.exportConfig.context);
-        //create taxonomies folder
-        this.taxonomiesFolderPath = (0, node_path_1.resolve)(this.exportConfig.exportDir, this.exportConfig.branchName || '', this.taxonomiesConfig.dirName);
-        cli_utilities_1.log.debug(`Taxonomies folder path: '${this.taxonomiesFolderPath}'`, this.exportConfig.context);
-        await utils_1.fsUtil.makeDirectory(this.taxonomiesFolderPath);
-        cli_utilities_1.log.debug('Created taxonomies directory.', this.exportConfig.context);
-        const localesToExport = this.getLocalesToExport();
-        cli_utilities_1.log.debug(`Will attempt to export taxonomies for ${localesToExport.length} locale(s): ${localesToExport.join(', ')}`, this.exportConfig.context);
-        if (localesToExport.length === 0) {
-            cli_utilities_1.log.warn('No locales found to export', this.exportConfig.context);
-            return;
+        try {
+            cli_utilities_1.log.debug('Starting export process for taxonomies...', this.exportConfig.context);
+            const totalCount = await this.initializeExport();
+            if (totalCount === 0) {
+                cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('TAXONOMY_NOT_FOUND'), this.exportConfig.context);
+                return;
+            }
+            const progress = this.setupProgress(totalCount);
+            const localesToExport = this.getLocalesToExport();
+            if (localesToExport.length === 0) {
+                cli_utilities_1.log.warn('No locales found to export', this.exportConfig.context);
+                this.completeProgress(true);
+                return;
+            }
+            // Start fetch process
+            progress
+                .startProcess(utils_1.PROCESS_NAMES.FETCH_TAXONOMIES)
+                .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.FETCH_TAXONOMIES].FETCHING, utils_1.PROCESS_NAMES.FETCH_TAXONOMIES);
+            // Determine export strategy and fetch taxonomies
+            await this.determineExportStrategy((_a = this.exportConfig.master_locale) === null || _a === void 0 ? void 0 : _a.code);
+            await this.fetchAllTaxonomies(localesToExport);
+            progress.completeProcess(utils_1.PROCESS_NAMES.FETCH_TAXONOMIES, true);
+            // Export taxonomies with detailed information
+            const actualCount = await this.exportAllTaxonomies(progress, localesToExport, totalCount);
+            // Write metadata and complete
+            await this.writeTaxonomiesMetadata();
+            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_COMPLETE', actualCount), this.exportConfig.context);
+            this.completeProgress(true);
         }
-        // Test locale-based export support with master locale
-        const masterLocale = (_a = this.exportConfig.master_locale) === null || _a === void 0 ? void 0 : _a.code;
+        catch (error) {
+            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
+            this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Taxonomies export failed');
+        }
+    }
+    /**
+     * Initialize export setup (create directories, get initial count)
+     */
+    async initializeExport() {
+        return this.withLoadingSpinner('TAXONOMIES: Analyzing taxonomy structure...', async () => {
+            this.taxonomiesFolderPath = (0, node_path_1.resolve)(this.exportConfig.exportDir, this.exportConfig.branchName || '', this.taxonomiesConfig.dirName);
+            cli_utilities_1.log.debug(`Taxonomies folder path: '${this.taxonomiesFolderPath}'`, this.exportConfig.context);
+            await utils_1.fsUtil.makeDirectory(this.taxonomiesFolderPath);
+            cli_utilities_1.log.debug('Created taxonomies directory.', this.exportConfig.context);
+            // Get count first for progress tracking
+            const countResponse = await this.stack
+                .taxonomy()
+                .query(Object.assign(Object.assign({}, this.qs), { include_count: true, limit: 1 }))
+                .find();
+            return countResponse.count || 0;
+        });
+    }
+    /**
+     * Setup progress manager with processes
+     */
+    setupProgress(totalCount) {
+        const progress = this.createNestedProgress(this.currentModuleName);
+        // For fetch: count API calls, not individual taxonomies
+        const fetchApiCallsCount = Math.ceil(totalCount / (this.qs.limit || 100));
+        progress.addProcess(utils_1.PROCESS_NAMES.FETCH_TAXONOMIES, fetchApiCallsCount);
+        progress.addProcess(utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS, totalCount);
+        return progress;
+    }
+    /**
+     * Determine if locale-based export is supported
+     */
+    async determineExportStrategy(masterLocale) {
         await this.fetchTaxonomies(masterLocale, true);
         if (!this.isLocaleBasedExportSupported) {
+            cli_utilities_1.log.debug('Falling back to legacy export (non-localized)', this.exportConfig.context);
             this.taxonomies = {};
             this.taxonomiesByLocale = {};
-            // Fetch taxonomies without locale parameter
-            await this.fetchTaxonomies();
-            await this.exportTaxonomies();
-            await this.writeTaxonomiesMetadata();
         }
         else {
-            // Process all locales with locale-based export
             cli_utilities_1.log.debug('Localization enabled, proceeding with locale-based export', this.exportConfig.context);
+        }
+    }
+    /**
+     * Fetch all taxonomies based on export strategy
+     */
+    async fetchAllTaxonomies(localesToExport) {
+        if (!this.isLocaleBasedExportSupported) {
+            await this.fetchTaxonomies();
+        }
+        else {
             for (const localeCode of localesToExport) {
                 await this.fetchTaxonomies(localeCode);
+            }
+        }
+    }
+    /**
+     * Export all taxonomies with detailed information
+     */
+    async exportAllTaxonomies(progress, localesToExport, totalCount) {
+        var _a;
+        const actualCount = (_a = Object.keys(this.taxonomies || {})) === null || _a === void 0 ? void 0 : _a.length;
+        cli_utilities_1.log.debug(`Found ${actualCount} taxonomies to export (API reported ${totalCount})`, this.exportConfig.context);
+        if (actualCount === 0) {
+            cli_utilities_1.log.info('No taxonomies found to export detailed information', this.exportConfig.context);
+            return 0;
+        }
+        // Update progress total if needed
+        if (actualCount !== totalCount) {
+            progress.updateProcessTotal(utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS, actualCount);
+        }
+        // Start export process
+        progress
+            .startProcess(utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS)
+            .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS].EXPORTING, utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS);
+        // Export based on strategy
+        if (!this.isLocaleBasedExportSupported) {
+            await this.exportTaxonomies();
+        }
+        else {
+            for (const localeCode of localesToExport) {
                 await this.processLocaleExport(localeCode);
             }
-            await this.writeTaxonomiesMetadata();
         }
-        cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_COMPLETE', (0, keys_1.default)(this.taxonomies || {}).length), this.exportConfig.context);
+        progress.completeProcess(utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS, true);
+        return actualCount;
     }
     /**
      * Process and export taxonomies for a specific locale
@@ -77,7 +164,7 @@ class ExportTaxonomies extends base_class_1.default {
             cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('TAXONOMY_NOT_FOUND'), this.exportConfig.context);
             return;
         }
-        const taxonomiesFilePath = (0, node_path_1.resolve)(this.taxonomiesFolderPath, 'taxonomies.json');
+        const taxonomiesFilePath = (0, node_path_1.resolve)(this.taxonomiesFolderPath, this.taxonomiesConfig.fileName);
         cli_utilities_1.log.debug(`Writing taxonomies metadata to: ${taxonomiesFilePath}`, this.exportConfig.context);
         utils_1.fsUtil.writeFile(taxonomiesFilePath, this.taxonomies);
     }
@@ -90,7 +177,7 @@ class ExportTaxonomies extends base_class_1.default {
      * @returns {Promise<void>}
      */
     async fetchTaxonomies(localeCode, checkLocaleSupport = false) {
-        var _a;
+        var _a, _b;
         let skip = 0;
         const localeInfo = localeCode ? `for locale: ${localeCode}` : '';
         if (localeCode && !this.taxonomiesByLocale[localeCode]) {
@@ -117,6 +204,10 @@ class ExportTaxonomies extends base_class_1.default {
                     this.isLocaleBasedExportSupported = false;
                 }
                 this.sanitizeTaxonomiesAttribs(items, localeCode);
+                // Track progress per API call (only for actual fetch, not locale support check)
+                if (!checkLocaleSupport) {
+                    (_b = this.progressManager) === null || _b === void 0 ? void 0 : _b.tick(true, `fetched ${items.length} taxonomies${localeInfo}`, null, utils_1.PROCESS_NAMES.FETCH_TAXONOMIES);
+                }
                 skip += this.qs.limit || 100;
                 if (skip >= taxonomiesCount) {
                     cli_utilities_1.log.debug(`Completed fetching all taxonomies ${localeInfo}`, this.exportConfig.context);
@@ -183,13 +274,21 @@ class ExportTaxonomies extends base_class_1.default {
             cli_utilities_1.log.debug(`Created locale folder: ${exportFolderPath}`, this.exportConfig.context);
         }
         const onSuccess = ({ response, uid }) => {
+            var _a, _b;
+            const taxonomyName = (_a = this.taxonomies[uid]) === null || _a === void 0 ? void 0 : _a.name;
             const filePath = (0, node_path_1.resolve)(exportFolderPath, `${uid}.json`);
             cli_utilities_1.log.debug(`Writing detailed taxonomy data to: ${filePath}`, this.exportConfig.context);
             utils_1.fsUtil.writeFile(filePath, response);
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_SUCCESS', uid), this.exportConfig.context);
+            // Track progress for each exported taxonomy
+            (_b = this.progressManager) === null || _b === void 0 ? void 0 : _b.tick(true, `taxonomy: ${taxonomyName || uid}`, null, utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS);
+            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_SUCCESS', taxonomyName || uid), this.exportConfig.context);
         };
         const onReject = ({ error, uid }) => {
+            var _a, _b;
+            const taxonomyName = (_a = this.taxonomies[uid]) === null || _a === void 0 ? void 0 : _a.name;
             cli_utilities_1.log.debug(`Failed to export detailed data for taxonomy: ${uid}${localeInfo}`, this.exportConfig.context);
+            // Track failure
+            (_b = this.progressManager) === null || _b === void 0 ? void 0 : _b.tick(false, `taxonomy: ${taxonomyName || uid}`, (error === null || error === void 0 ? void 0 : error.message) || utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS].FAILED, utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS);
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign(Object.assign({}, this.exportConfig.context), { uid }), (localeCode && { locale: localeCode })));
         };
         for (const taxonomyUID of taxonomiesUID) {

package/lib/export/modules/webhooks.js

@@ -43,9 +43,8 @@ class ExportWebhooks extends base_class_1.default {
                 const webhooksFilePath = (0, node_path_1.resolve)(this.webhooksFolderPath, this.webhookConfig.fileName);
                 cli_utilities_1.log.debug(`Writing webhooks to: ${webhooksFilePath}`, this.exportConfig.context);
                 utils_1.fsUtil.writeFile(webhooksFilePath, this.webhooks);
-                cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('WEBHOOK_EXPORT_COMPLETE', Object.keys(this.webhooks || {}).length), this.exportConfig.context);
             }
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));

package/lib/export/modules/workflows.js

@@ -46,9 +46,8 @@ class ExportWorkFlows extends base_class_1.default {
                 const workflowsFilePath = (0, node_path_1.resolve)(this.webhooksFolderPath, this.workflowConfig.fileName);
                 cli_utilities_1.log.debug(`Writing workflows to: ${workflowsFilePath}`, this.exportConfig.context);
                 utils_1.fsUtil.writeFile(workflowsFilePath, this.workflows);
-                cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('WORKFLOW_EXPORT_COMPLETE', Object.keys(this.workflows || {}).length), this.exportConfig.context);
             }
-            this.completeProgress(true);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));

package/oclif.manifest.json

@@ -121,5 +121,5 @@
       ]
     }
   },
-  "version": "2.0.0-beta.6"
+  "version": "2.0.0-beta.8"
 }

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@contentstack/cli-cm-export",
   "description": "Contentstack CLI plugin to export content from stack",
-  "version": "2.0.0-beta.6",
+  "version": "2.0.0-beta.8",
   "author": "Contentstack",
   "bugs": "https://github.com/contentstack/cli/issues",
   "dependencies": {
     "@contentstack/cli-command": "~1.7.2",
-    "@contentstack/cli-utilities": "~1.17.1",
+    "@contentstack/cli-utilities": "~1.17.2",
     "@contentstack/cli-variants": "~2.0.0-beta.4",
     "@oclif/core": "^4.8.0",
     "async": "^3.2.6",
     "big-json": "^3.2.0",
     "bluebird": "^3.7.2",
     "chalk": "^4.1.2",
-    "lodash": "^4.17.21",
+    "lodash": "^4.17.23",
     "merge": "^2.1.1",
     "mkdirp": "^1.0.4",
     "progress-stream": "^2.0.0",
@@ -22,7 +22,7 @@
   },
   "devDependencies": {
     "@contentstack/cli-auth": "~2.0.0-beta.4",
-    "@contentstack/cli-config": "~1.18.0",
+    "@contentstack/cli-config": "~2.0.0-beta",
     "@contentstack/cli-dev-dependencies": "~1.3.1",
     "@oclif/plugin-help": "^6.2.28",
     "@oclif/test": "^4.1.13",