fix: Taxonomy Export Fails When Localization Not in Plan

Author: aman19K

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "@contentstack/cli-cm-export",
   "description": "Contentstack CLI plugin to export content from stack",
-  "version": "1.21.0",
+  "version": "1.21.1",
   "author": "Contentstack",
   "bugs": "https://github.com/contentstack/cli/issues",
   "dependencies": {

packages/contentstack-export/package.json

@@ -73,7 +73,11 @@ export default class ExportTaxonomies extends BaseClass {
     await this.fetchTaxonomies(masterLocale, true);
 
     if (!this.isLocaleBasedExportSupported) {
-      log.debug('Localization disabled, falling back to legacy export method', this.exportConfig.context);
+      this.taxonomies = {};
+      this.taxonomiesByLocale = {};
+
+      // Fetch taxonomies without locale parameter
+      await this.fetchTaxonomies();
       await this.exportTaxonomies();
       await this.writeTaxonomiesMetadata();
     } else {
@@ -174,15 +178,20 @@ export default class ExportTaxonomies extends BaseClass {
           log.debug(`Completed fetching all taxonomies ${localeInfo}`, this.exportConfig.context);
           break;
         }
-      } catch (error) {
+      } catch (error: any) {
         log.debug(`Error fetching taxonomies ${localeInfo}`, this.exportConfig.context);
-        handleAndLogError(error, {
-          ...this.exportConfig.context,
-          ...(localeCode && { locale: localeCode }),
-        });
-        if (checkLocaleSupport) {
+
+        if (checkLocaleSupport && this.isLocalePlanLimitationError(error)) {
+          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
+          handleAndLogError(error, {
+            ...this.exportConfig.context,
+            ...(localeCode && { locale: localeCode }),
+          });
         }
+
         // Break to avoid infinite retry loop on errors
         break;
       }
@@ -312,4 +321,15 @@ export default class ExportTaxonomies extends BaseClass {
 
     return localesToExport;
   }
+
+  private isLocalePlanLimitationError(error: any): boolean {
+    return (
+      error?.status === 403 &&
+      error?.errors?.taxonomies?.some(
+        (msg: string) =>
+          msg.toLowerCase().includes('taxonomy localization') &&
+          msg.toLowerCase().includes('not included in your plan'),
+      )
+    );
+  }
 }

packages/contentstack-export/src/export/modules/taxonomies.ts

@@ -28,7 +28,7 @@
     "@contentstack/cli-cm-branches": "~1.6.0",
     "@contentstack/cli-cm-bulk-publish": "~1.10.2",
     "@contentstack/cli-cm-clone": "~1.17.0",
-    "@contentstack/cli-cm-export": "~1.21.0",
+    "@contentstack/cli-cm-export": "~1.21.1",
     "@contentstack/cli-cm-export-to-csv": "~1.10.0",
     "@contentstack/cli-cm-import": "~1.29.0",
     "@contentstack/cli-cm-import-setup": "~1.7.0",