@contentstack/cli-cm-import 1.28.1 → 2.0.1-beta

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

@@ -16,7 +16,8 @@ const global_field_helper_1 = require("../../utils/global-field-helper");
 class ImportGlobalFields extends base_class_1.default {
     constructor({ importConfig, stackAPIClient }) {
         super({ importConfig, stackAPIClient });
-        this.importConfig.context.module = 'global-fields';
+        this.importConfig.context.module = utils_1.MODULE_CONTEXTS.GLOBAL_FIELDS;
+        this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.GLOBAL_FIELDS];
         this.config = importConfig;
         this.gFsConfig = importConfig.modules['global-fields'];
         this.gFs = [];
@@ -34,85 +35,86 @@ class ImportGlobalFields extends base_class_1.default {
         this.gFsPendingPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'global_fields', 'pending_global_fields.js');
         this.marketplaceAppMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'marketplace_apps', 'uid-mapping.json');
     }
+    /**
+     * @method start
+     * @returns {Promise<void>} Promise<void>
+     */
     async start() {
-        var _a, _b, _c, _d;
-        cli_utilities_1.log.debug('Reading global fields from file', this.importConfig.context);
-        this.gFs = utils_1.fsUtil.readFile(path.join(this.gFsFolderPath, this.gFsConfig.fileName));
-        if (!this.gFs || (0, lodash_1.isEmpty)(this.gFs)) {
-            cli_utilities_1.log.info('No global fields found to import', this.importConfig.context);
-            return;
-        }
-        const gfsCount = Array.isArray(this.gFs) ? this.gFs.length : Object.keys(this.gFs).length;
-        cli_utilities_1.log.debug(`Loaded ${gfsCount} global field items from file`, this.importConfig.context);
-        cli_utilities_1.log.debug('Creating global fields mapper directory', this.importConfig.context);
-        await utils_1.fsUtil.makeDirectory(this.gFsMapperPath);
-        cli_utilities_1.log.debug('Loading existing global fields UID data', this.importConfig.context);
-        if (utils_1.fileHelper.fileExistsSync(this.gFsUidMapperPath)) {
-            this.gFsUidMapper = (utils_1.fsUtil.readFile(this.gFsUidMapperPath) || {});
-            const gfsUidCount = Object.keys(this.gFsUidMapper || {}).length;
-            cli_utilities_1.log.debug(`Loaded existing global fields UID data: ${gfsUidCount} items`, this.importConfig.context);
-        }
-        else {
-            cli_utilities_1.log.debug('No existing global fields UID data found', this.importConfig.context);
-        }
-        cli_utilities_1.log.debug('Loading installed extensions data', this.importConfig.context);
-        this.installedExtensions = ((await utils_1.fsUtil.readFile(this.marketplaceAppMapperPath)) || { extension_uid: {} }).extension_uid;
-        const installedExtCount = Object.keys(this.installedExtensions || {}).length;
-        cli_utilities_1.log.debug(`Loaded ${installedExtCount} installed extension references`, this.importConfig.context);
-        cli_utilities_1.log.debug('Starting global fields seeding process', this.importConfig.context);
-        await this.seedGFs();
-        if ((_a = this.pendingGFs) === null || _a === void 0 ? void 0 : _a.length) {
-            utils_1.fsUtil.writeFile(this.gFsPendingPath, this.pendingGFs);
-            cli_utilities_1.log.debug(`Written ${this.pendingGFs.length} pending global fields to file`, this.importConfig.context);
-        }
-        cli_utilities_1.log.success('Created Global Fields', this.importConfig.context);
-        cli_utilities_1.log.debug('Starting global fields update process', this.importConfig.context);
-        await this.updateGFs();
-        if ((_b = this.pendingGFs) === null || _b === void 0 ? void 0 : _b.length)
-            utils_1.fsUtil.writeFile(this.gFsPendingPath, this.pendingGFs);
-        cli_utilities_1.log.success('Updated Global Fields', this.importConfig.context);
-        if (this.importConfig.replaceExisting && this.existingGFs.length > 0) {
-            cli_utilities_1.log.debug(`Replacing ${this.existingGFs.length} existing global fields`, this.importConfig.context);
-            await this.replaceGFs().catch((error) => {
-                cli_utilities_1.log.debug('Error replacing global fields', this.importConfig.context);
-                (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.importConfig.context));
-            });
-        }
-        cli_utilities_1.log.debug('Processing global fields import results', this.importConfig.context);
-        if ((_c = this.createdGFs) === null || _c === void 0 ? void 0 : _c.length) {
-            utils_1.fsUtil.writeFile(this.gFsSuccessPath, this.createdGFs);
-            cli_utilities_1.log.debug(`Written ${this.createdGFs.length} successful global fields to file`, this.importConfig.context);
+        try {
+            cli_utilities_1.log.debug('Starting global fields import process...', this.importConfig.context);
+            const [globalFieldsCount] = await this.analyzeGlobalFields();
+            if (globalFieldsCount === 0) {
+                cli_utilities_1.log.info('No global fields found to import', this.importConfig.context);
+                return;
+            }
+            const progress = this.createNestedProgress(this.currentModuleName);
+            progress.addProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE, globalFieldsCount);
+            progress.addProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_UPDATE, globalFieldsCount);
+            await this.prepareGlobalFieldMapper();
+            // Step 1: Create global fields
+            progress
+                .startProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE)
+                .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE].CREATING, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE);
+            cli_utilities_1.log.info('Starting Create process', this.importConfig.context);
+            await this.seedGFs();
+            progress.completeProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE, true);
+            // Step 2: Update global fields with references
+            progress
+                .startProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_UPDATE)
+                .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.GLOBAL_FIELDS_UPDATE].UPDATING, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_UPDATE);
+            cli_utilities_1.log.info('Starting Update process', this.importConfig.context);
+            await this.updateGFs();
+            progress.completeProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_UPDATE, true);
+            // Step 3: Replace existing global fields if needed
+            if (this.importConfig.replaceExisting && this.existingGFs.length > 0) {
+                progress.addProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_REPLACE_EXISTING, this.existingGFs.length);
+                progress
+                    .startProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_REPLACE_EXISTING)
+                    .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.GLOBAL_FIELDS_REPLACE_EXISTING].REPLACING, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_REPLACE_EXISTING);
+                cli_utilities_1.log.info('Starting Replace Existing process', this.importConfig.context);
+                await this.replaceGFs();
+                progress.completeProcess(utils_1.PROCESS_NAMES.GLOBAL_FIELDS_REPLACE_EXISTING, true);
+            }
+            await this.processGlobalFieldResults();
+            this.completeProgress(true);
+            cli_utilities_1.log.success('Global fields import has been completed!', this.importConfig.context);
         }
-        if ((_d = this.failedGFs) === null || _d === void 0 ? void 0 : _d.length) {
-            utils_1.fsUtil.writeFile(this.gFsFailsPath, this.failedGFs);
-            cli_utilities_1.log.debug(`Written ${this.failedGFs.length} failed global fields to file`, this.importConfig.context);
+        catch (error) {
+            this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Global fields import failed');
+            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.importConfig.context));
         }
-        cli_utilities_1.log.success('Global fields import has been completed!', this.importConfig.context);
     }
     async seedGFs() {
         cli_utilities_1.log.debug('Starting global fields seeding process', this.importConfig.context);
-        const gfsToSeed = Array.isArray(this.gFs) ? this.gFs.length : Object.keys(this.gFs).length;
+        const gfsToSeed = Array.isArray(this.gFs) ? this.gFs.length : Object.keys(this.gFs || {}).length;
         cli_utilities_1.log.debug(`Seeding ${gfsToSeed} global fields`, this.importConfig.context);
         const onSuccess = ({ response: globalField, apiData: { uid } = undefined }) => {
+            var _a;
             this.createdGFs.push(globalField);
             this.gFsUidMapper[uid] = globalField;
+            (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `global field: ${globalField.uid}`, null, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE);
             cli_utilities_1.log.success(`Global field ${globalField.uid} created successfully`, this.importConfig.context);
-            cli_utilities_1.log.debug(`Global field creation completed: ${globalField.uid}`, this.importConfig.context);
+            cli_utilities_1.log.debug(`Global field Create completed: ${globalField.uid}`, this.importConfig.context);
         };
         const onReject = ({ error, apiData: globalField = undefined }) => {
-            var _a, _b;
+            var _a, _b, _c, _d, _e;
             const uid = (_a = globalField === null || globalField === void 0 ? void 0 : globalField.global_field) === null || _a === void 0 ? void 0 : _a.uid;
-            cli_utilities_1.log.debug(`Global field '${uid}' creation failed`, this.importConfig.context);
+            cli_utilities_1.log.debug(`Global field '${uid}' Create failed`, this.importConfig.context);
             if ((_b = error === null || error === void 0 ? void 0 : error.errors) === null || _b === void 0 ? void 0 : _b.title) {
                 if (this.importConfig.replaceExisting) {
                     this.existingGFs.push(globalField);
+                    (_c = this.progressManager) === null || _c === void 0 ? void 0 : _c.tick(true, `global field: ${uid} (marked for replacement)`, null, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE);
                     cli_utilities_1.log.debug(`Global field '${uid}' marked for replacement`, this.importConfig.context);
                 }
+                else {
+                    (_d = this.progressManager) === null || _d === void 0 ? void 0 : _d.tick(true, `global field: ${uid} (already exists)`, null, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE);
+                }
                 if (!this.importConfig.skipExisting) {
                     cli_utilities_1.log.info(`Global fields '${uid}' already exist`, this.importConfig.context);
                 }
             }
             else {
+                (_e = this.progressManager) === null || _e === void 0 ? void 0 : _e.tick(false, `global field: ${uid}`, (error === null || error === void 0 ? void 0 : error.message) || 'Failed to create global field', utils_1.PROCESS_NAMES.GLOBAL_FIELDS_CREATE);
                 (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.importConfig.context), { uid }), `Global fields '${uid}' failed to import`);
                 this.failedGFs.push({ uid });
             }
@@ -149,14 +151,18 @@ class ImportGlobalFields extends base_class_1.default {
         return apiOptions;
     }
     async updateGFs() {
-        cli_utilities_1.log.debug('Starting global fields update process', this.importConfig.context);
-        const gfsToUpdate = Array.isArray(this.gFs) ? this.gFs.length : Object.keys(this.gFs).length;
+        cli_utilities_1.log.debug('Starting Update process', this.importConfig.context);
+        const gfsToUpdate = Array.isArray(this.gFs) ? this.gFs.length : Object.keys(this.gFs || {}).length;
         cli_utilities_1.log.debug(`Updating ${gfsToUpdate} global fields`, this.importConfig.context);
         const onSuccess = ({ response: globalField, apiData: { uid } = undefined }) => {
-            cli_utilities_1.log.info(`Updated the global field ${uid}`, this.importConfig.context);
+            var _a;
+            (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `global field: ${uid}`, null, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_UPDATE);
+            cli_utilities_1.log.success(`Updated the global field ${uid}`, this.importConfig.context);
             cli_utilities_1.log.debug(`Global field update completed: ${uid}`, this.importConfig.context);
         };
         const onReject = ({ error, apiData: { uid } = undefined }) => {
+            var _a;
+            (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(false, `global field: ${uid}`, (error === null || error === void 0 ? void 0 : error.message) || `Failed to update the global field '${uid}'`, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_UPDATE);
             cli_utilities_1.log.debug(`Global field '${uid}' update failed`, this.importConfig.context);
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.importConfig.context), { uid }), `Failed to update the global field '${uid}'`);
         };
@@ -172,7 +178,7 @@ class ImportGlobalFields extends base_class_1.default {
             },
             concurrencyLimit: this.reqConcurrency,
         }, this.updateSerializedGFs.bind(this));
-        cli_utilities_1.log.debug('Global fields update process completed', this.importConfig.context);
+        cli_utilities_1.log.debug('Update process completed', this.importConfig.context);
         return result;
     }
     async updateSerializedGFs({ apiParams, element: globalField, isLastRequest, }) {
@@ -219,17 +225,19 @@ class ImportGlobalFields extends base_class_1.default {
     async replaceGFs() {
         cli_utilities_1.log.debug(`Replacing ${this.existingGFs.length} existing global fields`, this.importConfig.context);
         const onSuccess = ({ response: globalField, apiData }) => {
-            var _a, _b, _c;
+            var _a, _b, _c, _d;
             const uid = (_c = (_a = apiData === null || apiData === void 0 ? void 0 : apiData.uid) !== null && _a !== void 0 ? _a : (_b = apiData === null || apiData === void 0 ? void 0 : apiData.global_field) === null || _b === void 0 ? void 0 : _b.uid) !== null && _c !== void 0 ? _c : 'unknown';
             this.createdGFs.push(globalField);
             this.gFsUidMapper[uid] = globalField;
+            (_d = this.progressManager) === null || _d === void 0 ? void 0 : _d.tick(true, `global field: ${uid} (replaced)`, null, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_REPLACE_EXISTING);
             utils_1.fsUtil.writeFile(this.gFsUidMapperPath, this.gFsUidMapper);
             cli_utilities_1.log.success(`Global field '${uid}' replaced successfully`, this.importConfig.context);
             cli_utilities_1.log.debug(`Global field replacement completed: ${uid}`, this.importConfig.context);
         };
         const onReject = ({ error, apiData }) => {
-            var _a, _b, _c;
+            var _a, _b, _c, _d;
             const uid = (_c = (_a = apiData === null || apiData === void 0 ? void 0 : apiData.uid) !== null && _a !== void 0 ? _a : (_b = apiData === null || apiData === void 0 ? void 0 : apiData.global_field) === null || _b === void 0 ? void 0 : _b.uid) !== null && _c !== void 0 ? _c : 'unknown';
+            (_d = this.progressManager) === null || _d === void 0 ? void 0 : _d.tick(false, `global field: ${uid}`, (error === null || error === void 0 ? void 0 : error.message) || `Global fields '${uid}' failed to replace`, utils_1.PROCESS_NAMES.GLOBAL_FIELDS_REPLACE_EXISTING);
             cli_utilities_1.log.debug(`Global field '${uid}' replacement failed`, this.importConfig.context);
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.importConfig.context), { uid }), `Global fields '${uid}' failed to replace`);
             this.failedGFs.push({ uid });
@@ -247,7 +255,7 @@ class ImportGlobalFields extends base_class_1.default {
             },
             concurrencyLimit: this.importConfig.concurrency || this.importConfig.fetchConcurrency || 1,
         }, undefined, false);
-        cli_utilities_1.log.debug('Global fields replacement process completed', this.importConfig.context);
+        cli_utilities_1.log.debug('Replace Existing process completed', this.importConfig.context);
     }
     /**
      * @method serializeReplaceGFs
@@ -267,5 +275,57 @@ class ImportGlobalFields extends base_class_1.default {
         apiOptions.apiData = globalFieldPayload;
         return apiOptions;
     }
+    async analyzeGlobalFields() {
+        return this.withLoadingSpinner('GLOBAL FIELDS: Analyzing import data...', async () => {
+            var _a, _b;
+            cli_utilities_1.log.debug('Checking for global fields folder existence', this.importConfig.context);
+            if (!utils_1.fileHelper.fileExistsSync(this.gFsFolderPath)) {
+                cli_utilities_1.log.info(`No global fields found - '${this.gFsFolderPath}'`, this.importConfig.context);
+                return [0];
+            }
+            cli_utilities_1.log.debug(`Found global fields folder: ${this.gFsFolderPath}`, this.importConfig.context);
+            this.gFs = utils_1.fsUtil.readFile(path.join(this.gFsFolderPath, this.gFsConfig.fileName));
+            if (!this.gFs || (0, lodash_1.isEmpty)(this.gFs)) {
+                cli_utilities_1.log.info(`No global fields found in file - '${path.join(this.gFsFolderPath, this.gFsConfig.fileName)}'`, this.importConfig.context);
+                return [0];
+            }
+            const count = Array.isArray(this.gFs) ? (_a = this.gFs) === null || _a === void 0 ? void 0 : _a.length : (_b = Object.keys(this.gFs || {})) === null || _b === void 0 ? void 0 : _b.length;
+            cli_utilities_1.log.debug(`Loaded ${count} global field items from file`, this.importConfig.context);
+            return [count];
+        });
+    }
+    async prepareGlobalFieldMapper() {
+        cli_utilities_1.log.debug('Creating global fields mapper directory', this.importConfig.context);
+        await utils_1.fsUtil.makeDirectory(this.gFsMapperPath);
+        cli_utilities_1.log.debug('Loading existing global fields UID data', this.importConfig.context);
+        if (utils_1.fileHelper.fileExistsSync(this.gFsUidMapperPath)) {
+            this.gFsUidMapper = (utils_1.fsUtil.readFile(this.gFsUidMapperPath) || {});
+            const gfsUidCount = Object.keys(this.gFsUidMapper || {}).length;
+            cli_utilities_1.log.debug(`Loaded existing global fields UID data: ${gfsUidCount} items`, this.importConfig.context);
+        }
+        else {
+            cli_utilities_1.log.debug('No existing global fields UID data found', this.importConfig.context);
+        }
+        cli_utilities_1.log.debug('Loading installed extensions data', this.importConfig.context);
+        this.installedExtensions = (utils_1.fsUtil.readFile(this.marketplaceAppMapperPath) || { extension_uid: {} }).extension_uid;
+        const installedExtCount = Object.keys(this.installedExtensions || {}).length;
+        cli_utilities_1.log.debug(`Loaded ${installedExtCount} installed extension references`, this.importConfig.context);
+    }
+    async processGlobalFieldResults() {
+        var _a, _b, _c;
+        cli_utilities_1.log.debug('Processing global fields import results', this.importConfig.context);
+        if ((_a = this.pendingGFs) === null || _a === void 0 ? void 0 : _a.length) {
+            utils_1.fsUtil.writeFile(this.gFsPendingPath, this.pendingGFs);
+            cli_utilities_1.log.debug(`Written ${this.pendingGFs.length} pending global fields to file`, this.importConfig.context);
+        }
+        if ((_b = this.createdGFs) === null || _b === void 0 ? void 0 : _b.length) {
+            utils_1.fsUtil.writeFile(this.gFsSuccessPath, this.createdGFs);
+            cli_utilities_1.log.debug(`Written ${this.createdGFs.length} successful global fields to file`, this.importConfig.context);
+        }
+        if ((_c = this.failedGFs) === null || _c === void 0 ? void 0 : _c.length) {
+            utils_1.fsUtil.writeFile(this.gFsFailsPath, this.failedGFs);
+            cli_utilities_1.log.debug(`Written ${this.failedGFs.length} failed global fields to file`, this.importConfig.context);
+        }
+    }
 }
 exports.default = ImportGlobalFields;

package/lib/import/modules/index.d.ts

@@ -1,2 +1,3 @@
 import { ModuleClassParams } from '../../types';
+import '../../utils/progress-strategy-registry';
 export default function startModuleImport(modulePayload: ModuleClassParams): Promise<any>;

package/lib/import/modules/index.js

@@ -24,6 +24,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
+require("../../utils/progress-strategy-registry");
 async function startModuleImport(modulePayload) {
     const { default: ModuleRunner } = await (_a = `./${modulePayload.moduleName}`, Promise.resolve().then(() => __importStar(require(_a))));
     const moduleRunner = new ModuleRunner(modulePayload);

package/lib/import/modules/labels.d.ts

@@ -31,4 +31,7 @@ export default class ImportLabels extends BaseClass {
      * @returns {ApiOptions} ApiOptions
      */
     serializeUpdateLabels(apiOptions: ApiOptions): ApiOptions;
+    private analyzeLabels;
+    private prepareLabelMapper;
+    private processLabelResults;
 }

package/lib/import/modules/labels.js

@@ -1,17 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const isEmpty_1 = tslib_1.__importDefault(require("lodash/isEmpty"));
-const values_1 = tslib_1.__importDefault(require("lodash/values"));
 const omit_1 = tslib_1.__importDefault(require("lodash/omit"));
 const node_path_1 = require("node:path");
-const utils_1 = require("../../utils");
+const isEmpty_1 = tslib_1.__importDefault(require("lodash/isEmpty"));
+const values_1 = tslib_1.__importDefault(require("lodash/values"));
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 class ImportLabels extends base_class_1.default {
     constructor({ importConfig, stackAPIClient }) {
         super({ importConfig, stackAPIClient });
-        this.importConfig.context.module = 'labels';
+        this.importConfig.context.module = utils_1.MODULE_CONTEXTS.LABELS;
+        this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.LABELS];
         this.labelsConfig = importConfig.modules.labels;
         this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, 'mapper', 'labels');
         this.labelsFolderPath = (0, node_path_1.join)(this.importConfig.backupDir, this.labelsConfig.dirName);
@@ -28,77 +29,72 @@ class ImportLabels extends base_class_1.default {
      * @returns {Promise<void>} Promise<void>
      */
     async start() {
-        var _a, _b;
-        cli_utilities_1.log.debug('Checking for labels folder existence', this.importConfig.context);
-        //Step1 check folder exists or not
-        if (utils_1.fileHelper.fileExistsSync(this.labelsFolderPath)) {
-            cli_utilities_1.log.debug(`Found labels folder: ${this.labelsFolderPath}`, this.importConfig.context);
-            this.labels = utils_1.fsUtil.readFile((0, node_path_1.join)(this.labelsFolderPath, 'labels.json'), true);
-            // Check if labels file was read successfully
-            if (!this.labels) {
-                cli_utilities_1.log.info(`No labels found in file - '${(0, node_path_1.join)(this.labelsFolderPath, 'labels.json')}'`, this.importConfig.context);
+        try {
+            cli_utilities_1.log.debug('Starting labels import process...', this.importConfig.context);
+            const [labelsCount] = await this.analyzeLabels();
+            if (labelsCount === 0) {
+                cli_utilities_1.log.info('No labels found to import', this.importConfig.context);
                 return;
             }
-            const labelCount = Object.keys(this.labels || {}).length;
-            cli_utilities_1.log.debug(`Loaded ${labelCount} label items from file`, this.importConfig.context);
-        }
-        else {
-            cli_utilities_1.log.info(`No labels found - '${this.labelsFolderPath}'`, this.importConfig.context);
-            return;
+            const progress = this.createNestedProgress(this.currentModuleName);
+            progress.addProcess(utils_1.PROCESS_NAMES.LABELS_CREATE, labelsCount);
+            progress.addProcess(utils_1.PROCESS_NAMES.LABELS_UPDATE, labelsCount);
+            await this.prepareLabelMapper();
+            // Step 1: Import labels (without parent references)
+            progress
+                .startProcess(utils_1.PROCESS_NAMES.LABELS_CREATE)
+                .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.LABELS_CREATE].CREATING, utils_1.PROCESS_NAMES.LABELS_CREATE);
+            cli_utilities_1.log.info('Starting labels creation process', this.importConfig.context);
+            await this.importLabels();
+            progress.completeProcess(utils_1.PROCESS_NAMES.LABELS_CREATE, true);
+            // Step 2: Update labels with parent references
+            progress
+                .startProcess(utils_1.PROCESS_NAMES.LABELS_UPDATE)
+                .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.LABELS_UPDATE].UPDATING, utils_1.PROCESS_NAMES.LABELS_UPDATE);
+            cli_utilities_1.log.info('Starting labels update process', this.importConfig.context);
+            await this.updateLabels();
+            progress.completeProcess(utils_1.PROCESS_NAMES.LABELS_UPDATE, true);
+            this.processLabelResults();
+            this.completeProgress(true);
+            cli_utilities_1.log.success('Labels have been imported successfully!', this.importConfig.context);
         }
-        //create labels in mapper directory
-        cli_utilities_1.log.debug('Creating labels mapper directory', this.importConfig.context);
-        await utils_1.fsUtil.makeDirectory(this.mapperDirPath);
-        cli_utilities_1.log.debug('Loading existing label UID mappings', this.importConfig.context);
-        this.labelUidMapper = utils_1.fileHelper.fileExistsSync(this.labelUidMapperPath)
-            ? utils_1.fsUtil.readFile((0, node_path_1.join)(this.labelUidMapperPath), true) || {}
-            : {};
-        if (Object.keys(this.labelUidMapper || {}).length > 0) {
-            const labelUidCount = Object.keys(this.labelUidMapper || {}).length;
-            cli_utilities_1.log.debug(`Loaded existing label UID data: ${labelUidCount} items`, this.importConfig.context);
-        }
-        else {
-            cli_utilities_1.log.debug('No existing label UID mappings found', this.importConfig.context);
-        }
-        cli_utilities_1.log.debug('Starting labels import', this.importConfig.context);
-        await this.importLabels();
-        //update parent in created label
-        cli_utilities_1.log.debug('Starting labels update process', this.importConfig.context);
-        await this.updateLabels();
-        cli_utilities_1.log.debug('Processing labels import results', this.importConfig.context);
-        if ((_a = this.createdLabel) === null || _a === void 0 ? void 0 : _a.length) {
-            utils_1.fsUtil.writeFile(this.createdLabelPath, this.createdLabel);
-            cli_utilities_1.log.debug(`Written ${this.createdLabel.length} successful labels to file`, this.importConfig.context);
-        }
-        if ((_b = this.failedLabel) === null || _b === void 0 ? void 0 : _b.length) {
-            utils_1.fsUtil.writeFile(this.labelFailsPath, this.failedLabel);
-            cli_utilities_1.log.debug(`Written ${this.failedLabel.length} failed labels to file`, this.importConfig.context);
+        catch (error) {
+            this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Labels import failed');
+            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.importConfig.context));
         }
-        cli_utilities_1.log.success('Labels have been imported successfully!', this.importConfig.context);
     }
     async importLabels() {
+        cli_utilities_1.log.debug('Validating labels data', this.importConfig.context);
         if (this.labels === undefined || (0, isEmpty_1.default)(this.labels)) {
             cli_utilities_1.log.info('No Labels Found', this.importConfig.context);
             return;
         }
         const apiContent = (0, values_1.default)(this.labels);
+        cli_utilities_1.log.debug(`Starting to import ${apiContent.length} labels`, this.importConfig.context);
         const onSuccess = ({ response, apiData: { uid, name } = { uid: null, name: '' } }) => {
+            var _a;
             this.labelUidMapper[uid] = response;
+            (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `label: ${name || uid}`, null, utils_1.PROCESS_NAMES.LABELS_CREATE);
             cli_utilities_1.log.success(`Label '${name}' imported successfully`, this.importConfig.context);
+            cli_utilities_1.log.debug(`Label UID mapping: ${uid} → ${response.uid}`, this.importConfig.context);
             utils_1.fsUtil.writeFile(this.labelUidMapperPath, this.labelUidMapper);
         };
         const onReject = ({ error, apiData }) => {
-            var _a;
+            var _a, _b, _c;
             const err = (error === null || error === void 0 ? void 0 : error.message) ? JSON.parse(error.message) : error;
-            const { name } = apiData;
+            const { name, uid } = apiData;
+            cli_utilities_1.log.debug(`Label '${name}' (${uid}) failed to import`, this.importConfig.context);
             if ((_a = err === null || err === void 0 ? void 0 : err.errors) === null || _a === void 0 ? void 0 : _a.name) {
+                (_b = this.progressManager) === null || _b === void 0 ? void 0 : _b.tick(true, `label: ${name || uid} (already exists)`, null, utils_1.PROCESS_NAMES.LABELS_CREATE);
                 cli_utilities_1.log.info(`Label '${name}' already exists`, this.importConfig.context);
             }
             else {
                 this.failedLabel.push(apiData);
+                (_c = this.progressManager) === null || _c === void 0 ? void 0 : _c.tick(false, `label: ${name || uid}`, (error === null || error === void 0 ? void 0 : error.message) || 'Failed to import label', utils_1.PROCESS_NAMES.LABELS_CREATE);
                 (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.importConfig.context), { name }), `Label '${name}' failed to be import`);
             }
         };
+        cli_utilities_1.log.debug(`Using concurrency limit: ${this.importConfig.fetchConcurrency || 1}`, this.importConfig.context);
         await this.makeConcurrentCall({
             apiContent,
             processName: 'create labels',
@@ -111,6 +107,7 @@ class ImportLabels extends base_class_1.default {
             },
             concurrencyLimit: this.importConfig.fetchConcurrency || 1,
         }, undefined, false);
+        cli_utilities_1.log.debug('Labels creation process completed', this.importConfig.context);
     }
     /**
      * @method serializeLabels
@@ -118,17 +115,18 @@ class ImportLabels extends base_class_1.default {
      * @returns {ApiOptions} ApiOptions
      */
     serializeLabels(apiOptions) {
-        var _a;
+        var _a, _b;
         const { apiData: label } = apiOptions;
         cli_utilities_1.log.debug(`Serializing label: ${label.name} (${label.uid})`, this.importConfig.context);
         if (this.labelUidMapper.hasOwnProperty(label.uid)) {
             cli_utilities_1.log.info(`Label '${label.name}' already exists. Skipping it to avoid duplicates!`, this.importConfig.context);
             cli_utilities_1.log.debug(`Skipping label serialization for: ${label.uid}`, this.importConfig.context);
+            (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `label: ${label.name} (skipped - already exists)`, null, utils_1.PROCESS_NAMES.LABELS_CREATE);
             apiOptions.entity = undefined;
         }
         else {
             let labelReq = label;
-            if (((_a = label === null || label === void 0 ? void 0 : label.parent) === null || _a === void 0 ? void 0 : _a.length) != 0) {
+            if (((_b = label === null || label === void 0 ? void 0 : label.parent) === null || _b === void 0 ? void 0 : _b.length) != 0) {
                 cli_utilities_1.log.debug(`Label '${label.name}' has parent labels, removing parent for initial creation`, this.importConfig.context);
                 labelReq = (0, omit_1.default)(label, ['parent']);
             }
@@ -142,13 +140,18 @@ class ImportLabels extends base_class_1.default {
             const apiContent = (0, values_1.default)(this.labels);
             cli_utilities_1.log.debug(`Updating ${apiContent.length} labels`, this.importConfig.context);
             const onSuccess = ({ response, apiData: { uid, name } = { uid: null, name: '' } }) => {
+                var _a;
                 this.createdLabel.push(response);
+                (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `label: ${name || uid}`, null, utils_1.PROCESS_NAMES.LABELS_UPDATE);
                 cli_utilities_1.log.success(`Label '${name}' updated successfully`, this.importConfig.context);
                 cli_utilities_1.log.debug(`Label update completed: ${name} (${uid})`, this.importConfig.context);
             };
             const onReject = ({ error, apiData }) => {
-                cli_utilities_1.log.debug(`Label '${apiData === null || apiData === void 0 ? void 0 : apiData.name}' update failed`, this.importConfig.context);
-                (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.importConfig.context), { name: apiData === null || apiData === void 0 ? void 0 : apiData.name }), `Failed to update label '${apiData === null || apiData === void 0 ? void 0 : apiData.name}'`);
+                var _a;
+                const { name, uid } = apiData;
+                (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(false, `label: ${name || uid}`, (error === null || error === void 0 ? void 0 : error.message) || 'Failed to update label', utils_1.PROCESS_NAMES.LABELS_UPDATE);
+                cli_utilities_1.log.debug(`Label '${name}' update failed`, this.importConfig.context);
+                (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.importConfig.context), { name: name }), `Failed to update label '${name}'`);
             };
             cli_utilities_1.log.debug(`Using concurrency limit for updates: ${this.importConfig.fetchConcurrency || 1}`, this.importConfig.context);
             await this.makeConcurrentCall({
@@ -175,7 +178,7 @@ class ImportLabels extends base_class_1.default {
      * @returns {ApiOptions} ApiOptions
      */
     serializeUpdateLabels(apiOptions) {
-        var _a, _b;
+        var _a, _b, _c, _d;
         const { apiData: label } = apiOptions;
         const labelUid = label.uid;
         cli_utilities_1.log.debug(`Serializing label update: ${label.name} (${labelUid})`, this.importConfig.context);
@@ -198,15 +201,62 @@ class ImportLabels extends base_class_1.default {
             }
             else {
                 cli_utilities_1.log.debug(`Label '${label.name}' has no parent labels, adding to created list`, this.importConfig.context);
+                (_c = this.progressManager) === null || _c === void 0 ? void 0 : _c.tick(true, `label: ${label.name} (no parent update needed)`, null, utils_1.PROCESS_NAMES.LABELS_UPDATE);
                 apiOptions.entity = undefined;
                 this.createdLabel.push(newLabel);
             }
         }
         else {
             cli_utilities_1.log.debug(`Label '${label.name}' not found in UID mapper, skipping update`, this.importConfig.context);
+            (_d = this.progressManager) === null || _d === void 0 ? void 0 : _d.tick(true, `label: ${label.name} (skipped - not found)`, null, utils_1.PROCESS_NAMES.LABELS_UPDATE);
             apiOptions.entity = undefined;
         }
         return apiOptions;
     }
+    async analyzeLabels() {
+        return this.withLoadingSpinner('LABELS: Analyzing import data...', async () => {
+            cli_utilities_1.log.debug('Checking for labels folder existence', this.importConfig.context);
+            if (!utils_1.fileHelper.fileExistsSync(this.labelsFolderPath)) {
+                cli_utilities_1.log.info(`No labels found - '${this.labelsFolderPath}'`, this.importConfig.context);
+                return [0];
+            }
+            cli_utilities_1.log.debug(`Found labels folder: ${this.labelsFolderPath}`, this.importConfig.context);
+            this.labels = utils_1.fsUtil.readFile((0, node_path_1.join)(this.labelsFolderPath, 'labels.json'), true);
+            if (!this.labels) {
+                cli_utilities_1.log.info(`No labels found in file - '${(0, node_path_1.join)(this.labelsFolderPath, 'labels.json')}'`, this.importConfig.context);
+                return [0];
+            }
+            const count = Object.keys(this.labels || {}).length;
+            cli_utilities_1.log.debug(`Loaded ${count} label items from file`, this.importConfig.context);
+            return [count];
+        });
+    }
+    async prepareLabelMapper() {
+        cli_utilities_1.log.debug('Creating labels mapper directory', this.importConfig.context);
+        await utils_1.fsUtil.makeDirectory(this.mapperDirPath);
+        cli_utilities_1.log.debug('Loading existing label UID mappings', this.importConfig.context);
+        this.labelUidMapper = utils_1.fileHelper.fileExistsSync(this.labelUidMapperPath)
+            ? utils_1.fsUtil.readFile((0, node_path_1.join)(this.labelUidMapperPath), true) || {}
+            : {};
+        const count = Object.keys(this.labelUidMapper || {}).length;
+        if (count > 0) {
+            cli_utilities_1.log.debug(`Loaded existing label UID data: ${count} items`, this.importConfig.context);
+        }
+        else {
+            cli_utilities_1.log.debug('No existing label UID mappings found', this.importConfig.context);
+        }
+    }
+    processLabelResults() {
+        var _a, _b;
+        cli_utilities_1.log.debug('Processing labels import results', this.importConfig.context);
+        if ((_a = this.createdLabel) === null || _a === void 0 ? void 0 : _a.length) {
+            utils_1.fsUtil.writeFile(this.createdLabelPath, this.createdLabel);
+            cli_utilities_1.log.debug(`Written ${this.createdLabel.length} successful labels to file`, this.importConfig.context);
+        }
+        if ((_b = this.failedLabel) === null || _b === void 0 ? void 0 : _b.length) {
+            utils_1.fsUtil.writeFile(this.labelFailsPath, this.failedLabel);
+            cli_utilities_1.log.debug(`Written ${this.failedLabel.length} failed labels to file`, this.importConfig.context);
+        }
+    }
 }
 exports.default = ImportLabels;

package/lib/import/modules/locales.d.ts

@@ -3,8 +3,8 @@
  * Copyright (c) 2024 Contentstack LLC
  * MIT Licensed
  */
-import { ModuleClassParams } from '../../types';
 import BaseClass from './base-class';
+import { ModuleClassParams } from '../../types';
 export default class ImportLocales extends BaseClass {
     private langMapperPath;
     private langFolderPath;
@@ -24,8 +24,19 @@ export default class ImportLocales extends BaseClass {
     private masterLanguageConfig;
     private sourceMasterLanguage;
     constructor({ importConfig, stackAPIClient }: ModuleClassParams);
-    start(): Promise<any>;
-    checkAndUpdateMasterLocale(): Promise<any>;
+    start(): Promise<void>;
+    checkAndUpdateMasterLocale(): Promise<void>;
     createLocales(): Promise<any>;
-    updateLocales(): Promise<unknown>;
+    updateLocales(): Promise<any>;
+    private analyzeLocales;
+    private setupLocalesProgress;
+    private prepareLocalesMapper;
+    private processMasterLocale;
+    private processLocaleCreation;
+    private processLocaleUpdate;
+    private getSourceMasterLangDetails;
+    private fetchTargetMasterLocale;
+    private logCodeMismatch;
+    private handleNameMismatch;
+    private tickProgress;
 }