fix(import): align import with single-branch export, import; path resolution and target branch handling

packages/contentstack-clone/src/core/util/clone-handler.ts

@@ -644,8 +644,8 @@ export class CloneHandler {
         importConfig.contentDir = importConfig.data;
       }
 
-      if (!importConfig.contentDir && importConfig.sourceStackBranch && importConfig.pathDir) {
-        const dataPath = path.join(importConfig.pathDir, importConfig.sourceStackBranch);
+      if (!importConfig.contentDir && importConfig.pathDir) {
+        const dataPath = importConfig.pathDir;
         cmd.push('-d', dataPath);
         log.debug(`Import data path: ${dataPath}`, this.config.cloneContext);
       }
@@ -675,7 +675,7 @@ export class CloneHandler {
         cmd: cmd.join(' '),
         targetStack: importConfig.apiKey || importConfig.target_stack,
         targetBranch: importConfig.targetStackBranch,
-        dataPath: importConfig.contentDir || (importConfig.pathDir && importConfig.sourceStackBranch ? path.join(importConfig.pathDir, importConfig.sourceStackBranch) : undefined)
+        dataPath: importConfig.contentDir || importConfig.pathDir || undefined
       });
       log.debug('Running import command', { ...this.config.cloneContext, cmd });
       const importData = importCmd.run(cmd);
@@ -804,9 +804,10 @@ export class CloneHandler {
         ];
         let successMsg: string;
         let selectedValue: any = {};
-        // Resolve path to package root - go up 3 levels from __dirname (core/util -> package root)
+        // Export root only (single-branch layout: modules live directly under -d, not pathDir/<branch>)
         const cloneTypePackageRoot = path.resolve(__dirname, '../../..');
-        this.config.contentDir = path.join(cloneTypePackageRoot, 'contents', this.config.sourceStackBranch || '');
+        this.config.contentDir =
+          this.config.pathDir || path.join(cloneTypePackageRoot, 'contents');
         log.debug(`Clone content directory: ${this.config.contentDir}`, this.config.cloneContext);
 
         if (!this.config.cloneType) {

packages/contentstack-clone/src/types/clone-config.ts

@@ -31,7 +31,7 @@ export interface CloneConfig {
   forceStopMarketplaceAppsPrompt?: boolean;
 
   // Data and modules
-  /** Path to exported content for import (aligns with import plugin's contentDir) */
+  /** Export root directory for import (same path as export `-d`; not a branch-named subdirectory) */
   contentDir?: string;
   modules?: string[];
   filteredModules?: string[];

packages/contentstack-clone/test/lib/util/clone-handler.commands.test.ts

@@ -195,7 +195,7 @@ describe('CloneHandler - Commands', () => {
       expect(cmdArgs).to.include('dest-alias');
     });
 
-    it('should execute import command with sourceStackBranch data path (covers lines 637-641)', async () => {
+    it('should execute import command with pathDir as export root when contentDir unset (single-branch layout)', async () => {
       const config: CloneConfig = {
         cloneContext: {
           command: 'test',
@@ -216,11 +216,10 @@ describe('CloneHandler - Commands', () => {
 
       expect(fsStub.writeFileSync.calledTwice).to.be.true;
       expect(importCmdStub.run.calledOnce).to.be.true;
-      // Verify -d flag with data path is added (line 639)
       const cmdArgs = importCmdStub.run.firstCall.args[0];
       expect(cmdArgs).to.include('-d');
       const dataPathIndex = cmdArgs.indexOf('-d');
-      expect(cmdArgs[dataPathIndex + 1]).to.include('/test/path/main');
+      expect(cmdArgs[dataPathIndex + 1]).to.equal('/test/path');
     });
 
     it('should execute import command with data path instead of sourceStackBranch (covers line 637 condition)', async () => {

packages/contentstack-export/src/export/module-exporter.ts

@@ -1,4 +1,3 @@
-import * as path from 'path';
 import {
   ContentstackClient,
   handleAndLogError,
@@ -66,7 +65,7 @@ class ModuleExporter {
     try {
       this.exportConfig.branchName = targetBranch.uid;
       this.stackAPIClient.stackHeaders.branch = targetBranch.uid;
-      this.exportConfig.branchDir = path.join(this.exportConfig.exportDir, targetBranch.uid);
+      this.exportConfig.branchDir = this.exportConfig.exportDir;
 
       // Initialize progress manager for the target branch
       CLIProgressManager.clearGlobalSummary();

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

@@ -25,7 +25,7 @@ import { PATH_CONSTANTS } from '../../constants';
 import config from '../../config';
 import { ModuleClassParams } from '../../types';
 import BaseClass, { CustomPromiseHandler, CustomPromiseHandlerInput } from './base-class';
-import { PROCESS_NAMES, MODULE_CONTEXTS, PROCESS_STATUS, MODULE_NAMES } from '../../utils';
+import { getExportBasePath, PROCESS_NAMES, MODULE_CONTEXTS, PROCESS_STATUS, MODULE_NAMES } from '../../utils';
 
 export default class ExportAssets extends BaseClass {
   private assetsRootPath: string;
@@ -49,8 +49,7 @@ export default class ExportAssets extends BaseClass {
 
   async start(): Promise<void> {
       this.assetsRootPath = pResolve(
-      this.exportConfig.exportDir,
-      this.exportConfig.branchName || '',
+      getExportBasePath(this.exportConfig),
       this.assetConfig.dirName,
     );
     log.debug(`Assets root path resolved to: ${this.assetsRootPath}`, this.exportConfig.context);

packages/contentstack-export/src/export/modules/composable-studio.ts

@@ -9,7 +9,7 @@ import {
   authenticationHandler,
 } from '@contentstack/cli-utilities';
 
-import { fsUtil, getOrgUid } from '../../utils';
+import { fsUtil, getExportBasePath, getOrgUid } from '../../utils';
 import { ModuleClassParams, ComposableStudioConfig, ExportConfig, ComposableStudioProject } from '../../types';
 
 export default class ExportComposableStudio {
@@ -41,8 +41,7 @@ export default class ExportComposableStudio {
     }
 
     this.composableStudioPath = pResolve(
-      this.exportConfig.exportDir,
-      this.exportConfig.branchName || '',
+      getExportBasePath(this.exportConfig),
       this.composableStudioConfig.dirName,
     );
     log.debug(`Studio folder path: ${this.composableStudioPath}`, this.exportConfig.context);

packages/contentstack-export/src/export/modules/content-types.ts

@@ -4,7 +4,7 @@ import { PATH_CONSTANTS } from '../../constants';
 
 import BaseClass from './base-class';
 import { ExportConfig, ModuleClassParams } from '../../types';
-import { fsUtil, executeTask, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, executeTask, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class ContentTypesExport extends BaseClass {
   private stackAPIClient: ReturnType<ContentstackClient['stack']>;
@@ -48,8 +48,7 @@ export default class ContentTypesExport extends BaseClass {
     this.applyQueryFilters(this.qs, 'content-types');
 
     this.contentTypesDirPath = path.resolve(
-      sanitizePath(exportConfig.exportDir),
-      sanitizePath(exportConfig.branchName || ''),
+      sanitizePath(getExportBasePath(exportConfig)),
       sanitizePath(this.contentTypesConfig.dirName),
     );
     this.contentTypes = [];

packages/contentstack-export/src/export/modules/custom-roles.ts

@@ -8,6 +8,7 @@ import { handleAndLogError, messageHandler, log } from '@contentstack/cli-utilit
 import BaseClass from './base-class';
 import {
   fsUtil,
+  getExportBasePath,
   PROCESS_NAMES,
   MODULE_CONTEXTS,
   PROCESS_STATUS,
@@ -43,8 +44,7 @@ export default class ExportCustomRoles extends BaseClass {
         'CUSTOM-ROLES: Analyzing roles and locales...',
         async () => {
           this.rolesFolderPath = pResolve(
-            this.exportConfig.exportDir,
-            this.exportConfig.branchName || '',
+            getExportBasePath(this.exportConfig),
             this.customRolesConfig.dirName,
           );
 

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

@@ -10,7 +10,7 @@ import {
 } from '@contentstack/cli-utilities';
 import { PATH_CONSTANTS } from '../../constants';
 import { Export, ExportProjects } from '@contentstack/cli-variants';
-import { fsUtil, PROCESS_NAMES, MODULE_CONTEXTS, PROCESS_STATUS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, PROCESS_NAMES, MODULE_CONTEXTS, PROCESS_STATUS, MODULE_NAMES } from '../../utils';
 import BaseClass, { ApiOptions } from './base-class';
 import { ExportConfig, ModuleClassParams } from '../../types';
 
@@ -41,20 +41,18 @@ export default class EntriesExport extends BaseClass {
     this.stackAPIClient = stackAPIClient;
     this.exportConfig = exportConfig;
     this.entriesConfig = exportConfig.modules.entries;
+    const basePath = getExportBasePath(exportConfig);
     this.entriesDirPath = path.resolve(
-      sanitizePath(exportConfig.exportDir),
-      sanitizePath(exportConfig.branchName || ''),
+      sanitizePath(basePath),
       sanitizePath(this.entriesConfig.dirName),
     );
     this.localesFilePath = path.resolve(
-      sanitizePath(exportConfig.exportDir),
-      sanitizePath(exportConfig.branchName || ''),
+      sanitizePath(basePath),
       sanitizePath(exportConfig.modules.locales.dirName),
       sanitizePath(exportConfig.modules.locales.fileName),
     );
     this.contentTypesDirPath = path.resolve(
-      sanitizePath(exportConfig.exportDir),
-      sanitizePath(exportConfig.branchName || ''),
+      sanitizePath(basePath),
       sanitizePath(exportConfig.modules.content_types.dirName),
     );
     this.projectInstance = new ExportProjects(this.exportConfig);

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

@@ -5,7 +5,7 @@ import { handleAndLogError, messageHandler, log } from '@contentstack/cli-utilit
 
 import BaseClass from './base-class';
 import { EnvironmentConfig, ModuleClassParams } from '../../types';
-import { fsUtil, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class ExportEnvironments extends BaseClass {
   private environments: Record<string, unknown>;
@@ -32,8 +32,7 @@ export default class ExportEnvironments extends BaseClass {
       // Setup with loading spinner
       const [totalCount] = await this.withLoadingSpinner('ENVIRONMENTS: Analyzing environments...', async () => {
         this.environmentsFolderPath = pResolve(
-          this.exportConfig.exportDir,
-          this.exportConfig.branchName || '',
+          getExportBasePath(this.exportConfig),
           this.environmentConfig.dirName,
         );
         await fsUtil.makeDirectory(this.environmentsFolderPath);

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

@@ -5,7 +5,7 @@ import { handleAndLogError, messageHandler, log } from '@contentstack/cli-utilit
 
 import BaseClass from './base-class';
 import { ExtensionsConfig, ModuleClassParams } from '../../types';
-import { fsUtil, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class ExportExtensions extends BaseClass {
   private extensionsFolderPath: string;
@@ -33,8 +33,7 @@ export default class ExportExtensions extends BaseClass {
       // Setup with loading spinner
       const [totalCount] = await this.withLoadingSpinner('EXTENSIONS: Analyzing extensions...', async () => {
         this.extensionsFolderPath = pResolve(
-          this.exportConfig.exportDir,
-          this.exportConfig.branchName || '',
+          getExportBasePath(this.exportConfig),
           this.extensionConfig.dirName,
         );
         await fsUtil.makeDirectory(this.extensionsFolderPath);

packages/contentstack-export/src/export/modules/global-fields.ts

@@ -3,7 +3,7 @@ import { ContentstackClient, handleAndLogError, messageHandler, log, sanitizePat
 
 import BaseClass from './base-class';
 import { ExportConfig, ModuleClassParams } from '../../types';
-import { fsUtil, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class GlobalFieldsExport extends BaseClass {
   private stackAPIClient: ReturnType<ContentstackClient['stack']>;
@@ -38,8 +38,7 @@ export default class GlobalFieldsExport extends BaseClass {
       include_global_field_schema: true,
     };
     this.globalFieldsDirPath = path.resolve(
-      sanitizePath(exportConfig.exportDir),
-      sanitizePath(exportConfig.branchName || ''),
+      sanitizePath(getExportBasePath(exportConfig)),
       sanitizePath(this.globalFieldsConfig.dirName),
     );
     this.globalFields = [];

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

@@ -5,7 +5,7 @@ import { handleAndLogError, messageHandler, log } from '@contentstack/cli-utilit
 
 import BaseClass from './base-class';
 import { LabelConfig, ModuleClassParams } from '../../types';
-import { fsUtil, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class ExportLabels extends BaseClass {
   private labels: Record<string, Record<string, string>>;
@@ -32,8 +32,7 @@ export default class ExportLabels extends BaseClass {
       // Setup with loading spinner
       const [totalCount] = await this.withLoadingSpinner('LABELS: Analyzing labels...', async () => {
         this.labelsFolderPath = pResolve(
-          this.exportConfig.exportDir,
-          this.exportConfig.branchName || '',
+          getExportBasePath(this.exportConfig),
           this.labelConfig.dirName,
         );
 

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

@@ -3,7 +3,7 @@ import { ContentstackClient, handleAndLogError, messageHandler, log, sanitizePat
 
 import BaseClass from './base-class';
 import { ExportConfig, ModuleClassParams } from '../../types';
-import { fsUtil, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class LocaleExport extends BaseClass {
   private stackAPIClient: ReturnType<ContentstackClient['stack']>;
@@ -42,8 +42,7 @@ export default class LocaleExport extends BaseClass {
       },
     };
     this.localesPath = path.resolve(
-      sanitizePath(exportConfig.exportDir),
-      sanitizePath(exportConfig.branchName || ''),
+      sanitizePath(getExportBasePath(exportConfig)),
       sanitizePath(this.localeConfig.dirName),
     );
     this.locales = {};

packages/contentstack-export/src/export/modules/marketplace-apps.ts

@@ -20,6 +20,7 @@ import {
 import BaseClass from './base-class';
 import {
   fsUtil,
+  getExportBasePath,
   getOrgUid,
   createNodeCryptoInstance,
   getDeveloperHubUrl,
@@ -118,8 +119,7 @@ export default class ExportMarketplaceApps extends BaseClass {
 
   async setupPaths(): Promise<void> {
     this.marketplaceAppPath = pResolve(
-      this.exportConfig.exportDir,
-      this.exportConfig.branchName || '',
+      getExportBasePath(this.exportConfig),
       this.marketplaceAppConfig.dirName,
     );
     log.debug(`Marketplace apps folder path: '${this.marketplaceAppPath}'`, this.exportConfig.context);

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

@@ -11,6 +11,7 @@ import { PATH_CONSTANTS } from '../../constants';
 import BaseClass from './base-class';
 import {
   fsUtil,
+  getExportBasePath,
   PROCESS_NAMES,
   MODULE_CONTEXTS,
   PROCESS_STATUS,
@@ -31,8 +32,7 @@ export default class ExportStack extends BaseClass {
     this.stackConfig = exportConfig.modules.stack;
     this.qs = { include_count: true };
     this.stackFolderPath = pResolve(
-      this.exportConfig.exportDir,
-      this.exportConfig.branchName || '',
+      getExportBasePath(this.exportConfig),
       this.stackConfig.dirName,
     );
     this.exportConfig.context.module = MODULE_CONTEXTS.STACK;

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

@@ -7,6 +7,7 @@ import { handleAndLogError, messageHandler, log, sanitizePath } from '@contentst
 import BaseClass from './base-class';
 import {
   fsUtil,
+  getExportBasePath,
   PROCESS_NAMES,
   MODULE_CONTEXTS,
   PROCESS_STATUS,
@@ -43,8 +44,7 @@ export default class ExportTaxonomies extends BaseClass {
     this.exportConfig.context.module = MODULE_CONTEXTS.TAXONOMIES;
     this.currentModuleName = MODULE_NAMES[MODULE_CONTEXTS.TAXONOMIES];
     this.localesFilePath = pResolve(
-      sanitizePath(exportConfig.exportDir),
-      sanitizePath(exportConfig.branchName || ''),
+      sanitizePath(getExportBasePath(exportConfig)),
       sanitizePath(exportConfig.modules.locales.dirName),
       sanitizePath(exportConfig.modules.locales.fileName),
     );
@@ -98,8 +98,7 @@ export default class ExportTaxonomies extends BaseClass {
   private async initializeExport(): Promise<number> {
     return this.withLoadingSpinner('TAXONOMIES: Analyzing taxonomy structure...', async () => {
       this.taxonomiesFolderPath = pResolve(
-        this.exportConfig.exportDir,
-        this.exportConfig.branchName || '',
+        getExportBasePath(this.exportConfig),
         this.taxonomiesConfig.dirName,
       );
       log.debug(`Taxonomies folder path: '${this.taxonomiesFolderPath}'`, this.exportConfig.context);

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

@@ -5,7 +5,7 @@ import { handleAndLogError, messageHandler, log } from '@contentstack/cli-utilit
 
 import BaseClass from './base-class';
 import { WebhookConfig, ModuleClassParams } from '../../types';
-import { fsUtil, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class ExportWebhooks extends BaseClass {
   private webhooks: Record<string, Record<string, string>>;
@@ -33,8 +33,7 @@ export default class ExportWebhooks extends BaseClass {
       // Setup with loading spinner
       const [totalCount] = await this.withLoadingSpinner('WEBHOOKS: Analyzing webhooks...', async () => {
         this.webhooksFolderPath = pResolve(
-          this.exportConfig.exportDir,
-          this.exportConfig.branchName || '',
+          getExportBasePath(this.exportConfig),
           this.webhookConfig.dirName,
         );
 

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

@@ -5,7 +5,7 @@ import { handleAndLogError, messageHandler, log } from '@contentstack/cli-utilit
 
 import BaseClass from './base-class';
 import { WorkflowConfig, ModuleClassParams } from '../../types';
-import { fsUtil, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
+import { fsUtil, getExportBasePath, MODULE_CONTEXTS, MODULE_NAMES } from '../../utils';
 
 export default class ExportWorkFlows extends BaseClass {
   private workflows: Record<string, Record<string, string>>;
@@ -32,8 +32,7 @@ export default class ExportWorkFlows extends BaseClass {
       // Setup with loading spinner
       const [totalCount] = await this.withLoadingSpinner('WORKFLOWS: Analyzing workflows...', async () => {
         this.webhooksFolderPath = pResolve(
-          this.exportConfig.exportDir,
-          this.exportConfig.branchName || '',
+          getExportBasePath(this.exportConfig),
           this.workflowConfig.dirName,
         );