@contentstack/cli-cm-import 2.0.0-beta.1 → 2.0.0-beta.10

package/lib/import/modules/entries.js

@@ -4,13 +4,14 @@ const tslib_1 = require("tslib");
 /* eslint-disable no-prototype-builtins */
 /*!
  * Contentstack Import
- * Copyright (c) 2024 Contentstack LLC
+ * Copyright (c) 2026 Contentstack LLC
  * MIT Licensed
  */
 const path = tslib_1.__importStar(require("path"));
 const fs_1 = require("fs");
 const lodash_1 = require("lodash");
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 class EntriesImport extends base_class_1.default {
@@ -19,19 +20,28 @@ class EntriesImport extends base_class_1.default {
         this.entriesForVariant = [];
         this.importConfig.context.module = utils_1.MODULE_CONTEXTS.ENTRIES;
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.ENTRIES];
-        this.assetUidMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.data), 'mapper', 'assets', 'uid-mapping.json');
-        this.assetUrlMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.data), 'mapper', 'assets', 'url-mapping.json');
-        this.entriesMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.data), 'mapper', 'entries');
-        this.envPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.data), 'environments', 'environments.json');
-        this.entriesUIDMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesMapperPath), 'uid-mapping.json');
-        this.uniqueUidMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesMapperPath), 'unique-mapping.json');
-        this.modifiedCTsPath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesMapperPath), 'modified-schemas.json');
-        this.marketplaceAppMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.importConfig.data), 'mapper', 'marketplace_apps', 'uid-mapping.json');
-        this.taxonomiesPath = path.join((0, cli_utilities_1.sanitizePath)(this.importConfig.data), 'mapper', 'taxonomies', 'terms', 'success.json');
+        this.assetUidMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.ASSETS, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.assetUrlMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.ASSETS, constants_1.PATH_CONSTANTS.FILES.URL_MAPPING);
+        this.entriesMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.ENTRIES);
+        this.envPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.contentDir), constants_1.PATH_CONSTANTS.CONTENT_DIRS.ENVIRONMENTS, constants_1.PATH_CONSTANTS.FILES.ENVIRONMENTS);
+        this.entriesUIDMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesMapperPath), constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.uniqueUidMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesMapperPath), constants_1.PATH_CONSTANTS.FILES.UNIQUE_MAPPING);
+        this.modifiedCTsPath = path.join((0, cli_utilities_1.sanitizePath)(this.entriesMapperPath), constants_1.PATH_CONSTANTS.FILES.MODIFIED_SCHEMAS);
+        this.marketplaceAppMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.importConfig.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.MARKETPLACE_APPS, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.taxonomiesPath = path.join((0, cli_utilities_1.sanitizePath)(this.importConfig.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.TAXONOMIES, constants_1.PATH_CONSTANTS.MAPPER_MODULES.TAXONOMY_TERMS, constants_1.PATH_CONSTANTS.FILES.SUCCESS);
         this.entriesConfig = importConfig.modules.entries;
-        this.entriesPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.data), (0, cli_utilities_1.sanitizePath)(this.entriesConfig.dirName));
-        this.cTsPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.data), (0, cli_utilities_1.sanitizePath)(importConfig.modules['content-types'].dirName));
-        this.localesPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.data), (0, cli_utilities_1.sanitizePath)(importConfig.modules.locales.dirName), (0, cli_utilities_1.sanitizePath)(importConfig.modules.locales.fileName));
+        this.entriesPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.contentDir), (0, cli_utilities_1.sanitizePath)(this.entriesConfig.dirName));
+        this.cTsPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.contentDir), (0, cli_utilities_1.sanitizePath)(importConfig.modules['content-types'].dirName));
+        this.localesPath = path.resolve((0, cli_utilities_1.sanitizePath)(importConfig.contentDir), (0, cli_utilities_1.sanitizePath)(importConfig.modules.locales.dirName), (0, cli_utilities_1.sanitizePath)(importConfig.modules.locales.fileName));
+        // Initialize composable studio paths if config exists
+        if (this.importConfig.modules['composable-studio']) {
+            this.composableStudioSuccessPath = path.join((0, cli_utilities_1.sanitizePath)(importConfig.backupDir), constants_1.PATH_CONSTANTS.MAPPER, this.importConfig.modules['composable-studio'].dirName, this.importConfig.modules['composable-studio'].fileName);
+            this.composableStudioExportPath = path.join((0, cli_utilities_1.sanitizePath)(importConfig.backupDir), this.importConfig.modules['composable-studio'].dirName, this.importConfig.modules['composable-studio'].fileName);
+        }
+        else {
+            this.composableStudioSuccessPath = '';
+            this.composableStudioExportPath = '';
+        }
         this.importConcurrency = this.entriesConfig.importConcurrency || importConfig.importConcurrency;
         this.entriesUidMapper = {};
         this.modifiedCTs = [];
@@ -112,8 +122,7 @@ class EntriesImport extends base_class_1.default {
                 .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.CLEANUP].CLEANING, utils_1.PROCESS_NAMES.CLEANUP);
             await this.processCleanup();
             progress.completeProcess(utils_1.PROCESS_NAMES.CLEANUP, true);
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Entries imported successfully', this.importConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.createEntryDataForVariantEntry();
@@ -124,7 +133,7 @@ class EntriesImport extends base_class_1.default {
     async analyzeEntryData() {
         return this.withLoadingSpinner('ENTRIES: Analyzing import data...', async () => {
             cli_utilities_1.log.debug('Loading content types for entry analysis', this.importConfig.context);
-            this.cTs = utils_1.fsUtil.readFile(path.join(this.cTsPath, 'schema.json'));
+            this.cTs = (0, cli_utilities_1.readContentTypeSchemas)(this.cTsPath);
             if (!this.cTs || (0, lodash_1.isEmpty)(this.cTs)) {
                 return [0, 0, 0, 0, 0];
             }
@@ -148,7 +157,7 @@ class EntriesImport extends base_class_1.default {
             for (let locale of this.locales) {
                 for (let contentType of this.cTs) {
                     const basePath = path.join(this.entriesPath, contentType.uid, locale.code);
-                    const fs = new cli_utilities_1.FsUtility({ basePath, indexFileName: 'index.json' });
+                    const fs = new cli_utilities_1.FsUtility({ basePath, indexFileName: constants_1.PATH_CONSTANTS.FILES.INDEX });
                     const indexer = fs.indexFileContent;
                     const chunksInThisCTLocale = (0, lodash_1.values)(indexer).length;
                     totalEntryChunks += chunksInThisCTLocale;
@@ -200,7 +209,7 @@ class EntriesImport extends base_class_1.default {
             await this.createEntries(entryRequestOption);
         }
         cli_utilities_1.log.debug('Writing entry UID mappings to file', this.importConfig.context);
-        await utils_1.fileHelper.writeLargeFile(path.join(this.entriesMapperPath, 'uid-mapping.json'), this.entriesUidMapper);
+        await utils_1.fileHelper.writeLargeFile(path.join(this.entriesMapperPath, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING), this.entriesUidMapper);
         utils_1.fsUtil.writeFile(path.join(this.entriesMapperPath, 'failed-entries.json'), this.failedEntries);
     }
     async processEntryReplacement() {
@@ -357,7 +366,7 @@ class EntriesImport extends base_class_1.default {
     async createEntries({ cTUid, locale }) {
         var _a, _b;
         const processName = 'Create Entries';
-        const indexFileName = 'index.json';
+        const indexFileName = constants_1.PATH_CONSTANTS.FILES.INDEX;
         const basePath = path.join(this.entriesPath, cTUid, locale);
         const fs = new cli_utilities_1.FsUtility({ basePath, indexFileName });
         const indexer = fs.indexFileContent;
@@ -373,7 +382,7 @@ class EntriesImport extends base_class_1.default {
         // Write created entries
         const entriesCreateFileHelper = new cli_utilities_1.FsUtility({
             moduleName: 'entries',
-            indexFileName: 'index.json',
+            indexFileName: constants_1.PATH_CONSTANTS.FILES.INDEX,
             basePath: path.join(this.entriesMapperPath, cTUid, locale),
             chunkFileSize: this.entriesConfig.chunkFileSize,
             keepMetadata: false,
@@ -382,7 +391,7 @@ class EntriesImport extends base_class_1.default {
         // create file instance for existing entries
         const existingEntriesFileHelper = new cli_utilities_1.FsUtility({
             moduleName: 'entries',
-            indexFileName: 'index.json',
+            indexFileName: constants_1.PATH_CONSTANTS.FILES.INDEX,
             basePath: path.join(this.entriesMapperPath, cTUid, locale, 'existing'),
             chunkFileSize: this.entriesConfig.chunkFileSize,
             keepMetadata: false,
@@ -534,7 +543,7 @@ class EntriesImport extends base_class_1.default {
     }
     async replaceEntries({ cTUid, locale }) {
         const processName = 'Replace existing Entries';
-        const indexFileName = 'index.json';
+        const indexFileName = constants_1.PATH_CONSTANTS.FILES.INDEX;
         const basePath = path.join(this.entriesMapperPath, cTUid, locale, 'existing');
         const fs = new cli_utilities_1.FsUtility({ basePath, indexFileName });
         const indexer = fs.indexFileContent;
@@ -547,7 +556,7 @@ class EntriesImport extends base_class_1.default {
         // Write updated entries
         const entriesReplaceFileHelper = new cli_utilities_1.FsUtility({
             moduleName: 'entries',
-            indexFileName: 'index.json',
+            indexFileName: constants_1.PATH_CONSTANTS.FILES.INDEX,
             basePath: path.join(this.entriesMapperPath, cTUid, locale),
             chunkFileSize: this.entriesConfig.chunkFileSize,
             keepMetadata: false,
@@ -662,7 +671,7 @@ class EntriesImport extends base_class_1.default {
     }
     async updateEntriesWithReferences({ cTUid, locale }) {
         const processName = 'Update Entries';
-        const indexFileName = 'index.json';
+        const indexFileName = constants_1.PATH_CONSTANTS.FILES.INDEX;
         const basePath = path.join(this.entriesMapperPath, cTUid, locale);
         const fs = new cli_utilities_1.FsUtility({ basePath, indexFileName });
         const indexer = fs.indexFileContent;
@@ -842,10 +851,15 @@ class EntriesImport extends base_class_1.default {
         }
         cli_utilities_1.log.debug(`Found ${cTsWithFieldRules.length} content types with field rules to update`, this.importConfig.context);
         try {
+            // Read content types from individual files
+            const cTs = (0, cli_utilities_1.readContentTypeSchemas)(this.cTsPath) || [];
             for (let cTUid of cTsWithFieldRules) {
                 cli_utilities_1.log.debug(`Processing field rules for content type: ${cTUid}`, this.importConfig.context);
-                const cTs = utils_1.fsUtil.readFile(path.join(this.cTsPath, 'schema.json'));
                 const contentType = (0, lodash_1.find)(cTs, { uid: cTUid });
+                if (!contentType) {
+                    cli_utilities_1.log.debug(`Content type ${cTUid} not found in schemas`, this.importConfig.context);
+                    continue;
+                }
                 if (contentType.field_rules) {
                     cli_utilities_1.log.debug(`Found ${contentType.field_rules.length} field rules for content type: ${cTUid}`, this.importConfig.context);
                     const fieldDatatypeMap = {};
@@ -907,7 +921,7 @@ class EntriesImport extends base_class_1.default {
     }
     async publishEntries({ cTUid, locale }) {
         const processName = 'Publish Entries';
-        const indexFileName = 'index.json';
+        const indexFileName = constants_1.PATH_CONSTANTS.FILES.INDEX;
         const basePath = path.join(this.entriesPath, cTUid, locale);
         const fs = new cli_utilities_1.FsUtility({ basePath, indexFileName });
         const indexer = fs.indexFileContent;
@@ -935,16 +949,7 @@ class EntriesImport extends base_class_1.default {
                 (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.importConfig.context), { cTUid, locale }));
             });
             if (chunk) {
-                let apiContent = (0, lodash_1.values)(chunk);
-                let apiContentDuplicate = [];
-                apiContentDuplicate = apiContent.flatMap((content) => {
-                    var _a;
-                    if (((_a = content === null || content === void 0 ? void 0 : content.publish_details) === null || _a === void 0 ? void 0 : _a.length) > 0) {
-                        return content.publish_details.map((publish) => (Object.assign(Object.assign({}, content), { locale: publish.locale, publish_details: [publish] })));
-                    }
-                    return []; // Return an empty array if publish_details is empty
-                });
-                apiContent = apiContentDuplicate;
+                const apiContent = (0, lodash_1.values)(chunk).filter((content) => { var _a; return ((_a = content === null || content === void 0 ? void 0 : content.publish_details) === null || _a === void 0 ? void 0 : _a.length) > 0; });
                 cli_utilities_1.log.debug(`Processing ${apiContent.length} publishable entries in chunk ${index}`, this.importConfig.context);
                 if ((apiContent === null || apiContent === void 0 ? void 0 : apiContent.length) === 0) {
                     cli_utilities_1.log.debug(`No publishable entries found in chunk ${index}`, this.importConfig.context);

package/lib/import/modules/environments.js

@@ -5,6 +5,7 @@ const isEmpty_1 = tslib_1.__importDefault(require("lodash/isEmpty"));
 const values_1 = tslib_1.__importDefault(require("lodash/values"));
 const node_path_1 = require("node:path");
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 class ImportEnvironments extends base_class_1.default {
@@ -13,11 +14,11 @@ class ImportEnvironments extends base_class_1.default {
         this.importConfig.context.module = utils_1.MODULE_CONTEXTS.ENVIRONMENTS;
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.ENVIRONMENTS];
         this.environmentsConfig = importConfig.modules.environments;
-        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, 'mapper', 'environments');
+        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.ENVIRONMENTS);
         this.environmentsFolderPath = (0, node_path_1.join)(this.importConfig.backupDir, this.environmentsConfig.dirName);
-        this.envUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, 'uid-mapping.json');
-        this.envSuccessPath = (0, node_path_1.join)(this.mapperDirPath, 'success.json');
-        this.envFailsPath = (0, node_path_1.join)(this.mapperDirPath, 'fails.json');
+        this.envUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.envSuccessPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.SUCCESS);
+        this.envFailsPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.FAILS);
         this.envFailed = [];
         this.envSuccess = [];
         this.envUidMapper = {};
@@ -39,8 +40,7 @@ class ImportEnvironments extends base_class_1.default {
             progress.updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.ENVIRONMENTS_IMPORT].IMPORTING);
             await this.importEnvironments();
             await this.processImportResults();
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Environments have been imported successfully!', this.importConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Environments import failed');

package/lib/import/modules/extensions.js

@@ -6,6 +6,7 @@ const values_1 = tslib_1.__importDefault(require("lodash/values"));
 const cloneDeep_1 = tslib_1.__importDefault(require("lodash/cloneDeep"));
 const node_path_1 = require("node:path");
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 class ImportExtensions extends base_class_1.default {
@@ -14,12 +15,12 @@ class ImportExtensions extends base_class_1.default {
         this.importConfig.context.module = utils_1.MODULE_CONTEXTS.EXTENSIONS;
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.EXTENSIONS];
         this.extensionsConfig = importConfig.modules.extensions;
-        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, 'mapper', 'extensions');
+        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.EXTENSIONS);
         this.extensionsFolderPath = (0, node_path_1.join)(this.importConfig.backupDir, this.extensionsConfig.dirName);
-        this.extUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, 'uid-mapping.json');
-        this.extSuccessPath = (0, node_path_1.join)(this.mapperDirPath, 'success.json');
-        this.extFailsPath = (0, node_path_1.join)(this.mapperDirPath, 'fails.json');
-        this.extPendingPath = (0, node_path_1.join)(this.mapperDirPath, 'pending_extensions.js');
+        this.extUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.extSuccessPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.SUCCESS);
+        this.extFailsPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.FAILS);
+        this.extPendingPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.PENDING_EXTENSIONS);
         this.extFailed = [];
         this.extSuccess = [];
         this.existingExtensions = [];
@@ -60,8 +61,7 @@ class ImportExtensions extends base_class_1.default {
                 progress.completeProcess(utils_1.PROCESS_NAMES.EXTENSIONS_REPLACE_EXISTING, true);
             }
             await this.processExtensionResults();
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Extensions have been imported successfully!', this.importConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Create failed');

package/lib/import/modules/global-fields.d.ts

@@ -1,6 +1,6 @@
 /*!
  * Contentstack Import
- * Copyright (c) 2024 Contentstack LLC
+ * Copyright (c) 2026 Contentstack LLC
  * MIT Licensed
  */
 import { ModuleClassParams } from '../../types';

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

@@ -2,7 +2,7 @@
 /* eslint-disable no-prototype-builtins */
 /*!
  * Contentstack Import
- * Copyright (c) 2024 Contentstack LLC
+ * Copyright (c) 2026 Contentstack LLC
  * MIT Licensed
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -10,6 +10,7 @@ const tslib_1 = require("tslib");
 const path = tslib_1.__importStar(require("path"));
 const lodash_1 = require("lodash");
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 const global_field_helper_1 = require("../../utils/global-field-helper");
@@ -27,13 +28,13 @@ class ImportGlobalFields extends base_class_1.default {
         this.pendingGFs = [];
         this.existingGFs = [];
         this.reqConcurrency = this.gFsConfig.writeConcurrency || this.config.writeConcurrency;
-        this.gFsMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'global_fields');
-        this.gFsFolderPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), (0, cli_utilities_1.sanitizePath)(this.gFsConfig.dirName));
-        this.gFsFailsPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'global_fields', 'fails.json');
-        this.gFsSuccessPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'global_fields', 'success.json');
-        this.gFsUidMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'global_fields', 'uid-mapping.json');
-        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');
+        this.gFsMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.GLOBAL_FIELDS);
+        this.gFsFolderPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.contentDir), (0, cli_utilities_1.sanitizePath)(this.gFsConfig.dirName));
+        this.gFsFailsPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.GLOBAL_FIELDS, constants_1.PATH_CONSTANTS.FILES.FAILS);
+        this.gFsSuccessPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.GLOBAL_FIELDS, constants_1.PATH_CONSTANTS.FILES.SUCCESS);
+        this.gFsUidMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.GLOBAL_FIELDS, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.gFsPendingPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.GLOBAL_FIELDS, constants_1.PATH_CONSTANTS.FILES.PENDING_GLOBAL_FIELDS);
+        this.marketplaceAppMapperPath = path.join((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.MARKETPLACE_APPS, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
     }
     /**
      * @method start
@@ -76,8 +77,7 @@ class ImportGlobalFields extends base_class_1.default {
                 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);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Global fields import failed');

package/lib/import/modules/labels.js

@@ -6,6 +6,7 @@ const node_path_1 = require("node:path");
 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 constants_1 = require("../../constants");
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
 class ImportLabels extends base_class_1.default {
@@ -14,11 +15,11 @@ class ImportLabels extends base_class_1.default {
         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.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.LABELS);
         this.labelsFolderPath = (0, node_path_1.join)(this.importConfig.backupDir, this.labelsConfig.dirName);
-        this.labelUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, 'uid-mapping.json');
-        this.createdLabelPath = (0, node_path_1.join)(this.mapperDirPath, 'success.json');
-        this.labelFailsPath = (0, node_path_1.join)(this.mapperDirPath, 'fails.json');
+        this.labelUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.createdLabelPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.SUCCESS);
+        this.labelFailsPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.FAILS);
         this.labels = {};
         this.failedLabel = [];
         this.createdLabel = [];
@@ -55,8 +56,7 @@ class ImportLabels extends base_class_1.default {
             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);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Labels import failed');

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

@@ -1,6 +1,6 @@
 /*!
  * Contentstack Import
- * Copyright (c) 2024 Contentstack LLC
+ * Copyright (c) 2026 Contentstack LLC
  * MIT Licensed
  */
 import BaseClass from './base-class';

package/lib/import/modules/locales.js

@@ -2,7 +2,7 @@
 /* eslint-disable no-prototype-builtins */
 /*!
  * Contentstack Import
- * Copyright (c) 2024 Contentstack LLC
+ * Copyright (c) 2026 Contentstack LLC
  * MIT Licensed
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -10,6 +10,7 @@ const tslib_1 = require("tslib");
 const path = tslib_1.__importStar(require("path"));
 const lodash_1 = require("lodash");
 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 ImportLocales extends base_class_1.default {
@@ -27,11 +28,11 @@ class ImportLocales extends base_class_1.default {
         this.createdLocales = [];
         this.failedLocales = [];
         this.reqConcurrency = this.localeConfig.writeConcurrency || this.config.writeConcurrency;
-        this.langMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'languages');
-        this.langFolderPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), (0, cli_utilities_1.sanitizePath)(this.localeConfig.dirName));
-        this.langFailsPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'languages', 'fails.json');
-        this.langSuccessPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'languages', 'success.json');
-        this.langUidMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.data), 'mapper', 'languages', 'uid-mapper.json');
+        this.langMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.LANGUAGES);
+        this.langFolderPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.contentDir), (0, cli_utilities_1.sanitizePath)(this.localeConfig.dirName));
+        this.langFailsPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.LANGUAGES, constants_1.PATH_CONSTANTS.FILES.FAILS);
+        this.langSuccessPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.LANGUAGES, constants_1.PATH_CONSTANTS.FILES.SUCCESS);
+        this.langUidMapperPath = path.resolve((0, cli_utilities_1.sanitizePath)(this.config.backupDir), constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.LANGUAGES, constants_1.PATH_CONSTANTS.FILES.UID_MAPPER);
     }
     async start() {
         try {
@@ -49,8 +50,7 @@ class ImportLocales extends base_class_1.default {
             cli_utilities_1.log.debug('Writing failed locales to file', this.config.context);
             utils_1.fsUtil.writeFile(this.langFailsPath, this.failedLocales);
             cli_utilities_1.log.debug(`Written ${this.failedLocales.length} failed locales to file`, this.config.context);
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Languages have been imported successfully!', this.config.context);
+            this.completeProgressWithMessage({ context: this.config.context });
         }
         catch (error) {
             this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Locales import failed');

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

@@ -13,6 +13,7 @@ const filter_1 = tslib_1.__importDefault(require("lodash/filter"));
 const isEmpty_1 = tslib_1.__importDefault(require("lodash/isEmpty"));
 const toLower_1 = tslib_1.__importDefault(require("lodash/toLower"));
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const interactive_1 = require("../../utils/interactive");
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
@@ -22,9 +23,9 @@ class ImportMarketplaceApps extends base_class_1.default {
         this.importConfig.context.module = utils_1.MODULE_CONTEXTS.MARKETPLACE_APPS;
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.MARKETPLACE_APPS];
         this.marketPlaceAppConfig = importConfig.modules.marketplace_apps;
-        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, 'mapper', 'marketplace_apps');
+        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.MARKETPLACE_APPS);
         this.marketPlaceFolderPath = (0, node_path_1.join)(this.importConfig.backupDir, this.marketPlaceAppConfig.dirName);
-        this.marketPlaceUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, 'uid-mapping.json');
+        this.marketPlaceUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
         this.appNameMapping = {};
         this.appUidMapping = {};
         this.appOriginalName = undefined;
@@ -85,8 +86,7 @@ class ImportMarketplaceApps extends base_class_1.default {
                 .updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.INSTALL_APPS].INSTALLING, utils_1.PROCESS_NAMES.INSTALL_APPS);
             await this.importMarketplaceApps();
             progress.completeProcess(utils_1.PROCESS_NAMES.INSTALL_APPS, true);
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Marketplace apps have been imported successfully!', this.importConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Marketplace apps import failed');
@@ -347,11 +347,11 @@ class ImportMarketplaceApps extends base_class_1.default {
      */
     async installApp(config, appManifestUid) {
         cli_utilities_1.log.debug(`Installing app with manifest UID: ${appManifestUid}`, this.importConfig.context);
-        cli_utilities_1.log.debug(`Target stack: ${config.target_stack}`, this.importConfig.context);
+        cli_utilities_1.log.debug(`Target stack: ${config.apiKey}`, this.importConfig.context);
         return await this.appSdk
             .marketplace(this.importConfig.org_uid)
             .app(appManifestUid)
-            .install({ targetUid: config.target_stack, targetType: 'stack' })
+            .install({ targetUid: config.apiKey, targetType: 'stack' })
             .then((response) => {
             cli_utilities_1.log.debug(`App installation successful: ${appManifestUid}`, this.importConfig.context);
             return response;

package/lib/import/modules/personalize.js

@@ -46,8 +46,7 @@ class ImportPersonalize extends base_class_1.default {
             else {
                 cli_utilities_1.log.debug('No personalize modules configured for processing', this.config.context);
             }
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Personalize import completed successfully', this.config.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.personalizeConfig.importData = false; // Stop personalize import if project creation fails
@@ -145,7 +144,7 @@ class ImportPersonalize extends base_class_1.default {
             }
             const personalize = this.config.modules.personalize;
             const { dirName, fileName } = personalize.projects;
-            const projectPath = (0, path_1.join)((0, cli_utilities_1.sanitizePath)(this.config.data), (0, cli_utilities_1.sanitizePath)(personalize.dirName), (0, cli_utilities_1.sanitizePath)(dirName), (0, cli_utilities_1.sanitizePath)(fileName));
+            const projectPath = (0, path_1.join)((0, cli_utilities_1.sanitizePath)(this.config.contentDir), (0, cli_utilities_1.sanitizePath)(personalize.dirName), (0, cli_utilities_1.sanitizePath)(dirName), (0, cli_utilities_1.sanitizePath)(fileName));
             cli_utilities_1.log.debug(`Checking for project file: ${projectPath}`, this.config.context);
             if (!(0, fs_1.existsSync)(projectPath)) {
                 this.config.modules.personalize.importData = false;

package/lib/import/modules/stack.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 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 ImportStack extends base_class_1.default {
@@ -12,8 +13,8 @@ class ImportStack extends base_class_1.default {
         this.envUidMapper = {};
         this.importConfig.context.module = utils_1.MODULE_CONTEXTS.STACK;
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.STACK];
-        this.stackSettingsPath = (0, node_path_1.join)(this.importConfig.backupDir, 'stack', 'settings.json');
-        this.envUidMapperPath = (0, node_path_1.join)(this.importConfig.backupDir, 'mapper', 'environments', 'uid-mapping.json');
+        this.stackSettingsPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.CONTENT_DIRS.STACK, constants_1.PATH_CONSTANTS.FILES.SETTINGS);
+        this.envUidMapperPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.ENVIRONMENTS, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
     }
     /**
      * @method start
@@ -35,8 +36,7 @@ class ImportStack extends base_class_1.default {
             progress.updateStatus(utils_1.PROCESS_STATUS[utils_1.PROCESS_NAMES.STACK_IMPORT].IMPORTING);
             cli_utilities_1.log.info('Starting stack settings import process', this.importConfig.context);
             await this.importStackSettings();
-            this.completeProgress(true);
-            cli_utilities_1.log.success('Stack settings imported successfully!', this.importConfig.context);
+            this.completeProgressWithMessage();
         }
         catch (error) {
             this.completeProgress(false, 'Stack settings import failed');
@@ -47,7 +47,7 @@ class ImportStack extends base_class_1.default {
         var _a, _b, _c;
         cli_utilities_1.log.debug('Processing stack settings for import', this.importConfig.context);
         // Update environment UID mapping if live preview is configured
-        if (((_a = this.stackSettings) === null || _a === void 0 ? void 0 : _a.live_preview) && ((_b = this.stackSettings) === null || _b === void 0 ? void 0 : _b.live_preview['default-env'])) {
+        if (((_a = this.stackSettings) === null || _a === void 0 ? void 0 : _a.live_preview) && ((_b = this.stackSettings) === null || _b === void 0 ? void 0 : _b.live_preview['default-env']) !== undefined) {
             const oldEnvUid = this.stackSettings.live_preview['default-env'];
             const mappedEnvUid = this.envUidMapper[oldEnvUid];
             if (mappedEnvUid) {

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

@@ -10,6 +10,8 @@ export default class ImportTaxonomies extends BaseClass {
     private termsMapperDirPath;
     private termsSuccessPath;
     private termsFailsPath;
+    private localesFilePath;
+    private isLocaleBasedStructure;
     createdTaxonomies: Record<string, unknown>;
     failedTaxonomies: Record<string, unknown>;
     createdTerms: Record<string, Record<string, unknown>>;
@@ -26,13 +28,34 @@ export default class ImportTaxonomies extends BaseClass {
      * @async
      * @returns {Promise<any>} Promise<any>
      */
-    importTaxonomies(): Promise<any>;
+    importTaxonomies({ apiContent, localeCode }: {
+        apiContent: any[];
+        localeCode?: string;
+    }): Promise<void>;
     /**
-     * @method serializeTaxonomiesData
+     * Import taxonomies using legacy structure (taxonomies/{uid}.json)
+     */
+    importTaxonomiesLegacy(): Promise<void>;
+    /**
+     * Import taxonomies using locale-based structure (taxonomies/{locale}/{uid}.json)
+     */
+    importTaxonomiesByLocale(): Promise<void>;
+    handleSuccess(apiData: any, locale?: string): void;
+    handleFailure(error: any, apiData: any, locale?: string): void;
+    /**
+     * @method serializeTaxonomy
      * @param {ApiOptions} apiOptions ApiOptions
      * @returns {ApiOptions} ApiOptions
      */
-    serializeTaxonomiesData(apiOptions: ApiOptions): ApiOptions;
+    serializeTaxonomy(apiOptions: ApiOptions): ApiOptions;
+    loadTaxonomyFile(filePath: string): Record<string, unknown> | undefined;
+    findTaxonomyFilePath(taxonomyUID: string): string | undefined;
+    findTaxonomyInLocaleFolders(taxonomyUID: string): string | undefined;
+    loadAvailableLocales(): Record<string, string>;
+    /**
+     * Detect if locale-based folder structure exists (taxonomies/{locale}/{uid}.json)
+     */
+    detectAndScanLocaleStructure(): boolean;
     /**
      * create taxonomies success and fail in (mapper/taxonomies)
      * create terms success and fail in (mapper/taxonomies/terms)