@contentstack/cli-cm-export 2.0.0-beta.1 → 2.0.0-beta.3

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

@@ -2,21 +2,45 @@ import BaseClass from './base-class';
 import { ModuleClassParams } from '../../types';
 export default class ExportTaxonomies extends BaseClass {
     private taxonomies;
+    private taxonomiesByLocale;
     private taxonomiesConfig;
+    private isLocaleBasedExportSupported;
     private qs;
     taxonomiesFolderPath: string;
+    private localesFilePath;
     constructor({ exportConfig, stackAPIClient }: ModuleClassParams);
     start(): Promise<void>;
     /**
-     * Fetch in the provided stack
-     * @param {number} skip
-     * @returns {Promise<any>}
+     * Process and export taxonomies for a specific locale
      */
-    getAllTaxonomies(skip?: number): Promise<any>;
-    sanitizeTaxonomiesAttribs(taxonomies: Record<string, any>[]): void;
+    processLocaleExport(localeCode: string): Promise<void>;
     /**
-     * Export all taxonomies details using metadata(this.taxonomies) and write it into respective <taxonomy-uid>.json file
-     * @returns {Promise<any>}
+     * Write taxonomies metadata file
      */
-    exportTaxonomies(): Promise<any>;
+    writeTaxonomiesMetadata(): Promise<void>;
+    /**
+     * Fetch taxonomies
+     *
+     * @async
+     * @param {?string} [localeCode]
+     * @param {boolean} [checkLocaleSupport=false]
+     * @returns {Promise<void>}
+     */
+    fetchTaxonomies(localeCode?: string, checkLocaleSupport?: boolean): Promise<void>;
+    /**
+     * remove invalid keys and write data into taxonomies
+     * @function sanitizeTaxonomiesAttribs
+     * @param {Record<string, string>[]} taxonomies
+     * @param {?string} [localeCode]
+     */
+    sanitizeTaxonomiesAttribs(taxonomies: Record<string, string>[], localeCode?: string): void;
+    /**
+     * Export taxonomies - supports both locale-based and legacy export
+     */
+    exportTaxonomies(localeCode?: string): Promise<void>;
+    /**
+     * Get all locales to export
+     */
+    getLocalesToExport(): string[];
+    private isLocalePlanLimitationError;
 }

package/lib/export/modules/taxonomies.js

@@ -11,170 +11,245 @@ const utils_1 = require("../../utils");
 class ExportTaxonomies extends base_class_1.default {
     constructor({ exportConfig, stackAPIClient }) {
         super({ exportConfig, stackAPIClient });
+        this.isLocaleBasedExportSupported = true; // Flag to track if locale-based export is supported
         this.taxonomies = {};
+        this.taxonomiesByLocale = {};
         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 = utils_1.MODULE_CONTEXTS.TAXONOMIES;
-        this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.TAXONOMIES];
+        this.exportConfig.context.module = 'taxonomies';
+        this.localesFilePath = (0, node_path_1.resolve)((0, cli_utilities_1.sanitizePath)(exportConfig.data), (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;
-        try {
-            cli_utilities_1.log.debug('Starting taxonomies export process...', this.exportConfig.context);
-            // Setup with loading spinner
-            const [totalCount] = await this.withLoadingSpinner('TAXONOMIES: Analyzing taxonomy structure...', async () => {
-                this.taxonomiesFolderPath = (0, node_path_1.resolve)(this.exportConfig.data, this.exportConfig.branchName || '', this.taxonomiesConfig.dirName);
-                await utils_1.fsUtil.makeDirectory(this.taxonomiesFolderPath);
-                // 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];
-            });
-            if (totalCount === 0) {
-                cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('TAXONOMY_NOT_FOUND'), this.exportConfig.context);
-                return;
-            }
-            // Create nested progress manager
-            const progress = this.createNestedProgress(this.currentModuleName);
-            // Add sub-processes
-            progress.addProcess(utils_1.PROCESS_NAMES.FETCH_TAXONOMIES, totalCount);
-            progress.addProcess(utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS, totalCount);
-            // Fetch taxonomies
-            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);
-            await this.getAllTaxonomies();
-            progress.completeProcess(utils_1.PROCESS_NAMES.FETCH_TAXONOMIES, true);
-            const actualTaxonomyCount = (_a = Object.keys(this.taxonomies || {})) === null || _a === void 0 ? void 0 : _a.length;
-            cli_utilities_1.log.debug(`Found ${actualTaxonomyCount} taxonomies to export (API reported ${totalCount})`, this.exportConfig.context);
-            // Update progress for export step if counts differ
-            if (actualTaxonomyCount !== totalCount && actualTaxonomyCount > 0) {
-                // Remove the old process and add with correct count
-                progress.addProcess(utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS, actualTaxonomyCount);
-            }
-            // Export detailed taxonomies
-            if (actualTaxonomyCount > 0) {
-                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);
-                await this.exportTaxonomies();
-                progress.completeProcess(utils_1.PROCESS_NAMES.EXPORT_TAXONOMIES_TERMS, true);
-            }
-            else {
-                cli_utilities_1.log.info('No taxonomies found to export detailed information', this.exportConfig.context);
-            }
-            const taxonomyCount = Object.keys(this.taxonomies || {}).length;
-            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_COMPLETE', taxonomyCount), this.exportConfig.context);
-            this.completeProgress(true);
+        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.data, 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;
         }
-        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');
+        // Test locale-based export support with master locale
+        const masterLocale = (_a = this.exportConfig.master_locale) === null || _a === void 0 ? void 0 : _a.code;
+        await this.fetchTaxonomies(masterLocale, true);
+        if (!this.isLocaleBasedExportSupported) {
+            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);
+            for (const localeCode of localesToExport) {
+                await this.fetchTaxonomies(localeCode);
+                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);
     }
     /**
-     * Fetch in the provided stack
-     * @param {number} skip
-     * @returns {Promise<any>}
+     * Process and export taxonomies for a specific locale
      */
-    async getAllTaxonomies(skip = 0) {
-        var _a, _b;
-        if (skip) {
-            this.qs.skip = skip;
-            cli_utilities_1.log.debug(`Fetching taxonomies with skip: ${skip}`, this.exportConfig.context);
+    async processLocaleExport(localeCode) {
+        const localeTaxonomies = this.taxonomiesByLocale[localeCode];
+        if ((localeTaxonomies === null || localeTaxonomies === void 0 ? void 0 : localeTaxonomies.size) > 0) {
+            cli_utilities_1.log.info(`Found ${localeTaxonomies.size} taxonomies for locale: ${localeCode}`, this.exportConfig.context);
+            await this.exportTaxonomies(localeCode);
         }
         else {
-            cli_utilities_1.log.debug('Fetching taxonomies with initial query', this.exportConfig.context);
+            cli_utilities_1.log.debug(`No taxonomies found for locale: ${localeCode}`, this.exportConfig.context);
         }
-        cli_utilities_1.log.debug(`Query parameters: ${JSON.stringify(this.qs)}`, this.exportConfig.context);
-        let taxonomyResult = await this.stack.taxonomy().query(this.qs).find();
-        cli_utilities_1.log.debug(`Fetched ${((_a = taxonomyResult.items) === null || _a === void 0 ? void 0 : _a.length) || 0} taxonomies out of total ${taxonomyResult.count}`, this.exportConfig.context);
-        if ((taxonomyResult === null || taxonomyResult === void 0 ? void 0 : taxonomyResult.items) && ((_b = taxonomyResult === null || taxonomyResult === void 0 ? void 0 : taxonomyResult.items) === null || _b === void 0 ? void 0 : _b.length) > 0) {
-            cli_utilities_1.log.debug(`Processing ${taxonomyResult.items.length} taxonomies`, this.exportConfig.context);
-            this.sanitizeTaxonomiesAttribs(taxonomyResult.items);
-            skip += this.taxonomiesConfig.limit;
-            if (skip >= taxonomyResult.count) {
-                cli_utilities_1.log.debug('Completed fetching all taxonomies', this.exportConfig.context);
-                return;
-            }
-            cli_utilities_1.log.debug(`Continuing to fetch taxonomies with skip: ${skip}`, this.exportConfig.context);
-            return await this.getAllTaxonomies(skip);
-        }
-        else {
+    }
+    /**
+     * Write taxonomies metadata file
+     */
+    async writeTaxonomiesMetadata() {
+        if (!this.taxonomies || (0, isEmpty_1.default)(this.taxonomies)) {
             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');
+        cli_utilities_1.log.debug(`Writing taxonomies metadata to: ${taxonomiesFilePath}`, this.exportConfig.context);
+        utils_1.fsUtil.writeFile(taxonomiesFilePath, this.taxonomies);
     }
-    sanitizeTaxonomiesAttribs(taxonomies) {
+    /**
+     * Fetch taxonomies
+     *
+     * @async
+     * @param {?string} [localeCode]
+     * @param {boolean} [checkLocaleSupport=false]
+     * @returns {Promise<void>}
+     */
+    async fetchTaxonomies(localeCode, checkLocaleSupport = false) {
         var _a;
-        cli_utilities_1.log.debug(`Sanitizing ${taxonomies.length} taxonomies`, this.exportConfig.context);
-        for (let index = 0; index < (taxonomies === null || taxonomies === void 0 ? void 0 : taxonomies.length); index++) {
-            const taxonomy = taxonomies[index];
-            const taxonomyUid = taxonomy.uid;
-            const taxonomyName = taxonomy === null || taxonomy === void 0 ? void 0 : taxonomy.name;
-            cli_utilities_1.log.debug(`Processing taxonomy: ${taxonomyName} (${taxonomyUid})`, this.exportConfig.context);
-            if (this.taxonomiesConfig.invalidKeys && this.taxonomiesConfig.invalidKeys.length > 0) {
-                this.taxonomies[taxonomyUid] = (0, omit_1.default)(taxonomy, this.taxonomiesConfig.invalidKeys);
+        let skip = 0;
+        const localeInfo = localeCode ? `for locale: ${localeCode}` : '';
+        if (localeCode && !this.taxonomiesByLocale[localeCode]) {
+            this.taxonomiesByLocale[localeCode] = new Set();
+        }
+        do {
+            const queryParams = Object.assign(Object.assign({}, this.qs), { skip });
+            if (localeCode) {
+                queryParams.locale = localeCode;
             }
-            else {
-                this.taxonomies[taxonomyUid] = taxonomy;
+            cli_utilities_1.log.debug(`Fetching taxonomies ${localeInfo} with skip: ${skip}`, this.exportConfig.context);
+            try {
+                const data = await this.stack.taxonomy().query(queryParams).find();
+                const { items, count } = data;
+                const taxonomiesCount = (_a = count !== null && count !== void 0 ? count : items === null || items === void 0 ? void 0 : items.length) !== null && _a !== void 0 ? _a : 0;
+                cli_utilities_1.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} taxonomies out of total ${taxonomiesCount} ${localeInfo}`, this.exportConfig.context);
+                if (!(items === null || items === void 0 ? void 0 : items.length)) {
+                    cli_utilities_1.log.debug(`No taxonomies found ${localeInfo}`, this.exportConfig.context);
+                    break;
+                }
+                // Check localization support
+                if (checkLocaleSupport && localeCode && skip === 0 && !items[0].locale) {
+                    cli_utilities_1.log.debug('API does not support locale-based taxonomy export', this.exportConfig.context);
+                    this.isLocaleBasedExportSupported = false;
+                }
+                this.sanitizeTaxonomiesAttribs(items, localeCode);
+                skip += this.qs.limit || 100;
+                if (skip >= taxonomiesCount) {
+                    cli_utilities_1.log.debug(`Completed fetching all taxonomies ${localeInfo}`, this.exportConfig.context);
+                    break;
+                }
+            }
+            catch (error) {
+                cli_utilities_1.log.debug(`Error fetching taxonomies ${localeInfo}`, this.exportConfig.context);
+                if (checkLocaleSupport && this.isLocalePlanLimitationError(error)) {
+                    cli_utilities_1.log.debug('Taxonomy localization is not included in your plan. Falling back to non-localized export.', this.exportConfig.context);
+                    this.isLocaleBasedExportSupported = false;
+                }
+                else if (checkLocaleSupport) {
+                    cli_utilities_1.log.debug('Locale-based taxonomy export not supported, will use legacy method', this.exportConfig.context);
+                    this.isLocaleBasedExportSupported = false;
+                }
+                else {
+                    // Log actual errors during normal fetch (not locale check)
+                    (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.exportConfig.context), (localeCode && { locale: localeCode })));
+                }
+                // Break to avoid infinite retry loop on errors
+                break;
+            }
+        } while (true);
+    }
+    /**
+     * remove invalid keys and write data into taxonomies
+     * @function sanitizeTaxonomiesAttribs
+     * @param {Record<string, string>[]} taxonomies
+     * @param {?string} [localeCode]
+     */
+    sanitizeTaxonomiesAttribs(taxonomies, localeCode) {
+        const localeInfo = localeCode ? ` for locale: ${localeCode}` : '';
+        cli_utilities_1.log.debug(`Processing ${taxonomies.length} taxonomies${localeInfo}`, this.exportConfig.context);
+        for (const taxonomy of taxonomies) {
+            const taxonomyUID = taxonomy.uid;
+            const taxonomyName = taxonomy.name;
+            cli_utilities_1.log.debug(`Processing taxonomy: ${taxonomyName} (${taxonomyUID})${localeInfo}`, this.exportConfig.context);
+            // Store taxonomy metadata (only once per taxonomy)
+            if (!this.taxonomies[taxonomyUID]) {
+                this.taxonomies[taxonomyUID] = (0, omit_1.default)(taxonomy, this.taxonomiesConfig.invalidKeys);
+            }
+            // Track taxonomy for this locale
+            if (localeCode) {
+                this.taxonomiesByLocale[localeCode].add(taxonomyUID);
             }
-            // Track progress for each taxonomy
-            (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.tick(true, `taxonomy: ${taxonomyName || taxonomyUid}`, null, utils_1.PROCESS_NAMES.FETCH_TAXONOMIES);
         }
-        cli_utilities_1.log.debug(`Sanitization complete. Total taxonomies processed: ${Object.keys(this.taxonomies || {}).length}`, this.exportConfig.context);
+        cli_utilities_1.log.debug(`Processing complete${localeInfo}. Total taxonomies processed: ${(0, keys_1.default)(this.taxonomies).length}`, this.exportConfig.context);
     }
     /**
-     * Export all taxonomies details using metadata(this.taxonomies) and write it into respective <taxonomy-uid>.json file
-     * @returns {Promise<any>}
+     * Export taxonomies - supports both locale-based and legacy export
      */
-    async exportTaxonomies() {
-        var _a;
-        cli_utilities_1.log.debug(`Exporting ${(_a = Object.keys(this.taxonomies || {})) === null || _a === void 0 ? void 0 : _a.length} taxonomies with detailed information`, this.exportConfig.context);
-        if ((0, isEmpty_1.default)(this.taxonomies)) {
-            cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('TAXONOMY_NOT_FOUND'), this.exportConfig.context);
+    async exportTaxonomies(localeCode) {
+        const taxonomiesUID = localeCode ? Array.from(this.taxonomiesByLocale[localeCode] || []) : (0, keys_1.default)(this.taxonomies);
+        const localeInfo = localeCode ? ` for locale: ${localeCode}` : '';
+        if (taxonomiesUID.length === 0) {
+            cli_utilities_1.log.debug(`No taxonomies to export${localeInfo}`, this.exportConfig.context);
             return;
         }
+        cli_utilities_1.log.debug(`Exporting detailed data for ${taxonomiesUID.length} taxonomies${localeInfo}`, this.exportConfig.context);
+        const exportFolderPath = localeCode ? (0, node_path_1.resolve)(this.taxonomiesFolderPath, localeCode) : this.taxonomiesFolderPath;
+        if (localeCode) {
+            await utils_1.fsUtil.makeDirectory(exportFolderPath);
+            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)(this.taxonomiesFolderPath, `${uid}.json`);
-            cli_utilities_1.log.debug(`Writing detailed taxonomy to: ${filePath}`, this.exportConfig.context);
+            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);
-            // 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);
+            cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_SUCCESS', 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;
-            // 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({}, this.exportConfig.context), { uid }), cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_FAILED', taxonomyName || uid));
+            cli_utilities_1.log.debug(`Failed to export detailed data for taxonomy: ${uid}${localeInfo}`, this.exportConfig.context);
+            (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign(Object.assign({}, this.exportConfig.context), { uid }), (localeCode && { locale: localeCode })));
         };
-        const taxonomyUids = (0, keys_1.default)(this.taxonomies);
-        cli_utilities_1.log.debug(`Starting detailed export for ${taxonomyUids.length} taxonomies`, this.exportConfig.context);
-        // Export each taxonomy individually
-        for (const uid of taxonomyUids) {
-            try {
-                cli_utilities_1.log.debug(`Exporting detailed taxonomy: ${uid}`, this.exportConfig.context);
-                await this.makeAPICall({
-                    module: 'export-taxonomy',
-                    uid,
-                    resolve: onSuccess,
-                    reject: onReject,
-                });
+        for (const taxonomyUID of taxonomiesUID) {
+            cli_utilities_1.log.debug(`Processing detailed export for taxonomy: ${taxonomyUID}${localeInfo}`, this.exportConfig.context);
+            const exportParams = { format: 'json' };
+            if (localeCode) {
+                exportParams.locale = localeCode;
+                if (this.qs.include_fallback !== undefined)
+                    exportParams.include_fallback = this.qs.include_fallback;
+                if (this.qs.fallback_locale)
+                    exportParams.fallback_locale = this.qs.fallback_locale;
             }
-            catch (error) {
-                onReject({ error, uid });
+            if (this.qs.branch)
+                exportParams.branch = this.qs.branch;
+            await this.makeAPICall({
+                reject: onReject,
+                resolve: onSuccess,
+                uid: taxonomyUID,
+                module: 'export-taxonomy',
+                queryParam: exportParams,
+            });
+        }
+        cli_utilities_1.log.debug(`Completed detailed taxonomy export process${localeInfo}`, this.exportConfig.context);
+    }
+    /**
+     * Get all locales to export
+     */
+    getLocalesToExport() {
+        var _a;
+        cli_utilities_1.log.debug('Determining locales to export...', this.exportConfig.context);
+        const masterLocaleCode = ((_a = this.exportConfig.master_locale) === null || _a === void 0 ? void 0 : _a.code) || 'en-us';
+        const localeSet = new Set([masterLocaleCode]);
+        try {
+            const locales = utils_1.fsUtil.readFile(this.localesFilePath);
+            if (locales && (0, keys_1.default)(locales || {}).length > 0) {
+                cli_utilities_1.log.debug(`Loaded ${(0, keys_1.default)(locales || {}).length} locales from ${this.localesFilePath}`, this.exportConfig.context);
+                for (const localeUid of (0, keys_1.default)(locales)) {
+                    const localeCode = locales[localeUid].code;
+                    if (localeCode && !localeSet.has(localeCode)) {
+                        localeSet.add(localeCode);
+                        cli_utilities_1.log.debug(`Added locale: ${localeCode} (uid: ${localeUid})`, this.exportConfig.context);
+                    }
+                }
+            }
+            else {
+                cli_utilities_1.log.debug(`No locales found in ${this.localesFilePath}`, this.exportConfig.context);
             }
         }
-        // Write the taxonomies index file
-        const taxonomiesFilePath = (0, node_path_1.resolve)(this.taxonomiesFolderPath, this.taxonomiesConfig.fileName);
-        cli_utilities_1.log.debug(`Writing taxonomies index to: ${taxonomiesFilePath}`, this.exportConfig.context);
-        utils_1.fsUtil.writeFile(taxonomiesFilePath, this.taxonomies);
+        catch (error) {
+            cli_utilities_1.log.warn(`Failed to read locales file: ${this.localesFilePath}`, this.exportConfig.context);
+        }
+        const localesToExport = Array.from(localeSet);
+        cli_utilities_1.log.debug(`Total unique locales to export: ${localesToExport.length}`, this.exportConfig.context);
+        return localesToExport;
+    }
+    isLocalePlanLimitationError(error) {
+        var _a, _b;
+        return ((error === null || error === void 0 ? void 0 : error.status) === 403 &&
+            ((_b = (_a = error === null || error === void 0 ? void 0 : error.errors) === null || _a === void 0 ? void 0 : _a.taxonomies) === null || _b === void 0 ? void 0 : _b.some((msg) => msg.toLowerCase().includes('taxonomy localization') &&
+                msg.toLowerCase().includes('not included in your plan'))));
     }
 }
 exports.default = ExportTaxonomies;

package/lib/export/modules/workflows.js

@@ -140,7 +140,7 @@ class ExportWorkFlows extends base_class_1.default {
             .catch((err) => {
             cli_utilities_1.log.debug(`Failed to fetch role data for UID: ${roleUid}`, this.exportConfig.context);
             (0, cli_utilities_1.handleAndLogError)(err, Object.assign({}, this.exportConfig.context));
-            throw err;
+            return undefined; // Return undefined instead of throwing to handle gracefully
         });
     }
 }

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

@@ -147,6 +147,12 @@ export default interface DefaultConfig {
             fileName: string;
             dependencies?: Modules[];
         };
+        'composable-studio': {
+            dirName: string;
+            fileName: string;
+            apiBaseUrl: string;
+            apiVersion: string;
+        };
         masterLocale: {
             dirName: string;
             fileName: string;

package/lib/types/index.d.ts

@@ -26,7 +26,7 @@ export interface Region {
     cda: string;
     uiHost: string;
 }
-export type Modules = 'stack' | 'assets' | 'locales' | 'environments' | 'extensions' | 'webhooks' | 'global-fields' | 'entries' | 'content-types' | 'custom-roles' | 'workflows' | 'labels' | 'marketplace-apps' | 'taxonomies' | 'personalize';
+export type Modules = 'stack' | 'assets' | 'locales' | 'environments' | 'extensions' | 'webhooks' | 'global-fields' | 'entries' | 'content-types' | 'custom-roles' | 'workflows' | 'labels' | 'marketplace-apps' | 'taxonomies' | 'personalize' | 'composable-studio';
 export type ModuleClassParams = {
     stackAPIClient: ReturnType<ContentstackClient['stack']>;
     exportConfig: ExportConfig;
@@ -96,6 +96,32 @@ export interface StackConfig {
     dependencies?: Modules[];
     limit?: number;
 }
+export interface ComposableStudioConfig {
+    dirName: string;
+    fileName: string;
+    apiBaseUrl: string;
+    apiVersion: string;
+}
+export interface ComposableStudioProject {
+    name: string;
+    description: string;
+    canvasUrl: string;
+    connectedStackApiKey: string;
+    contentTypeUid: string;
+    organizationUid: string;
+    settings: {
+        configuration: {
+            environment: string;
+            locale: string;
+        };
+    };
+    createdBy: string;
+    updatedBy: string;
+    deletedAt: boolean;
+    createdAt: string;
+    updatedAt: string;
+    uid: string;
+}
 export interface Context {
     command: string;
     module: string;

package/lib/utils/basic-login.js

@@ -26,7 +26,7 @@ const login = async (config) => {
             return config;
         }
         else {
-            cli_utilities_1.log.error(`Failed to login, Invalid credentials`, config.context);
+            cli_utilities_1.log.error(`Failed to log in!`, config.context);
             process.exit(1);
         }
     }

package/lib/utils/export-config-handler.js

@@ -16,14 +16,14 @@ const setupConfig = async (exportCmdFlags) => {
     cli_utilities_1.log.debug('Setting up export configuration');
     // setup the config
     if (exportCmdFlags['config']) {
-        cli_utilities_1.log.debug('Loading external configuration file', { configFile: exportCmdFlags['config'] });
+        cli_utilities_1.log.debug('Loading external configuration file...', { configFile: exportCmdFlags['config'] });
         const externalConfig = await (0, file_helper_1.readFile)(exportCmdFlags['config']);
         config = merge_1.default.recursive(config, externalConfig);
     }
     config.exportDir = (0, cli_utilities_1.sanitizePath)(exportCmdFlags['data'] || exportCmdFlags['data-dir'] || config.data || (await (0, interactive_1.askExportDir)()));
     const pattern = /[*$%#<>{}!&?]/g;
     if (pattern.test(config.exportDir)) {
-        cli_utilities_1.cliux.print(`\nPlease add a directory path without any of the special characters: (*,&,{,},[,],$,%,<,>,?,!)`, {
+        cli_utilities_1.cliux.print(`\nPlease enter a directory path without any special characters: (*,&,{,},[,],$,%,<,>,?,!)`, {
             color: 'yellow',
         });
         config.exportDir = (0, cli_utilities_1.sanitizePath)(await (0, interactive_1.askExportDir)());
@@ -40,7 +40,7 @@ const setupConfig = async (exportCmdFlags) => {
         config.apiKey = apiKey;
         authenticationMethod = 'Management Token';
         if (!config.management_token) {
-            cli_utilities_1.log.debug('Management token not found for alias', { alias: managementTokenAlias });
+            cli_utilities_1.log.debug('Management token not found for alias!', { alias: managementTokenAlias });
             throw new Error(`No management token found on given alias ${managementTokenAlias}`);
         }
         cli_utilities_1.log.debug('Management token configuration successful');
@@ -73,7 +73,7 @@ const setupConfig = async (exportCmdFlags) => {
             config.apiKey =
                 exportCmdFlags['stack-uid'] || exportCmdFlags['stack-api-key'] || config.source_stack || (await (0, interactive_1.askAPIKey)());
             if (typeof config.apiKey !== 'string') {
-                cli_utilities_1.log.debug('Invalid API key received', { apiKey: config.apiKey });
+                cli_utilities_1.log.debug('Invalid API key received!', { apiKey: config.apiKey });
                 throw new Error('Invalid API key received');
             }
         }
@@ -123,7 +123,7 @@ const setupConfig = async (exportCmdFlags) => {
     cli_utilities_1.configHandler.set('log.progressSupportedModule', 'export');
     // Add authentication details to config for context tracking
     config.authenticationMethod = authenticationMethod;
-    cli_utilities_1.log.debug('Export configuration setup completed', Object.assign({}, config));
+    cli_utilities_1.log.debug('Export configuration setup completed.', Object.assign({}, config));
     return config;
 };
 exports.default = setupConfig;

package/lib/utils/file-helper.js

@@ -51,7 +51,7 @@ const readLargeFile = function (filePath, options = {}) {
                 resolve(data);
             });
             parseStream.on('error', (error) => {
-                console.log('error', error);
+                console.log('Error', error);
                 reject(error);
             });
             readStream.pipe(parseStream);

package/lib/utils/marketplace-app-helper.js

@@ -22,10 +22,8 @@ async function createNodeCryptoInstance(config) {
     if (config.forceStopMarketplaceAppsPrompt) {
         cryptoArgs['encryptionKey'] = config.marketplaceAppEncryptionKey;
     }
-    else if (config.marketplaceAppEncryptionKey) {
-        cryptoArgs['encryptionKey'] = config.marketplaceAppEncryptionKey;
-    }
     else {
+        // Always prompt when forceStopMarketplaceAppsPrompt is false, using existing key as default
         cli_utilities_1.cliux.print('');
         cryptoArgs['encryptionKey'] = await askEncryptionKey(config);
         cli_utilities_1.cliux.print('');