@contentstack/cli-audit 1.16.2 → 2.0.0-beta

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Contentstack
+Copyright (c) 2024 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

@@ -19,7 +19,7 @@ $ npm install -g @contentstack/cli-audit
 $ csdx COMMAND
 running command...
 $ csdx (--version|-v)
-@contentstack/cli-audit/1.16.2 linux-x64 node-v22.21.1
+@contentstack/cli-audit/2.0.0-beta linux-x64 node-v22.21.1
 $ csdx --help [COMMAND]
 USAGE
   $ csdx COMMAND

package/lib/audit-base-command.d.ts

@@ -12,6 +12,10 @@ export declare abstract class AuditBaseCommand extends BaseCommand<typeof AuditB
             get: (row: any) => string;
         };
     };
+    /**
+     * Create audit context object similar to export command
+     */
+    private createAuditContext;
     /**
      * The `start` function performs an audit on content types, global fields, entries, and workflows and displays
      * any missing references.

package/lib/audit-base-command.js

@@ -33,6 +33,19 @@ class AuditBaseCommand extends base_command_1.BaseCommand {
             },
         };
     }
+    /**
+     * Create audit context object similar to export command
+     */
+    createAuditContext(moduleName) {
+        var _a, _b, _c;
+        return {
+            command: ((_b = (_a = this.context) === null || _a === void 0 ? void 0 : _a.info) === null || _b === void 0 ? void 0 : _b.command) || 'cm:stacks:audit',
+            module: moduleName || 'audit',
+            email: cli_utilities_1.configHandler.get('email') || '',
+            sessionId: ((_c = this.context) === null || _c === void 0 ? void 0 : _c.sessionId) || '',
+            authenticationMethod: cli_utilities_1.configHandler.get('authenticationMethod') || '',
+        };
+    }
     /**
      * The `start` function performs an audit on content types, global fields, entries, and workflows and displays
      * any missing references.
@@ -40,13 +53,21 @@ class AuditBaseCommand extends base_command_1.BaseCommand {
      * being executed.
      */
     async start(command) {
-        var _a, _b;
         this.currentCommand = command;
-        // Initialize audit context (reused, no need to call again in scanAndFix)
-        (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, '', cli_utilities_1.configHandler.get('authenticationMethod'));
-        this.auditContext = { module: 'audit' };
+        // Set progress supported module and console logs setting BEFORE any log calls
+        // This ensures the logger respects the setting when it's initialized
+        const logConfig = cli_utilities_1.configHandler.get('log') || {};
+        // Default to false so progress bars are shown instead of console logs
+        if (logConfig.showConsoleLogs === undefined) {
+            cli_utilities_1.configHandler.set('log.showConsoleLogs', false);
+        }
+        cli_utilities_1.configHandler.set('log.progressSupportedModule', 'audit');
+        // Initialize audit context
+        this.auditContext = this.createAuditContext();
         cli_utilities_1.log.debug(`Starting audit command: ${command}`, this.auditContext);
         cli_utilities_1.log.info(`Starting audit command: ${command}`, this.auditContext);
+        // Initialize global summary for progress tracking
+        cli_utilities_1.CLIProgressManager.initializeGlobalSummary('AUDIT', '', 'Auditing content...');
         await this.promptQueue();
         await this.createBackUp();
         this.sharedConfig.reportPath = (0, path_1.resolve)(this.flags['report-path'] || process.cwd(), 'audit-report');
@@ -110,6 +131,10 @@ class AuditBaseCommand extends base_command_1.BaseCommand {
                 (0, fs_1.rmSync)(this.sharedConfig.basePath, { recursive: true });
             }
         }
+        // Print comprehensive summary at the end
+        cli_utilities_1.CLIProgressManager.printGlobalSummary();
+        // Clear progress module setting now that audit is complete
+        (0, cli_utilities_1.clearProgressModuleSetting)();
         return (!(0, isEmpty_1.default)(missingCtRefs) ||
             !(0, isEmpty_1.default)(missingGfRefs) ||
             !(0, isEmpty_1.default)(missingEntryRefs) ||
@@ -128,7 +153,7 @@ class AuditBaseCommand extends base_command_1.BaseCommand {
      * and `missingEntryRefs`.
      */
     async scanAndFix() {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
         cli_utilities_1.log.debug('Starting scan and fix process', this.auditContext);
         let { ctSchema, gfSchema } = this.getCtAndGfSchema();
         cli_utilities_1.log.info(`Retrieved ${(ctSchema === null || ctSchema === void 0 ? void 0 : ctSchema.length) || 0} content types and ${(gfSchema === null || gfSchema === void 0 ? void 0 : gfSchema.length) || 0} global fields`, this.auditContext);
@@ -141,50 +166,60 @@ class AuditBaseCommand extends base_command_1.BaseCommand {
         };
         let dataModuleWise = await new modules_1.ModuleDataReader((0, cloneDeep_1.default)(constructorParam)).run();
         cli_utilities_1.log.debug(`Data module wise: ${JSON.stringify(dataModuleWise)}`, this.auditContext);
+        // Extract logConfig and showConsoleLogs once before the loop to reuse throughout
+        const logConfig = cli_utilities_1.configHandler.get('log') || {};
+        const showConsoleLogs = (_a = logConfig.showConsoleLogs) !== null && _a !== void 0 ? _a : true;
         for (const module of this.sharedConfig.flags.modules || this.sharedConfig.modules) {
             // Update audit context with current module
-            this.auditContext = { module: module };
+            this.auditContext = this.createAuditContext(module);
             cli_utilities_1.log.debug(`Starting audit for module: ${module}`, this.auditContext);
             cli_utilities_1.log.info(`Starting audit for module: ${module}`, this.auditContext);
-            (0, log_1.print)([
-                {
-                    bold: true,
-                    color: 'whiteBright',
-                    message: this.$t(this.messages.AUDIT_START_SPINNER, { module }),
-                },
-            ]);
+            // Only show spinner message if console logs are enabled (compatible with line-by-line logs)
+            if (showConsoleLogs) {
+                (0, log_1.print)([
+                    {
+                        bold: true,
+                        color: 'whiteBright',
+                        message: this.$t(this.messages.AUDIT_START_SPINNER, { module }),
+                    },
+                ]);
+            }
             constructorParam['moduleName'] = module;
             switch (module) {
                 case 'assets':
                     cli_utilities_1.log.info('Executing assets audit', this.auditContext);
-                    missingEnvLocalesInAssets = await new modules_1.Assets((0, cloneDeep_1.default)(constructorParam)).run();
+                    const assetsTotalCount = ((_b = dataModuleWise['assets']) === null || _b === void 0 ? void 0 : _b.Total) || 0;
+                    missingEnvLocalesInAssets = await new modules_1.Assets((0, cloneDeep_1.default)(constructorParam)).run(false, assetsTotalCount);
                     await this.prepareReport(module, missingEnvLocalesInAssets);
                     this.getAffectedData('assets', dataModuleWise['assets'], missingEnvLocalesInAssets);
                     cli_utilities_1.log.success(`Assets audit completed. Found ${Object.keys(missingEnvLocalesInAssets || {}).length} issues`, this.auditContext);
                     break;
                 case 'content-types':
                     cli_utilities_1.log.info('Executing content-types audit', this.auditContext);
-                    missingCtRefs = await new modules_1.ContentType((0, cloneDeep_1.default)(constructorParam)).run();
+                    const contentTypesTotalCount = ((_c = dataModuleWise['content-types']) === null || _c === void 0 ? void 0 : _c.Total) || 0;
+                    missingCtRefs = await new modules_1.ContentType((0, cloneDeep_1.default)(constructorParam)).run(false, contentTypesTotalCount);
                     await this.prepareReport(module, missingCtRefs);
                     this.getAffectedData('content-types', dataModuleWise['content-types'], missingCtRefs);
                     cli_utilities_1.log.success(`Content-types audit completed. Found ${Object.keys(missingCtRefs || {}).length} issues`, this.auditContext);
                     break;
                 case 'global-fields':
                     cli_utilities_1.log.info('Executing global-fields audit', this.auditContext);
-                    missingGfRefs = await new modules_1.GlobalField((0, cloneDeep_1.default)(constructorParam)).run();
+                    const globalFieldsTotalCount = ((_d = dataModuleWise['global-fields']) === null || _d === void 0 ? void 0 : _d.Total) || 0;
+                    missingGfRefs = await new modules_1.GlobalField((0, cloneDeep_1.default)(constructorParam)).run(false, globalFieldsTotalCount);
                     await this.prepareReport(module, missingGfRefs);
                     this.getAffectedData('global-fields', dataModuleWise['global-fields'], missingGfRefs);
                     cli_utilities_1.log.success(`Global-fields audit completed. Found ${Object.keys(missingGfRefs || {}).length} issues`, this.auditContext);
                     break;
                 case 'entries':
                     cli_utilities_1.log.info('Executing entries audit', this.auditContext);
-                    missingEntry = await new modules_1.Entries((0, cloneDeep_1.default)(constructorParam)).run();
-                    missingEntryRefs = (_a = missingEntry.missingEntryRefs) !== null && _a !== void 0 ? _a : {};
-                    missingSelectFeild = (_b = missingEntry.missingSelectFeild) !== null && _b !== void 0 ? _b : {};
-                    missingMandatoryFields = (_c = missingEntry.missingMandatoryFields) !== null && _c !== void 0 ? _c : {};
-                    missingTitleFields = (_d = missingEntry.missingTitleFields) !== null && _d !== void 0 ? _d : {};
-                    missingEnvLocalesInEntries = (_e = missingEntry.missingEnvLocale) !== null && _e !== void 0 ? _e : {};
-                    missingMultipleFields = (_f = missingEntry.missingMultipleFields) !== null && _f !== void 0 ? _f : {};
+                    const entriesTotalCount = ((_e = dataModuleWise['entries']) === null || _e === void 0 ? void 0 : _e.Total) || 0;
+                    missingEntry = await new modules_1.Entries((0, cloneDeep_1.default)(constructorParam)).run(entriesTotalCount);
+                    missingEntryRefs = (_f = missingEntry.missingEntryRefs) !== null && _f !== void 0 ? _f : {};
+                    missingSelectFeild = (_g = missingEntry.missingSelectFeild) !== null && _g !== void 0 ? _g : {};
+                    missingMandatoryFields = (_h = missingEntry.missingMandatoryFields) !== null && _h !== void 0 ? _h : {};
+                    missingTitleFields = (_j = missingEntry.missingTitleFields) !== null && _j !== void 0 ? _j : {};
+                    missingEnvLocalesInEntries = (_k = missingEntry.missingEnvLocale) !== null && _k !== void 0 ? _k : {};
+                    missingMultipleFields = (_l = missingEntry.missingMultipleFields) !== null && _l !== void 0 ? _l : {};
                     await this.prepareReport(module, missingEntryRefs);
                     await this.prepareReport(`Entries_Select_field`, missingSelectFeild);
                     await this.prepareReport('Entries_Mandatory_field', missingMandatoryFields);
@@ -196,26 +231,29 @@ class AuditBaseCommand extends base_command_1.BaseCommand {
                     break;
                 case 'workflows':
                     cli_utilities_1.log.info('Executing workflows audit', this.auditContext);
+                    const workflowsTotalCount = ((_m = dataModuleWise['workflows']) === null || _m === void 0 ? void 0 : _m.Total) || 0;
                     missingCtRefsInWorkflow = await new modules_1.Workflows({
                         ctSchema,
                         moduleName: module,
                         config: this.sharedConfig,
                         fix: this.currentCommand === 'cm:stacks:audit:fix',
-                    }).run();
+                    }).run(workflowsTotalCount);
                     await this.prepareReport(module, missingCtRefsInWorkflow);
                     this.getAffectedData('workflows', dataModuleWise['workflows'], missingCtRefsInWorkflow);
                     cli_utilities_1.log.success(`Workflows audit completed. Found ${Object.keys(missingCtRefsInWorkflow || {}).length} issues`, this.auditContext);
                     break;
                 case 'extensions':
                     cli_utilities_1.log.info('Executing extensions audit', this.auditContext);
-                    missingCtRefsInExtensions = await new modules_1.Extensions((0, cloneDeep_1.default)(constructorParam)).run();
+                    const extensionsTotalCount = ((_o = dataModuleWise['extensions']) === null || _o === void 0 ? void 0 : _o.Total) || 0;
+                    missingCtRefsInExtensions = await new modules_1.Extensions((0, cloneDeep_1.default)(constructorParam)).run(extensionsTotalCount);
                     await this.prepareReport(module, missingCtRefsInExtensions);
                     this.getAffectedData('extensions', dataModuleWise['extensions'], missingCtRefsInExtensions);
                     cli_utilities_1.log.success(`Extensions audit completed. Found ${Object.keys(missingCtRefsInExtensions || {}).length} issues`, this.auditContext);
                     break;
                 case 'custom-roles':
                     cli_utilities_1.log.info('Executing custom-roles audit', this.auditContext);
-                    missingRefInCustomRoles = await new modules_1.CustomRoles((0, cloneDeep_1.default)(constructorParam)).run();
+                    const customRolesTotalCount = ((_p = dataModuleWise['custom-roles']) === null || _p === void 0 ? void 0 : _p.Total) || 0;
+                    missingRefInCustomRoles = await new modules_1.CustomRoles((0, cloneDeep_1.default)(constructorParam)).run(customRolesTotalCount);
                     await this.prepareReport(module, missingRefInCustomRoles);
                     this.getAffectedData('custom-roles', dataModuleWise['custom-roles'], missingRefInCustomRoles);
                     cli_utilities_1.log.success(`Custom-roles audit completed. Found ${Object.keys(missingRefInCustomRoles || {}).length} issues`, this.auditContext);
@@ -226,24 +264,28 @@ class AuditBaseCommand extends base_command_1.BaseCommand {
                     const data = this.getCtAndGfSchema();
                     constructorParam.ctSchema = data.ctSchema;
                     constructorParam.gfSchema = data.gfSchema;
-                    missingFieldRules = await new modules_1.FieldRule((0, cloneDeep_1.default)(constructorParam)).run();
+                    const fieldRulesTotalCount = ((_q = dataModuleWise['content-types']) === null || _q === void 0 ? void 0 : _q.Total) || 0;
+                    missingFieldRules = await new modules_1.FieldRule((0, cloneDeep_1.default)(constructorParam)).run(fieldRulesTotalCount);
                     await this.prepareReport(module, missingFieldRules);
                     this.getAffectedData('field-rules', dataModuleWise['content-types'], missingFieldRules);
                     cli_utilities_1.log.success(`Field-rules audit completed. Found ${Object.keys(missingFieldRules || {}).length} issues`, this.auditContext);
                     break;
             }
-            (0, log_1.print)([
-                {
-                    bold: true,
-                    color: 'whiteBright',
-                    message: this.$t(this.messages.AUDIT_START_SPINNER, { module }),
-                },
-                {
-                    bold: true,
-                    message: ' done',
-                    color: 'whiteBright',
-                },
-            ]);
+            // Only show completion message if console logs are enabled
+            if (showConsoleLogs) {
+                (0, log_1.print)([
+                    {
+                        bold: true,
+                        color: 'whiteBright',
+                        message: this.$t(this.messages.AUDIT_START_SPINNER, { module }),
+                    },
+                    {
+                        bold: true,
+                        message: ' done',
+                        color: 'whiteBright',
+                    },
+                ]);
+            }
         }
         cli_utilities_1.log.debug('Scan and fix process completed', this.auditContext);
         this.prepareReport('Summary', this.summaryDataToPrint);

package/lib/modules/assets.d.ts

@@ -1,9 +1,9 @@
-import { ConfigType, ContentTypeStruct, CtConstructorParam, ModuleConstructorParam, EntryStruct } from '../types';
+import { ContentTypeStruct, CtConstructorParam, ModuleConstructorParam, EntryStruct } from '../types';
 import auditConfig from '../config';
-export default class Assets {
+import BaseClass from './base-class';
+export default class Assets extends BaseClass {
     protected fix: boolean;
     fileName: string;
-    config: ConfigType;
     folderPath: string;
     currentUid: string;
     currentTitle: string;
@@ -18,9 +18,11 @@ export default class Assets {
     /**
      * The `run` function checks if a folder path exists, sets the schema based on the module name,
      * iterates over the schema and looks for references, and returns a list of missing references.
+     * @param returnFixSchema - If true, returns the fixed schema instead of missing references
+     * @param totalCount - Total number of assets to process (for progress tracking)
      * @returns the `missingEnvLocales` object.
      */
-    run(returnFixSchema?: boolean): Promise<Record<string, any> | ContentTypeStruct[]>;
+    run(returnFixSchema?: boolean, totalCount?: number): Promise<Record<string, any> | ContentTypeStruct[]>;
     /**
      * @method prerequisiteData
      * The `prerequisiteData` function reads and parses JSON files to retrieve extension and marketplace

package/lib/modules/assets.js

@@ -7,15 +7,16 @@ const cli_utilities_1 = require("@contentstack/cli-utilities");
 const messages_1 = require("../messages");
 const values_1 = tslib_1.__importDefault(require("lodash/values"));
 const lodash_1 = require("lodash");
-/* The `ContentType` class is responsible for scanning content types, looking for references, and
-generating a report in JSON and CSV formats. */
-class Assets {
+const base_class_1 = tslib_1.__importDefault(require("./base-class"));
+/* The `Assets` class is responsible for scanning assets, looking for missing environment/locale references,
+and generating a report in JSON and CSV formats. */
+class Assets extends base_class_1.default {
     constructor({ fix, config, moduleName }) {
+        super({ config });
         this.locales = [];
         this.environments = [];
         this.schema = [];
         this.missingEnvLocales = {};
-        this.config = config;
         this.fix = fix !== null && fix !== void 0 ? fix : false;
         this.moduleName = this.validateModules(moduleName, this.config.moduleConfig);
         this.fileName = config.moduleConfig[this.moduleName].fileName;
@@ -30,38 +31,54 @@ class Assets {
     /**
      * The `run` function checks if a folder path exists, sets the schema based on the module name,
      * iterates over the schema and looks for references, and returns a list of missing references.
+     * @param returnFixSchema - If true, returns the fixed schema instead of missing references
+     * @param totalCount - Total number of assets to process (for progress tracking)
      * @returns the `missingEnvLocales` object.
      */
-    async run(returnFixSchema = false) {
+    async run(returnFixSchema = false, totalCount) {
         var _a;
-        cli_utilities_1.log.debug(`Starting ${this.moduleName} audit process`, this.config.auditContext);
-        cli_utilities_1.log.debug(`Data directory: ${this.folderPath}`, this.config.auditContext);
-        cli_utilities_1.log.debug(`Fix mode: ${this.fix}`, this.config.auditContext);
-        if (!(0, fs_1.existsSync)(this.folderPath)) {
-            cli_utilities_1.log.debug(`Skipping ${this.moduleName} audit - path does not exist`, this.config.auditContext);
-            cli_utilities_1.log.warn(`Skipping ${this.moduleName} audit`, this.config.auditContext);
-            cli_utilities_1.cliux.print((0, messages_1.$t)(messages_1.auditMsg.NOT_VALID_PATH, { path: this.folderPath }), { color: 'yellow' });
-            return returnFixSchema ? [] : {};
-        }
-        cli_utilities_1.log.debug('Loading prerequisite data (locales and environments)', this.config.auditContext);
-        await this.prerequisiteData();
-        cli_utilities_1.log.debug('Starting asset Reference, Environment and Locale validation', this.config.auditContext);
-        await this.lookForReference();
-        if (returnFixSchema) {
-            cli_utilities_1.log.debug(`Returning fixed schema with ${((_a = this.schema) === null || _a === void 0 ? void 0 : _a.length) || 0} items`, this.config.auditContext);
-            return this.schema;
-        }
-        cli_utilities_1.log.debug('Cleaning up empty missing environment/locale references', this.config.auditContext);
-        for (let propName in this.missingEnvLocales) {
-            if (Array.isArray(this.missingEnvLocales[propName])) {
-                if (!this.missingEnvLocales[propName].length) {
-                    delete this.missingEnvLocales[propName];
+        try {
+            cli_utilities_1.log.debug(`Starting ${this.moduleName} audit process`, this.config.auditContext);
+            cli_utilities_1.log.debug(`Data directory: ${this.folderPath}`, this.config.auditContext);
+            cli_utilities_1.log.debug(`Fix mode: ${this.fix}`, this.config.auditContext);
+            if (!(0, fs_1.existsSync)(this.folderPath)) {
+                cli_utilities_1.log.debug(`Skipping ${this.moduleName} audit - path does not exist`, this.config.auditContext);
+                cli_utilities_1.log.warn(`Skipping ${this.moduleName} audit`, this.config.auditContext);
+                cli_utilities_1.cliux.print((0, messages_1.$t)(messages_1.auditMsg.NOT_VALID_PATH, { path: this.folderPath }), { color: 'yellow' });
+                return returnFixSchema ? [] : {};
+            }
+            // Load prerequisite data with loading spinner
+            await this.withLoadingSpinner('ASSETS: Loading prerequisite data (locales and environments)...', async () => {
+                await this.prerequisiteData();
+            });
+            // Create progress manager if we have a total count
+            if (totalCount && totalCount > 0) {
+                const progress = this.createSimpleProgress(this.moduleName, totalCount);
+                progress.updateStatus('Validating asset references...');
+            }
+            cli_utilities_1.log.debug('Starting asset Reference, Environment and Locale validation', this.config.auditContext);
+            await this.lookForReference();
+            if (returnFixSchema) {
+                cli_utilities_1.log.debug(`Returning fixed schema with ${((_a = this.schema) === null || _a === void 0 ? void 0 : _a.length) || 0} items`, this.config.auditContext);
+                return this.schema;
+            }
+            cli_utilities_1.log.debug('Cleaning up empty missing environment/locale references', this.config.auditContext);
+            for (let propName in this.missingEnvLocales) {
+                if (Array.isArray(this.missingEnvLocales[propName])) {
+                    if (!this.missingEnvLocales[propName].length) {
+                        delete this.missingEnvLocales[propName];
+                    }
                 }
             }
+            const totalIssues = Object.keys(this.missingEnvLocales).length;
+            cli_utilities_1.log.debug(`${this.moduleName} audit completed. Found ${totalIssues} assets with missing environment/locale references`, this.config.auditContext);
+            this.completeProgress(true);
+            return this.missingEnvLocales;
+        }
+        catch (error) {
+            this.completeProgress(false, (error === null || error === void 0 ? void 0 : error.message) || 'Assets audit failed');
+            throw error;
         }
-        const totalIssues = Object.keys(this.missingEnvLocales).length;
-        cli_utilities_1.log.debug(`${this.moduleName} audit completed. Found ${totalIssues} assets with missing environment/locale references`, this.config.auditContext);
-        return this.missingEnvLocales;
     }
     /**
      * @method prerequisiteData
@@ -182,6 +199,10 @@ class Assets {
                 });
                 const remainingPublishDetails = ((_d = this.assets[assetUid].publish_details) === null || _d === void 0 ? void 0 : _d.length) || 0;
                 cli_utilities_1.log.debug(`Asset ${assetUid} now has ${remainingPublishDetails} valid publish details`, this.config.auditContext);
+                // Track progress for each asset processed
+                if (this.progressManager) {
+                    this.progressManager.tick(true, `asset: ${assetUid}`, null);
+                }
                 if (this.fix) {
                     cli_utilities_1.log.debug(`Fixing asset ${assetUid}`, this.config.auditContext);
                     cli_utilities_1.log.info((0, messages_1.$t)(messages_1.auditFixMsg.ASSET_FIX, { uid: assetUid }), this.config.auditContext);

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

@@ -0,0 +1,24 @@
+import { CLIProgressManager } from '@contentstack/cli-utilities';
+import { ConfigType, ModuleConstructorParam } from '../types';
+export default abstract class BaseClass {
+    protected progressManager: CLIProgressManager | null;
+    protected currentModuleName: string;
+    config: ConfigType;
+    constructor({ config }: ModuleConstructorParam);
+    /**
+     * Create simple progress manager
+     */
+    protected createSimpleProgress(moduleName: string, total?: number): CLIProgressManager;
+    /**
+     * Create nested progress manager
+     */
+    protected createNestedProgress(moduleName: string): CLIProgressManager;
+    /**
+     * Complete progress manager
+     */
+    protected completeProgress(success?: boolean, error?: string): void;
+    /**
+     * Execute action with loading spinner (if console logs are disabled)
+     */
+    protected withLoadingSpinner<T>(message: string, action: () => Promise<T>): Promise<T>;
+}

package/lib/modules/base-class.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+class BaseClass {
+    constructor({ config }) {
+        this.progressManager = null;
+        this.currentModuleName = '';
+        this.config = config;
+    }
+    /**
+     * Create simple progress manager
+     */
+    createSimpleProgress(moduleName, total) {
+        var _a;
+        this.currentModuleName = moduleName;
+        const logConfig = cli_utilities_1.configHandler.get('log') || {};
+        const showConsoleLogs = (_a = logConfig.showConsoleLogs) !== null && _a !== void 0 ? _a : false;
+        this.progressManager = cli_utilities_1.CLIProgressManager.createSimple(moduleName, total, showConsoleLogs);
+        return this.progressManager;
+    }
+    /**
+     * Create nested progress manager
+     */
+    createNestedProgress(moduleName) {
+        var _a;
+        this.currentModuleName = moduleName;
+        const logConfig = cli_utilities_1.configHandler.get('log') || {};
+        const showConsoleLogs = (_a = logConfig.showConsoleLogs) !== null && _a !== void 0 ? _a : false;
+        this.progressManager = cli_utilities_1.CLIProgressManager.createNested(moduleName, showConsoleLogs);
+        return this.progressManager;
+    }
+    /**
+     * Complete progress manager
+     */
+    completeProgress(success = true, error) {
+        var _a;
+        (_a = this.progressManager) === null || _a === void 0 ? void 0 : _a.complete(success, error);
+        this.progressManager = null;
+    }
+    /**
+     * Execute action with loading spinner (if console logs are disabled)
+     */
+    async withLoadingSpinner(message, action) {
+        var _a;
+        const logConfig = cli_utilities_1.configHandler.get('log') || {};
+        const showConsoleLogs = (_a = logConfig.showConsoleLogs) !== null && _a !== void 0 ? _a : false;
+        if (showConsoleLogs) {
+            // If console logs are enabled, don't show spinner, just execute the action
+            return await action();
+        }
+        return await cli_utilities_1.CLIProgressManager.withLoadingSpinner(message, action);
+    }
+}
+exports.default = BaseClass;

package/lib/modules/content-types.d.ts

@@ -1,9 +1,9 @@
-import { ConfigType, ModularBlockType, ContentTypeStruct, GroupFieldDataType, RefErrorReturnType, CtConstructorParam, GlobalFieldDataType, JsonRTEFieldDataType, ModularBlocksDataType, ModuleConstructorParam, ReferenceFieldDataType, ContentTypeSchemaType, ExtensionOrAppFieldDataType } from '../types';
+import { ModularBlockType, ContentTypeStruct, GroupFieldDataType, RefErrorReturnType, CtConstructorParam, GlobalFieldDataType, JsonRTEFieldDataType, ModularBlocksDataType, ModuleConstructorParam, ReferenceFieldDataType, ContentTypeSchemaType, ExtensionOrAppFieldDataType } from '../types';
 import auditConfig from '../config';
-export default class ContentType {
+import BaseClass from './base-class';
+export default class ContentType extends BaseClass {
     protected fix: boolean;
     fileName: string;
-    config: ConfigType;
     folderPath: string;
     currentUid: string;
     currentTitle: string;
@@ -19,9 +19,11 @@ export default class ContentType {
     /**
      * The `run` function checks if a folder path exists, sets the schema based on the module name,
      * iterates over the schema and looks for references, and returns a list of missing references.
+     * @param returnFixSchema - If true, returns the fixed schema instead of missing references
+     * @param totalCount - Total number of items to process (for progress tracking)
      * @returns the `missingRefs` object.
      */
-    run(returnFixSchema?: boolean): Promise<Record<string, any> | ContentTypeStruct[]>;
+    run(returnFixSchema?: boolean, totalCount?: number): Promise<Record<string, any> | ContentTypeStruct[]>;
     /**
      * @method prerequisiteData
      * The `prerequisiteData` function reads and parses JSON files to retrieve extension and marketplace