@contentstack/cli-cm-export 1.20.2 → 1.22.0

package/lib/export/modules/stack.js

@@ -17,20 +17,20 @@ class ExportStack extends base_class_1.default {
     async start() {
         cli_utilities_1.log.debug('Starting stack export process...', this.exportConfig.context);
         if ((0, cli_utilities_1.isAuthenticated)()) {
-            cli_utilities_1.log.debug('User is authenticated, fetching stack data...', this.exportConfig.context);
+            cli_utilities_1.log.debug('User authenticated.', this.exportConfig.context);
             const stackData = await this.getStack();
             if (stackData === null || stackData === void 0 ? void 0 : stackData.org_uid) {
-                cli_utilities_1.log.debug(`Found organization UID: ${stackData.org_uid}`, this.exportConfig.context);
+                cli_utilities_1.log.debug(`Found organization UID: '${stackData.org_uid}'.`, this.exportConfig.context);
                 this.exportConfig.org_uid = stackData.org_uid;
                 this.exportConfig.sourceStackName = stackData.name;
-                cli_utilities_1.log.debug(`Set source stack name: ${stackData.name}`, this.exportConfig.context);
+                cli_utilities_1.log.debug(`Set source stack name: '${stackData.name}'.`, this.exportConfig.context);
             }
             else {
-                cli_utilities_1.log.debug('No stack data found or missing org_uid', this.exportConfig.context);
+                cli_utilities_1.log.debug('No stack data found or missing organization UID.', this.exportConfig.context);
             }
         }
         else {
-            cli_utilities_1.log.debug('User is not authenticated, skipping stack data fetch', this.exportConfig.context);
+            cli_utilities_1.log.debug('User is not authenticated.', this.exportConfig.context);
         }
         if (this.exportConfig.management_token) {
             cli_utilities_1.log.info('Skipping stack settings export: Operation is not supported when using a management token.', this.exportConfig.context);
@@ -44,61 +44,61 @@ class ExportStack extends base_class_1.default {
             return this.getLocales();
         }
         else if (this.exportConfig.preserveStackVersion) {
-            cli_utilities_1.log.debug('Preserve stack version is true, exporting stack...', this.exportConfig.context);
+            cli_utilities_1.log.debug('Preserve stack version is set to true.', this.exportConfig.context);
             return this.exportStack();
         }
         else {
-            cli_utilities_1.log.debug('Master locale already set, skipping locale fetch', this.exportConfig.context);
+            cli_utilities_1.log.debug('Master locale is already set.', this.exportConfig.context);
         }
     }
     async getStack() {
-        cli_utilities_1.log.debug(`Fetching stack data for stack: ${this.exportConfig.source_stack}`, this.exportConfig.context);
+        cli_utilities_1.log.debug(`Fetching stack data for: '${this.exportConfig.source_stack}'...`, this.exportConfig.context);
         const tempAPIClient = await (0, cli_utilities_1.managementSDKClient)({ host: this.exportConfig.host });
-        cli_utilities_1.log.debug(`Created management SDK client with host: ${this.exportConfig.host}`, this.exportConfig.context);
+        cli_utilities_1.log.debug(`Created Management SDK client with host: '${this.exportConfig.host}'.`, this.exportConfig.context);
         return await tempAPIClient
             .stack({ api_key: this.exportConfig.source_stack })
             .fetch()
             .then((data) => {
-            cli_utilities_1.log.debug(`Successfully fetched stack data for: ${this.exportConfig.source_stack}`, this.exportConfig.context);
+            cli_utilities_1.log.debug(`Successfully fetched stack data for: '${this.exportConfig.source_stack}'.`, this.exportConfig.context);
             return data;
         })
             .catch((error) => {
-            cli_utilities_1.log.debug(`Failed to fetch stack data for: ${this.exportConfig.source_stack}`, this.exportConfig.context);
+            cli_utilities_1.log.debug(`Failed to fetch stack data for: '${this.exportConfig.source_stack}'.`, this.exportConfig.context);
             return {};
         });
     }
     async getLocales(skip = 0) {
         if (skip) {
             this.qs.skip = skip;
-            cli_utilities_1.log.debug(`Fetching locales with skip: ${skip}`, this.exportConfig.context);
+            cli_utilities_1.log.debug(`Fetching locales with skip: ${skip}.`, this.exportConfig.context);
         }
         else {
-            cli_utilities_1.log.debug('Fetching locales with initial query', this.exportConfig.context);
+            cli_utilities_1.log.debug('Fetching locales with initial query...', this.exportConfig.context);
         }
-        cli_utilities_1.log.debug(`Query parameters: ${JSON.stringify(this.qs)}`, this.exportConfig.context);
+        cli_utilities_1.log.debug(`Query parameters: ${JSON.stringify(this.qs)}.`, this.exportConfig.context);
         return await this.stack
             .locale()
             .query(this.qs)
             .find()
             .then(async (data) => {
             const { items, count } = data;
-            cli_utilities_1.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} locales out of total ${count}`, this.exportConfig.context);
+            cli_utilities_1.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} locales out of ${count}.`, this.exportConfig.context);
             if (items === null || items === void 0 ? void 0 : items.length) {
-                cli_utilities_1.log.debug(`Processing ${items.length} locales to find master locale`, this.exportConfig.context);
+                cli_utilities_1.log.debug(`Processing ${items.length} locales to find the master locale...`, this.exportConfig.context);
                 skip += this.stackConfig.limit || 100;
                 const masterLocalObj = (0, find_1.default)(items, (locale) => {
                     if (locale.fallback_locale === null) {
-                        cli_utilities_1.log.debug(`Found master locale: ${locale.name} (${locale.code})`, this.exportConfig.context);
+                        cli_utilities_1.log.debug(`Found master locale: '${locale.name}' (code: ${locale.code}).`, this.exportConfig.context);
                         return locale;
                     }
                 });
                 if (masterLocalObj) {
-                    cli_utilities_1.log.debug(`Returning master locale: ${masterLocalObj.name}`, this.exportConfig.context);
+                    cli_utilities_1.log.debug(`Returning master locale: '${masterLocalObj.name}'.`, this.exportConfig.context);
                     return masterLocalObj;
                 }
                 else if (skip >= count) {
                     cli_utilities_1.log.error(`Master locale not found in the stack ${this.exportConfig.source_stack}. Please ensure that the stack has a master locale.`, this.exportConfig.context);
-                    cli_utilities_1.log.debug('Completed searching all locales without finding master locale', this.exportConfig.context);
+                    cli_utilities_1.log.debug('Completed search. Master locale not found.', this.exportConfig.context);
                     return;
                 }
                 else {
@@ -107,7 +107,7 @@ class ExportStack extends base_class_1.default {
                 }
             }
             else {
-                cli_utilities_1.log.debug('No locales found to process', this.exportConfig.context);
+                cli_utilities_1.log.debug('No locales found to process.', this.exportConfig.context);
             }
         })
             .catch((error) => {
@@ -117,26 +117,26 @@ class ExportStack extends base_class_1.default {
         });
     }
     async exportStack() {
-        cli_utilities_1.log.debug(`Starting stack export for: ${this.exportConfig.source_stack}`, this.exportConfig.context);
+        cli_utilities_1.log.debug(`Starting stack export for: '${this.exportConfig.source_stack}'...`, this.exportConfig.context);
         await utils_1.fsUtil.makeDirectory(this.stackFolderPath);
-        cli_utilities_1.log.debug(`Created stack directory at: ${this.stackFolderPath}`, this.exportConfig.context);
+        cli_utilities_1.log.debug(`Created stack directory at: '${this.stackFolderPath}'`, this.exportConfig.context);
         return this.stack
             .fetch()
             .then((resp) => {
             const stackFilePath = (0, node_path_1.resolve)(this.stackFolderPath, this.stackConfig.fileName);
-            cli_utilities_1.log.debug(`Writing stack data to: ${stackFilePath}`, this.exportConfig.context);
+            cli_utilities_1.log.debug(`Writing stack data to: '${stackFilePath}'`, this.exportConfig.context);
             utils_1.fsUtil.writeFile(stackFilePath, resp);
             cli_utilities_1.log.success(`Stack details exported successfully for stack ${this.exportConfig.source_stack}`, this.exportConfig.context);
-            cli_utilities_1.log.debug('Stack export completed successfully', this.exportConfig.context);
+            cli_utilities_1.log.debug('Stack export completed successfully.', this.exportConfig.context);
             return resp;
         })
             .catch((error) => {
-            cli_utilities_1.log.debug(`Error occurred while exporting stack: ${this.exportConfig.source_stack}`, this.exportConfig.context);
+            cli_utilities_1.log.debug(`An error occurred while exporting stack: '${this.exportConfig.source_stack}'.`, this.exportConfig.context);
             (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
         });
     }
     async exportStackSettings() {
-        cli_utilities_1.log.info('Exporting stack settings', this.exportConfig.context);
+        cli_utilities_1.log.info('Exporting stack settings...', this.exportConfig.context);
         await utils_1.fsUtil.makeDirectory(this.stackFolderPath);
         return this.stack
             .settings()

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

@@ -2,26 +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 all taxonomies in the provided stack
-     * @param {number} skip
-     * @returns {Promise<any>}
+     * Process and export taxonomies for a specific locale
      */
-    getAllTaxonomies(skip?: number): Promise<any>;
+    processLocaleExport(localeCode: string): Promise<void>;
+    /**
+     * Write taxonomies metadata file
+     */
+    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 taxonomies
+     * @param {Record<string, string>[]} taxonomies
+     * @param {?string} [localeCode]
      */
-    sanitizeTaxonomiesAttribs(taxonomies: Record<string, string>[]): void;
+    sanitizeTaxonomiesAttribs(taxonomies: Record<string, string>[], localeCode?: string): void;
     /**
-     * Export all taxonomies details using metadata(this.taxonomies) and write it into respective <taxonomy-uid>.json file
-     * @returns {Promise<void>}
+     * Export taxonomies - supports both locale-based and legacy export
+     */
+    exportTaxonomies(localeCode?: string): Promise<void>;
+    /**
+     * Get all locales to export
      */
-    exportTaxonomies(): Promise<void>;
+    getLocalesToExport(): string[];
+    private isLocalePlanLimitationError;
 }

package/lib/export/modules/taxonomies.js

@@ -11,122 +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 = '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() {
-        cli_utilities_1.log.debug('Starting taxonomies export process...', this.exportConfig.context);
+        var _a;
+        cli_utilities_1.log.debug('Starting export process for taxonomies...', this.exportConfig.context);
         //create taxonomies folder
         this.taxonomiesFolderPath = (0, node_path_1.resolve)(this.exportConfig.data, this.exportConfig.branchName || '', this.taxonomiesConfig.dirName);
-        cli_utilities_1.log.debug(`Taxonomies folder path: ${this.taxonomiesFolderPath}`, this.exportConfig.context);
+        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);
-        //fetch all taxonomies and write into taxonomies folder
-        cli_utilities_1.log.debug('Fetching all taxonomies...', this.exportConfig.context);
-        await this.getAllTaxonomies();
-        cli_utilities_1.log.debug(`Retrieved ${Object.keys(this.taxonomies).length} taxonomies`, this.exportConfig.context);
-        if (this.taxonomies === undefined || (0, isEmpty_1.default)(this.taxonomies)) {
-            cli_utilities_1.log.info(cli_utilities_1.messageHandler.parse('TAXONOMY_NOT_FOUND'), this.exportConfig.context);
+        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;
         }
-        else {
-            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);
-            cli_utilities_1.log.debug('Starting detailed taxonomy export...', this.exportConfig.context);
+        // 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);
+        cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_COMPLETE', (0, keys_1.default)(this.taxonomies || {}).length), this.exportConfig.context);
     }
     /**
-     * fetch all taxonomies in the provided stack
-     * @param {number} skip
-     * @returns {Promise<any>}
+     * Process and export taxonomies for a specific locale
      */
-    async getAllTaxonomies(skip = 0) {
-        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);
+        }
+    }
+    /**
+     * 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;
         }
-        cli_utilities_1.log.debug(`Query parameters: ${JSON.stringify(this.qs)}`, this.exportConfig.context);
-        await this.stack
-            .taxonomy()
-            .query(this.qs)
-            .find()
-            .then(async (data) => {
-            const { items, count } = data;
-            const taxonomiesCount = count !== undefined ? count : items === null || items === void 0 ? void 0 : items.length;
-            cli_utilities_1.log.debug(`Fetched ${(items === null || items === void 0 ? void 0 : items.length) || 0} taxonomies out of total ${taxonomiesCount}`, this.exportConfig.context);
-            if (items === null || items === void 0 ? void 0 : items.length) {
-                cli_utilities_1.log.debug(`Processing ${items.length} taxonomies`, this.exportConfig.context);
-                this.sanitizeTaxonomiesAttribs(items);
+        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);
+    }
+    /**
+     * Fetch taxonomies
+     *
+     * @async
+     * @param {?string} [localeCode]
+     * @param {boolean} [checkLocaleSupport=false]
+     * @returns {Promise<void>}
+     */
+    async fetchTaxonomies(localeCode, checkLocaleSupport = false) {
+        var _a;
+        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;
+            }
+            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', this.exportConfig.context);
-                    return;
+                    cli_utilities_1.log.debug(`Completed fetching all taxonomies ${localeInfo}`, this.exportConfig.context);
+                    break;
                 }
-                cli_utilities_1.log.debug(`Continuing to fetch taxonomies with skip: ${skip}`, this.exportConfig.context);
-                return await this.getAllTaxonomies(skip);
             }
-            else {
-                cli_utilities_1.log.debug('No taxonomies found to process', this.exportConfig.context);
+            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;
             }
-        })
-            .catch((error) => {
-            cli_utilities_1.log.debug('Error occurred while fetching taxonomies', this.exportConfig.context);
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign({}, this.exportConfig.context));
-        });
+        } while (true);
     }
     /**
      * remove invalid keys and write data into taxonomies
      * @function sanitizeTaxonomiesAttribs
-     * @param taxonomies
+     * @param {Record<string, string>[]} taxonomies
+     * @param {?string} [localeCode]
      */
-    sanitizeTaxonomiesAttribs(taxonomies) {
-        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 taxonomyUID = taxonomies[index].uid;
-            const taxonomyName = (_a = taxonomies[index]) === null || _a === void 0 ? void 0 : _a.name;
-            cli_utilities_1.log.debug(`Processing taxonomy: ${taxonomyName} (${taxonomyUID})`, this.exportConfig.context);
-            this.taxonomies[taxonomyUID] = (0, omit_1.default)(taxonomies[index], this.taxonomiesConfig.invalidKeys);
+    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);
+            }
         }
-        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<void>}
+     * Export taxonomies - supports both locale-based and legacy export
      */
-    async exportTaxonomies() {
-        const taxonomiesUID = (0, keys_1.default)(this.taxonomies) || [];
-        cli_utilities_1.log.debug(`Exporting detailed data for ${taxonomiesUID.length} taxonomies`, 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 }) => {
-            const filePath = (0, node_path_1.resolve)(this.taxonomiesFolderPath, `${uid}.json`);
+            const filePath = (0, node_path_1.resolve)(exportFolderPath, `${uid}.json`);
             cli_utilities_1.log.debug(`Writing detailed taxonomy data to: ${filePath}`, this.exportConfig.context);
             utils_1.fsUtil.writeFile(filePath, response);
             cli_utilities_1.log.success(cli_utilities_1.messageHandler.parse('TAXONOMY_EXPORT_SUCCESS', uid), this.exportConfig.context);
         };
         const onReject = ({ error, uid }) => {
-            cli_utilities_1.log.debug(`Failed to export detailed data for taxonomy: ${uid}`, this.exportConfig.context);
-            (0, cli_utilities_1.handleAndLogError)(error, Object.assign(Object.assign({}, this.exportConfig.context), { 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 })));
         };
-        for (let index = 0; index < (taxonomiesUID === null || taxonomiesUID === void 0 ? void 0 : taxonomiesUID.length); index++) {
-            const taxonomyUID = taxonomiesUID[index];
-            cli_utilities_1.log.debug(`Processing detailed export for taxonomy: ${taxonomyUID}`, this.exportConfig.context);
+        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;
+            }
+            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', this.exportConfig.context);
+        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);
+            }
+        }
+        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-js/assets.js

@@ -240,7 +240,7 @@ module.exports = class ExportAssets {
         const assetVersionInfo = bucket || [];
         return new Promise((resolve, reject) => {
             if (self.assetDownloadRetry[uid + version] > self.assetDownloadRetryLimit) {
-                console.log('Reached max', self.assetDownloadRetry[uid + version]);
+                console.log('Reached the maximum limit.', self.assetDownloadRetry[uid + version]);
                 return reject(new Error('Asset Max download retry limit exceeded! ' + uid));
             }
             if (version <= 0) {
@@ -274,7 +274,7 @@ module.exports = class ExportAssets {
                 .catch((error) => {
                 log(self.config, error, 'error');
                 if (error.status === 408) {
-                    console.log('retrying', uid);
+                    console.log('Retrying...', uid);
                     // retrying when timeout
                     self.assetDownloadRetry[uid + version]
                         ? ++self.assetDownloadRetry[uid + version]
@@ -313,7 +313,7 @@ module.exports = class ExportAssets {
                         length: assetStreamRequest.headers['content-length'],
                     });
                     str.on('progress', (progressData) => {
-                        console.log(`${asset.filename}: ${Math.round(progressData.percentage)}%`);
+                        console.log(`${asset.filename}: ${Math.round(progressData.percentage)}% complete`);
                     });
                     assetStreamRequest.pipe(str).pipe(assetFileStream);
                 }

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

@@ -148,6 +148,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);
         }
     }