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

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Contentstack
+Copyright (c) 2026 Contentstack
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -47,7 +47,7 @@ $ npm install -g @contentstack/cli-cm-import
 $ csdx COMMAND
 running command...
 $ csdx (--version)
-@contentstack/cli-cm-import/2.0.0-beta.1 linux-x64 node-v22.20.0
+@contentstack/cli-cm-import/2.0.0-beta.11 linux-x64 node-v22.22.0
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND
@@ -58,127 +58,81 @@ USAGE
 # Commands
 
 <!-- commands -->
-* [`csdx cm:stacks:import [-c <value>] [-k <value>] [-d <value>] [-a <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]`](#csdx-cmstacksimport--c-value--k-value--d-value--a-value---module-value---backup-dir-value---branch-value---import-webhook-status-disablecurrent)
-* [`csdx cm:stacks:import [-c <value>] [-k <value>] [-d <value>] [-a <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]`](#csdx-cmstacksimport--c-value--k-value--d-value--a-value---module-value---backup-dir-value---branch-value---import-webhook-status-disablecurrent)
+* [`csdx cm:stacks:import [--config <value>] [--stack-api-key <value>] [--data-dir <value>] [--alias <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]`](#csdx-cmstacksimport---config-value---stack-api-key-value---data-dir-value---alias-value---module-value---backup-dir-value---branch-value---import-webhook-status-disablecurrent)
 
-## `csdx cm:stacks:import [-c <value>] [-k <value>] [-d <value>] [-a <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]`
+## `csdx cm:stacks:import [--config <value>] [--stack-api-key <value>] [--data-dir <value>] [--alias <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]`
 
 Import content from a stack
 
 ```
 USAGE
-  $ csdx cm:import cm:stacks:import [-c <value>] [-k <value>] [-d <value>] [-a <value>] [--module <value>]
-    [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]
+  $ csdx cm:stacks:import [--config <value>] [--stack-api-key <value>] [--data-dir <value>] [--alias <value>]
+    [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]
 
 FLAGS
-  -B, --branch=<value>                    The name of the branch where you want to import your content. If you don't
-                                          mention the branch name, then by default the content will be imported to the
-                                          main branch.
-  -a, --alias=<value>                     The management token of the destination stack where you will import the
-                                          content.
-  -b, --backup-dir=<value>                [optional] Backup directory name when using specific module.
-  -c, --config=<value>                    [optional] The path of the configuration JSON file containing all the options
-                                          for a single run.
-  -d, --data-dir=<value>                  The path or the location in your file system where the content, you intend to
-                                          import, is stored. For example, -d "C:\Users\Name\Desktop\cli\content". If the
-                                          export folder has branches involved, then the path should point till the
-                                          particular branch. For example, “-d
-                                          "C:\Users\Name\Desktop\cli\content\branch_name"
-  -k, --stack-api-key=<value>             API Key of the target stack
-  -m, --module=<value>                    [optional] Specify the module to import into the target stack. If not
-                                          specified, the import command will import all the modules into the stack. The
-                                          available modules are assets, content-types, entries, environments,
-                                          extensions, marketplace-apps, global-fields, labels, locales, webhooks,
-                                          workflows, custom-roles, personalize projects, and taxonomies.
-  -y, --yes                               [optional] Force override all Marketplace prompts.
-      --branch-alias=<value>              Specify the branch alias where you want to import your content. If not
-                                          specified, the content is imported into the main branch by default.
-      --exclude-global-modules            Excludes the branch-independent module from the import operation.
-      --import-webhook-status=<option>    [default: disable] [default: disable] (optional) This webhook state keeps the
-                                          same state of webhooks as the source stack. <options: disable|current>
-                                          <options: disable|current>
-      --personalize-project-name=<value>  (optional) Provide a unique name for the Personalize project.
-      --replace-existing                  Replaces the existing module in the target stack.
-      --skip-app-recreation               (optional) Skips the recreation of private apps if they already exist.
-      --skip-assets-publish               Skips asset publishing during the import process.
-      --skip-audit                        Skips the audit fix that occurs during an import operation.
-      --skip-entries-publish              Skips entry publishing during the import process
-      --skip-existing                     Skips the module exists warning messages.
+  -a, --alias=<value>
+      The management token of the destination stack where you will import the content.
 
-DESCRIPTION
-  Import content from a stack
+  -c, --config=<value>
+      [optional] The path of the configuration JSON file containing all the options for a single run.
 
-ALIASES
-  $ csdx cm:import
+  -d, --data-dir=<value>
+      The path or the location in your file system where the content, you intend to import, is stored. For example, -d
+      "C:\Users\Name\Desktop\cli\content". If the export folder has branches involved, then the path should point till the
+      particular branch. For example, “-d "C:\Users\Name\Desktop\cli\content\branch_name"
 
-EXAMPLES
-  $ csdx cm:stacks:import --stack-api-key <stack_api_key> --data-dir <path/of/export/destination/dir>
+  -k, --stack-api-key=<value>
+      API Key of the target stack
 
-  $ csdx cm:stacks:import --config <path/of/config/dir>
+  -y, --yes
+      [optional] Force override all Marketplace prompts.
 
-  $ csdx cm:stacks:import --module <single module name>
+  --backup-dir=<value>
+      [optional] Backup directory name when using specific module.
 
-  $ csdx cm:stacks:import --module <single module name> --backup-dir <backup dir>
+  --branch=<value>
+      The name of the branch where you want to import your content. If you don't mention the branch name, then by default
+      the content will be imported to the main branch.
 
-  $ csdx cm:stacks:import --alias <management_token_alias>
+  --branch-alias=<value>
+      Specify the branch alias where you want to import your content. If not specified, the content is imported into the
+      main branch by default.
 
-  $ csdx cm:stacks:import --alias <management_token_alias> --data-dir <path/of/export/destination/dir>
+  --exclude-global-modules
+      Excludes the branch-independent module from the import operation.
 
-  $ csdx cm:stacks:import --alias <management_token_alias> --config <path/of/config/file>
+  --import-webhook-status=<option>
+      [default: disable] [default: disable] (optional) This webhook state keeps the same state of webhooks as the source
+      stack. <options: disable|current>
+      <options: disable|current>
 
-  $ csdx cm:stacks:import --branch <branch name>  --yes --skip-audit
-```
+  --module=<value>
+      [optional] Specify the module to import into the target stack. If not specified, the import command will import all
+      the modules into the stack. The available modules are assets, content-types, entries, environments, extensions,
+      marketplace-apps, global-fields, labels, locales, webhooks, workflows, custom-roles, personalize projects,
+      taxonomies, and composable-studio.
 
-## `csdx cm:stacks:import [-c <value>] [-k <value>] [-d <value>] [-a <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]`
+  --personalize-project-name=<value>
+      (optional) Provide a unique name for the Personalize project.
 
-Import content from a stack
+  --replace-existing
+      Replaces the existing module in the target stack.
 
-```
-USAGE
-  $ csdx cm:stacks:import [-c <value>] [-k <value>] [-d <value>] [-a <value>] [--module <value>] [--backup-dir
-    <value>] [--branch <value>] [--import-webhook-status disable|current]
+  --skip-assets-publish
+      Skips asset publishing during the import process.
 
-FLAGS
-  -B, --branch=<value>                    The name of the branch where you want to import your content. If you don't
-                                          mention the branch name, then by default the content will be imported to the
-                                          main branch.
-  -a, --alias=<value>                     The management token of the destination stack where you will import the
-                                          content.
-  -b, --backup-dir=<value>                [optional] Backup directory name when using specific module.
-  -c, --config=<value>                    [optional] The path of the configuration JSON file containing all the options
-                                          for a single run.
-  -d, --data-dir=<value>                  The path or the location in your file system where the content, you intend to
-                                          import, is stored. For example, -d "C:\Users\Name\Desktop\cli\content". If the
-                                          export folder has branches involved, then the path should point till the
-                                          particular branch. For example, “-d
-                                          "C:\Users\Name\Desktop\cli\content\branch_name"
-  -k, --stack-api-key=<value>             API Key of the target stack
-  -m, --module=<value>                    [optional] Specify the module to import into the target stack. If not
-                                          specified, the import command will import all the modules into the stack. The
-                                          available modules are assets, content-types, entries, environments,
-                                          extensions, marketplace-apps, global-fields, labels, locales, webhooks,
-                                          workflows, custom-roles, personalize projects, and taxonomies.
-  -y, --yes                               [optional] Force override all Marketplace prompts.
-      --branch-alias=<value>              Specify the branch alias where you want to import your content. If not
-                                          specified, the content is imported into the main branch by default.
-      --exclude-global-modules            Excludes the branch-independent module from the import operation.
-      --import-webhook-status=<option>    [default: disable] [default: disable] (optional) This webhook state keeps the
-                                          same state of webhooks as the source stack. <options: disable|current>
-                                          <options: disable|current>
-      --personalize-project-name=<value>  (optional) Provide a unique name for the Personalize project.
-      --replace-existing                  Replaces the existing module in the target stack.
-      --skip-app-recreation               (optional) Skips the recreation of private apps if they already exist.
-      --skip-assets-publish               Skips asset publishing during the import process.
-      --skip-audit                        Skips the audit fix that occurs during an import operation.
-      --skip-entries-publish              Skips entry publishing during the import process
-      --skip-existing                     Skips the module exists warning messages.
+  --skip-audit
+      Skips the audit fix that occurs during an import operation.
+
+  --skip-entries-publish
+      Skips entry publishing during the import process
+
+  --skip-existing
+      Skips the module exists warning messages.
 
 DESCRIPTION
   Import content from a stack
 
-ALIASES
-  $ csdx cm:import
-
 EXAMPLES
   $ csdx cm:stacks:import --stack-api-key <stack_api_key> --data-dir <path/of/export/destination/dir>
 

package/lib/commands/cm/stacks/import.d.ts

@@ -4,7 +4,6 @@ export default class ImportCommand extends Command {
     static description: string;
     static examples: string[];
     static flags: FlagInput;
-    static aliases: string[];
     static usage: string;
     run(): Promise<void>;
     private logAndPrintErrorDetails;

package/lib/commands/cm/stacks/import.js

@@ -6,6 +6,7 @@ const import_1 = require("../../../import");
 const utils_1 = require("../../../utils");
 class ImportCommand extends cli_command_1.Command {
     async run() {
+        var _a, _b;
         // setup import config
         // initialize the importer
         // start import
@@ -15,6 +16,7 @@ class ImportCommand extends cli_command_1.Command {
             const { flags } = await this.parse(ImportCommand);
             importConfig = await (0, utils_1.setupImportConfig)(flags);
             // Prepare the context object
+            (0, cli_utilities_1.createLogContext)(((_b = (_a = this.context) === null || _a === void 0 ? void 0 : _a.info) === null || _b === void 0 ? void 0 : _b.command) || 'cm:stacks:export', importConfig.apiKey, importConfig.authenticationMethod);
             const context = this.createImportContext(importConfig.apiKey, importConfig.authenticationMethod);
             importConfig.context = Object.assign({}, context);
             //log.info(`Using Cli Version: ${this.context?.cliVersion}`, importConfig.context);
@@ -25,6 +27,8 @@ class ImportCommand extends cli_command_1.Command {
                 importConfig.developerHubBaseUrl = this.developerHubUrl;
             if (this.personalizeUrl)
                 importConfig.modules.personalize.baseURL[importConfig.region.name] = this.personalizeUrl;
+            if (this.composableStudioUrl)
+                importConfig.modules['composable-studio'].apiBaseUrl = this.composableStudioUrl;
             const managementAPIClient = await (0, cli_utilities_1.managementSDKClient)(importConfig);
             if (flags.branch) {
                 cli_utilities_1.CLIProgressManager.initializeGlobalSummary(`IMPORT-${flags.branch}`, flags.branch, `Importing content into "${flags.branch}" branch...`);
@@ -35,12 +39,7 @@ class ImportCommand extends cli_command_1.Command {
             const moduleImporter = new import_1.ModuleImporter(managementAPIClient, importConfig);
             const result = await moduleImporter.start();
             backupDir = importConfig.backupDir;
-            if (!(result === null || result === void 0 ? void 0 : result.noSuccessMsg)) {
-                const successMessage = importConfig.stackName
-                    ? `Successfully imported the content to the stack named ${importConfig.stackName} with the API key ${importConfig.apiKey} .`
-                    : `The content has been imported to the stack ${importConfig.apiKey} successfully!`;
-                cli_utilities_1.log.success(successMessage, importConfig.context);
-            }
+            //Note: Final summary is now handled by summary manager
             cli_utilities_1.CLIProgressManager.printGlobalSummary();
             this.logSuccessAndBackupMessages(backupDir, importConfig);
             // Clear progress module setting now that import is complete
@@ -56,8 +55,8 @@ class ImportCommand extends cli_command_1.Command {
     logAndPrintErrorDetails(error, importConfig) {
         var _a;
         cli_utilities_1.cliux.print('\n');
-        const logPath = (0, cli_utilities_1.getLogPath)();
-        const logMsg = `The log has been stored at '${logPath}'`;
+        const sessionLogPath = (0, cli_utilities_1.getSessionLogPath)();
+        const logMsg = `The log has been stored at '${sessionLogPath}'`;
         const backupDir = importConfig === null || importConfig === void 0 ? void 0 : importConfig.backupDir;
         const backupDirMsg = backupDir
             ? `The backup content has been stored at '${backupDir}'`
@@ -74,8 +73,8 @@ class ImportCommand extends cli_command_1.Command {
     logSuccessAndBackupMessages(backupDir, importConfig) {
         var _a;
         cli_utilities_1.cliux.print('\n');
-        const logPath = (0, cli_utilities_1.getLogPath)();
-        const logMsg = `The log has been stored at '${logPath}'`;
+        const sessionLogPath = (0, cli_utilities_1.getSessionLogPath)();
+        const logMsg = `The log has been stored at '${sessionLogPath}'`;
         const backupDirMsg = `The backup content has been stored at '${backupDir}'`;
         cli_utilities_1.log.success(logMsg, importConfig.context);
         cli_utilities_1.log.info(backupDirMsg, importConfig.context);
@@ -92,6 +91,7 @@ class ImportCommand extends cli_command_1.Command {
             command: ((_b = (_a = this.context) === null || _a === void 0 ? void 0 : _a.info) === null || _b === void 0 ? void 0 : _b.command) || 'cm:stacks:import',
             module: '',
             userId: cli_utilities_1.configHandler.get('userUid') || '',
+            email: cli_utilities_1.configHandler.get('email') || '',
             sessionId: (_c = this.context) === null || _c === void 0 ? void 0 : _c.sessionId,
             apiKey: apiKey || '',
             orgId: cli_utilities_1.configHandler.get('oauthOrgUid') || '',
@@ -116,21 +116,10 @@ ImportCommand.flags = {
         char: 'c',
         description: '[optional] The path of the configuration JSON file containing all the options for a single run.',
     }),
-    'stack-uid': cli_utilities_1.flags.string({
-        char: 's',
-        description: 'API key of the target stack.',
-        hidden: true,
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['-s', '--stack-uid'], ['-k', '--stack-api-key']),
-    }),
     'stack-api-key': cli_utilities_1.flags.string({
         char: 'k',
         description: 'API Key of the target stack',
     }),
-    data: cli_utilities_1.flags.string({
-        description: 'path and location where data is stored',
-        hidden: true,
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['--data'], ['--data-dir']),
-    }),
     'data-dir': cli_utilities_1.flags.string({
         char: 'd',
         description: `The path or the location in your file system where the content, you intend to import, is stored. For example, -d "C:\\Users\\Name\\Desktop\\cli\\content". If the export folder has branches involved, then the path should point till the particular branch. For example, “-d "C:\\Users\\Name\\Desktop\\cli\\content\\branch_name"`,
@@ -139,36 +128,19 @@ ImportCommand.flags = {
         char: 'a',
         description: 'The management token of the destination stack where you will import the content.',
     }),
-    'management-token-alias': cli_utilities_1.flags.string({
-        description: 'alias of the management token',
-        hidden: true,
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['--management-token-alias'], ['-a', '--alias']),
-    }),
-    'auth-token': cli_utilities_1.flags.boolean({
-        char: 'A',
-        description: 'to use auth token',
-        hidden: true,
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['-A', '--auth-token']),
-    }),
     module: cli_utilities_1.flags.string({
         required: false,
-        char: 'm',
-        description: '[optional] Specify the module to import into the target stack. If not specified, the import command will import all the modules into the stack. The available modules are assets, content-types, entries, environments, extensions, marketplace-apps, global-fields, labels, locales, webhooks, workflows, custom-roles, personalize projects, and taxonomies.',
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['-m'], ['--module']),
+        description: '[optional] Specify the module to import into the target stack. If not specified, the import command will import all the modules into the stack. The available modules are assets, content-types, entries, environments, extensions, marketplace-apps, global-fields, labels, locales, webhooks, workflows, custom-roles, personalize projects, taxonomies, and composable-studio.',
     }),
     'backup-dir': cli_utilities_1.flags.string({
-        char: 'b',
         description: '[optional] Backup directory name when using specific module.',
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['-b'], ['--backup-dir']),
     }),
     branch: cli_utilities_1.flags.string({
-        char: 'B',
         description: "The name of the branch where you want to import your content. If you don't mention the branch name, then by default the content will be imported to the main branch.",
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['-B'], ['--branch']),
         exclusive: ['branch-alias'],
     }),
     'branch-alias': cli_utilities_1.flags.string({
-        description: "Specify the branch alias where you want to import your content. If not specified, the content is imported into the main branch by default.",
+        description: 'Specify the branch alias where you want to import your content. If not specified, the content is imported into the main branch by default.',
         exclusive: ['branch'],
     }),
     'import-webhook-status': cli_utilities_1.flags.string({
@@ -182,10 +154,6 @@ ImportCommand.flags = {
         required: false,
         description: '[optional] Force override all Marketplace prompts.',
     }),
-    'skip-app-recreation': cli_utilities_1.flags.boolean({
-        description: '(optional) Skips the recreation of private apps if they already exist.',
-        parse: (0, cli_utilities_1.printFlagDeprecation)(['--skip-app-recreation']),
-    }),
     'replace-existing': cli_utilities_1.flags.boolean({
         required: false,
         description: 'Replaces the existing module in the target stack.',
@@ -215,5 +183,4 @@ ImportCommand.flags = {
         default: false,
     }),
 };
-ImportCommand.aliases = ['cm:import'];
-ImportCommand.usage = 'cm:stacks:import [-c <value>] [-k <value>] [-d <value>] [-a <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]';
+ImportCommand.usage = 'cm:stacks:import [--config <value>] [--stack-api-key <value>] [--data-dir <value>] [--alias <value>] [--module <value>] [--backup-dir <value>] [--branch <value>] [--import-webhook-status disable|current]';

package/lib/config/index.js

@@ -33,6 +33,7 @@ const config = {
             'stack',
             'assets',
             'taxonomies',
+            'composable-studio',
             'extensions',
             'marketplace-apps',
             'global-fields',
@@ -199,6 +200,12 @@ const config = {
                 locale: 'en-us',
             },
         },
+        'composable-studio': {
+            dirName: 'composable_studio',
+            fileName: 'composable_studio.json',
+            apiBaseUrl: 'https://composable-studio-api.contentstack.com',
+            apiVersion: 'v1',
+        },
     },
     languagesCode: [
         'af-za',

package/lib/constants/index.d.ts

@@ -0,0 +1,57 @@
+export declare const PATH_CONSTANTS: {
+    /** Root mapper directory (contains module-specific mapper subdirs) */
+    readonly MAPPER: "mapper";
+    /** Common mapper file names */
+    readonly FILES: {
+        readonly SUCCESS: "success.json";
+        readonly FAILS: "fails.json";
+        readonly UID_MAPPING: "uid-mapping.json";
+        readonly URL_MAPPING: "url-mapping.json";
+        readonly UID_MAPPER: "uid-mapper.json";
+        readonly SCHEMA: "schema.json";
+        readonly SETTINGS: "settings.json";
+        readonly MODIFIED_SCHEMAS: "modified-schemas.json";
+        readonly UNIQUE_MAPPING: "unique-mapping.json";
+        readonly TAXONOMIES: "taxonomies.json";
+        readonly ENVIRONMENTS: "environments.json";
+        readonly PENDING_EXTENSIONS: "pending_extensions.js";
+        readonly PENDING_GLOBAL_FIELDS: "pending_global_fields.js";
+        readonly INDEX: "index.json";
+        readonly FOLDER_MAPPING: "folder-mapping.json";
+        readonly VERSIONED_ASSETS: "versioned-assets.json";
+    };
+    /** Module subdirectory names within mapper */
+    readonly MAPPER_MODULES: {
+        readonly ASSETS: "assets";
+        readonly ENTRIES: "entries";
+        readonly CONTENT_TYPES: "content_types";
+        readonly TAXONOMIES: "taxonomies";
+        readonly TAXONOMY_TERMS: "terms";
+        readonly GLOBAL_FIELDS: "global_fields";
+        readonly EXTENSIONS: "extensions";
+        readonly WORKFLOWS: "workflows";
+        readonly WEBHOOKS: "webhooks";
+        readonly LABELS: "labels";
+        readonly ENVIRONMENTS: "environments";
+        readonly MARKETPLACE_APPS: "marketplace_apps";
+        readonly CUSTOM_ROLES: "custom-roles";
+        readonly LANGUAGES: "languages";
+    };
+    /** Content directory names (used in both import and export) */
+    readonly CONTENT_DIRS: {
+        readonly ASSETS: "assets";
+        readonly ENTRIES: "entries";
+        readonly CONTENT_TYPES: "content_types";
+        readonly TAXONOMIES: "taxonomies";
+        readonly GLOBAL_FIELDS: "global_fields";
+        readonly EXTENSIONS: "extensions";
+        readonly WEBHOOKS: "webhooks";
+        readonly WORKFLOWS: "workflows";
+        readonly LABELS: "labels";
+        readonly ENVIRONMENTS: "environments";
+        readonly STACK: "stack";
+        readonly LOCALES: "locales";
+        readonly MARKETPLACE_APPS: "marketplace_apps";
+    };
+};
+export type PathConstants = typeof PATH_CONSTANTS;

package/lib/constants/index.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATH_CONSTANTS = void 0;
+exports.PATH_CONSTANTS = {
+    /** Root mapper directory (contains module-specific mapper subdirs) */
+    MAPPER: 'mapper',
+    /** Common mapper file names */
+    FILES: {
+        SUCCESS: 'success.json',
+        FAILS: 'fails.json',
+        UID_MAPPING: 'uid-mapping.json',
+        URL_MAPPING: 'url-mapping.json',
+        UID_MAPPER: 'uid-mapper.json',
+        SCHEMA: 'schema.json',
+        SETTINGS: 'settings.json',
+        MODIFIED_SCHEMAS: 'modified-schemas.json',
+        UNIQUE_MAPPING: 'unique-mapping.json',
+        TAXONOMIES: 'taxonomies.json',
+        ENVIRONMENTS: 'environments.json',
+        PENDING_EXTENSIONS: 'pending_extensions.js',
+        PENDING_GLOBAL_FIELDS: 'pending_global_fields.js',
+        INDEX: 'index.json',
+        FOLDER_MAPPING: 'folder-mapping.json',
+        VERSIONED_ASSETS: 'versioned-assets.json',
+    },
+    /** Module subdirectory names within mapper */
+    MAPPER_MODULES: {
+        ASSETS: 'assets',
+        ENTRIES: 'entries',
+        CONTENT_TYPES: 'content_types',
+        TAXONOMIES: 'taxonomies',
+        TAXONOMY_TERMS: 'terms',
+        GLOBAL_FIELDS: 'global_fields',
+        EXTENSIONS: 'extensions',
+        WORKFLOWS: 'workflows',
+        WEBHOOKS: 'webhooks',
+        LABELS: 'labels',
+        ENVIRONMENTS: 'environments',
+        MARKETPLACE_APPS: 'marketplace_apps',
+        CUSTOM_ROLES: 'custom-roles',
+        LANGUAGES: 'languages',
+    },
+    /** Content directory names (used in both import and export) */
+    CONTENT_DIRS: {
+        ASSETS: 'assets',
+        ENTRIES: 'entries',
+        CONTENT_TYPES: 'content_types',
+        TAXONOMIES: 'taxonomies',
+        GLOBAL_FIELDS: 'global_fields',
+        EXTENSIONS: 'extensions',
+        WEBHOOKS: 'webhooks',
+        WORKFLOWS: 'workflows',
+        LABELS: 'labels',
+        ENVIRONMENTS: 'environments',
+        STACK: 'stack',
+        LOCALES: 'locales',
+        MARKETPLACE_APPS: 'marketplace_apps',
+    },
+};

package/lib/import/module-importer.js

@@ -37,8 +37,6 @@ class ModuleImporter {
         const backupDir = await (0, utils_1.backupHandler)(this.importConfig);
         if (backupDir) {
             this.importConfig.backupDir = backupDir;
-            // To support the old config
-            this.importConfig.data = backupDir;
         }
         // NOTE audit and fix the import content.
         if (!this.importConfig.skipAudit &&
@@ -47,6 +45,10 @@ class ModuleImporter {
             if (!(await this.auditImportData())) {
                 return { noSuccessMsg: true };
             }
+            // Audit overwrote the global summary with 'AUDIT'. Re-initialize for IMPORT so the final
+            // summary shows "IMPORT completed successfully!" and only import module stats.
+            const branchName = this.importConfig.branchName || '';
+            cli_utilities_1.CLIProgressManager.initializeGlobalSummary(branchName ? `IMPORT-${branchName}` : 'IMPORT', branchName, 'Importing content...');
         }
         if (!this.importConfig.master_locale) {
             let masterLocalResponse = await (0, utils_1.masterLocalDetails)(this.stackAPIClient);
@@ -66,8 +68,6 @@ class ModuleImporter {
     }
     async importByModuleByName(moduleName) {
         cli_utilities_1.log.info(`Starting import of ${moduleName} module`, this.importConfig.context);
-        // import the modules by name
-        // calls the module runner which inturn calls the module itself
         return (0, modules_1.default)({
             stackAPIClient: this.stackAPIClient,
             importConfig: this.importConfig,

package/lib/import/modules/assets.js

@@ -13,6 +13,7 @@ const includes_1 = tslib_1.__importDefault(require("lodash/includes"));
 const uuid_1 = require("uuid");
 const node_path_1 = require("node:path");
 const cli_utilities_1 = require("@contentstack/cli-utilities");
+const constants_1 = require("../../constants");
 const config_1 = tslib_1.__importDefault(require("../../config"));
 const utils_1 = require("../../utils");
 const base_class_1 = tslib_1.__importDefault(require("./base-class"));
@@ -26,14 +27,14 @@ class ImportAssets extends base_class_1.default {
         this.assetsFolderMap = {};
         this.importConfig.context.module = utils_1.MODULE_CONTEXTS.ASSETS;
         this.currentModuleName = utils_1.MODULE_NAMES[utils_1.MODULE_CONTEXTS.ASSETS];
-        this.assetsPath = (0, node_path_1.join)(this.importConfig.backupDir, 'assets');
-        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, 'mapper', 'assets');
-        this.assetUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, 'uid-mapping.json');
-        this.assetUrlMapperPath = (0, node_path_1.join)(this.mapperDirPath, 'url-mapping.json');
-        this.assetFolderUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, 'folder-mapping.json');
+        this.assetsPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.CONTENT_DIRS.ASSETS);
+        this.mapperDirPath = (0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.MAPPER, constants_1.PATH_CONSTANTS.MAPPER_MODULES.ASSETS);
+        this.assetUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.UID_MAPPING);
+        this.assetUrlMapperPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.URL_MAPPING);
+        this.assetFolderUidMapperPath = (0, node_path_1.join)(this.mapperDirPath, constants_1.PATH_CONSTANTS.FILES.FOLDER_MAPPING);
         this.assetsRootPath = (0, node_path_1.join)(this.importConfig.backupDir, this.assetConfig.dirName);
         this.fs = new cli_utilities_1.FsUtility({ basePath: this.mapperDirPath });
-        this.environments = this.fs.readFile((0, node_path_1.join)(this.importConfig.backupDir, 'environments', 'environments.json'), true);
+        this.environments = this.fs.readFile((0, node_path_1.join)(this.importConfig.backupDir, constants_1.PATH_CONSTANTS.CONTENT_DIRS.ENVIRONMENTS, constants_1.PATH_CONSTANTS.FILES.ENVIRONMENTS), true);
     }
     /**
      * @method start
@@ -141,7 +142,9 @@ class ImportAssets extends base_class_1.default {
      */
     async importAssets(isVersion = false) {
         const processName = isVersion ? 'import versioned assets' : 'import assets';
-        const indexFileName = isVersion ? 'versioned-assets.json' : 'assets.json';
+        const indexFileName = isVersion
+            ? constants_1.PATH_CONSTANTS.FILES.VERSIONED_ASSETS
+            : this.assetConfig.fileName;
         const basePath = isVersion ? (0, node_path_1.join)(this.assetsPath, 'versions') : this.assetsPath;
         const progressProcessName = isVersion ? utils_1.PROCESS_NAMES.ASSET_VERSIONS : utils_1.PROCESS_NAMES.ASSET_UPLOAD;
         cli_utilities_1.log.debug(`Importing ${processName} from ${basePath}`, this.importConfig.context);
@@ -259,7 +262,10 @@ class ImportAssets extends base_class_1.default {
      * @returns {Promise<void>} Promise<void>
      */
     async publish() {
-        const fs = new cli_utilities_1.FsUtility({ basePath: this.assetsPath, indexFileName: 'assets.json' });
+        const fs = new cli_utilities_1.FsUtility({
+            basePath: this.assetsPath,
+            indexFileName: this.assetConfig.fileName,
+        });
         if ((0, isEmpty_1.default)(this.assetsUidMap)) {
             cli_utilities_1.log.debug('Loading asset UID mappings from file', this.importConfig.context);
             this.assetsUidMap = fs.readFile(this.assetUidMapperPath, true);
@@ -416,7 +422,10 @@ class ImportAssets extends base_class_1.default {
         return count;
     }
     async countPublishableAssets() {
-        const fsUtil = new cli_utilities_1.FsUtility({ basePath: this.assetsPath, indexFileName: 'assets.json' });
+        const fsUtil = new cli_utilities_1.FsUtility({
+            basePath: this.assetsPath,
+            indexFileName: this.assetConfig.fileName,
+        });
         let count = 0;
         for (const _ of (0, values_1.default)(fsUtil.indexFileContent)) {
             const chunkData = await fsUtil.readChunkFiles.next().catch(() => ({}));

package/lib/import/modules/base-class.d.ts

@@ -1,15 +1,21 @@
-import { Stack } from '@contentstack/management/types/stack';
-import { CLIProgressManager } from '@contentstack/cli-utilities';
+import { ManagementStack, CLIProgressManager } from '@contentstack/cli-utilities';
 import { ImportConfig, ModuleClassParams } from '../../types';
 export type AdditionalKeys = {
     backupDir: string;
 };
+export type CompleteProgressOptions = {
+    moduleName?: string;
+    customSuccessMessage?: string;
+    customWarningMessage?: string;
+    context?: Record<string, any>;
+};
 export type ApiModuleType = 'create-assets' | 'replace-assets' | 'publish-assets' | 'create-assets-folder' | 'create-extensions' | 'update-extensions' | 'create-locale' | 'update-locale' | 'create-gfs' | 'create-cts' | 'update-cts' | 'update-gfs' | 'create-environments' | 'create-labels' | 'update-labels' | 'create-webhooks' | 'create-workflows' | 'create-custom-role' | 'create-entries' | 'update-entries' | 'publish-entries' | 'delete-entries' | 'create-taxonomies' | 'create-terms' | 'import-taxonomy';
 export type ApiOptions = {
     uid?: string;
     url?: string;
     entity: ApiModuleType;
     apiData?: Record<any, any> | any;
+    queryParam?: Record<any, any>;
     resolve: (value: any) => Promise<void> | void;
     reject: (error: any) => Promise<void> | void;
     additionalInfo?: Record<any, any>;
@@ -34,13 +40,13 @@ export type CustomPromiseHandlerInput = {
 };
 export type CustomPromiseHandler = (input: CustomPromiseHandlerInput) => Promise<any>;
 export default abstract class BaseClass {
-    readonly client: Stack;
+    readonly client: ManagementStack;
     importConfig: ImportConfig;
     modulesConfig: any;
     protected progressManager: CLIProgressManager | null;
     protected currentModuleName: string;
     constructor({ importConfig, stackAPIClient }: Omit<ModuleClassParams, 'moduleName'>);
-    get stack(): Stack;
+    get stack(): ManagementStack;
     static printFinalSummary(): void;
     /**
      * Create simple progress manager
@@ -54,6 +60,17 @@ export default abstract class BaseClass {
      * Complete progress manager
      */
     protected completeProgress(success?: boolean, error?: string): void;
+    /**
+     * Complete progress and log success/warning message based on errors
+     * Checks the progress manager's failure count to determine if errors occurred
+     * @param options - Options object containing:
+     *   - moduleName: The module name to generate the message (e.g., 'Content types', 'Entries')
+     *                 If not provided, uses this.currentModuleName
+     *   - customSuccessMessage: Optional custom success message. If not provided, generates: "{moduleName} have been imported successfully!"
+     *   - customWarningMessage: Optional custom warning message. If not provided, generates: "{moduleName} have been imported with some errors. Please check the logs at: {sessionLogPath}"
+     *   - context: Optional context for logging
+     */
+    protected completeProgressWithMessage(options?: CompleteProgressOptions): void;
     protected withLoadingSpinner<T>(message: string, action: () => Promise<T>): Promise<T>;
     /**
      * @method delay