@contentstack/cli-utilities 2.0.0-beta.9 → 2.0.1

package/lib/auth-handler.js

@@ -91,7 +91,9 @@ class AuthHandler {
     async initSDK() {
         // Ensure we have a valid host for the SDK initialization
         const host = this._host || this.getCmaHost();
-        this.managementAPIClient = await (0, contentstack_management_sdk_1.default)({ host });
+        // skipTokenValidity: true avoids calling compareOAuthExpiry here, which would deadlock
+        // when initSDK is itself called from inside a compareOAuthExpiry refresh cycle.
+        this.managementAPIClient = await (0, contentstack_management_sdk_1.default)({ host, skipTokenValidity: true });
         this.oauthHandler = this.managementAPIClient.oauth({
             appId: this.OAuthAppId,
             clientId: this.OAuthClientId,
@@ -347,7 +349,17 @@ class AuthHandler {
                 return this.oauthRefreshInFlight;
             }
             this.isRefreshingToken = true;
-            this.oauthRefreshInFlight = (async () => {
+            // Set the guard promise BEFORE starting the async work so re-entrant synchronous
+            // callers (e.g. compareOAuthExpiry invoked again via refreshToken → initSDK →
+            // managementSDKClient → createAPIClient) see a non-null oauthRefreshInFlight and
+            // return early instead of starting another recursive refresh cycle.
+            let _resolve;
+            let _reject;
+            this.oauthRefreshInFlight = new Promise((res, rej) => {
+                _resolve = res;
+                _reject = rej;
+            });
+            (async () => {
                 try {
                     if (force) {
                         cli_ux_1.default.print('Forcing token refresh...');
@@ -356,10 +368,11 @@ class AuthHandler {
                         cli_ux_1.default.print('Token expired, refreshing the token');
                     }
                     await this.refreshToken();
+                    _resolve();
                 }
                 catch (error) {
                     cli_ux_1.default.error('Error refreshing token');
-                    throw error;
+                    _reject(error);
                 }
                 finally {
                     this.isRefreshingToken = false;

package/lib/authentication-handler.js

@@ -53,6 +53,11 @@ class AuthenticationHandler {
         if (error.response && error.response.status) {
             switch (error.response.status) {
                 case 401:
+                    if (maxRetryCount >= 2) {
+                        const errorDetails = (0, index_1.formatError)(error);
+                        index_1.cliux.print(`Authentication failed after token refresh: ${errorDetails}`, { color: 'red' });
+                        return;
+                    }
                     // NOTE: Refresh the token if the type is OAuth.
                     const region = index_1.configHandler.get('region') || {};
                     if (region === null || region === void 0 ? void 0 : region.cma) {
@@ -65,11 +70,10 @@ class AuthenticationHandler {
                         hostName = hostName || region.cma;
                         const refreshed = await this.refreshToken(hostName);
                         if (refreshed) {
-                            return this.refreshAccessToken(error, maxRetryCount); // Retry after refreshing the token
+                            return this.refreshAccessToken(error, maxRetryCount + 1);
                         }
                         const errorDetails = (0, index_1.formatError)(error);
                         index_1.cliux.print(`Authentication failed: ${errorDetails}`, { color: 'red' });
-                        // For Basic Auth, exit immediately without retrying
                         return;
                     }
                     break;

package/lib/constants/logging.d.ts

@@ -13,4 +13,4 @@ export declare const levelColors: {
     info: string;
     debug: string;
 };
-export declare const PROGRESS_SUPPORTED_MODULES: readonly ["export", "import", "audit", "import-setup", "clone"];
+export declare const PROGRESS_SUPPORTED_MODULES: readonly ["export", "import", "audit", "import-setup", "clone", "bulk-operations"];

package/lib/constants/logging.js

@@ -17,4 +17,4 @@ exports.levelColors = {
     info: 'white',
     debug: 'blue',
 };
-exports.PROGRESS_SUPPORTED_MODULES = ['export', 'import', 'audit', 'import-setup', 'clone'];
+exports.PROGRESS_SUPPORTED_MODULES = ['export', 'import', 'audit', 'import-setup', 'clone', 'bulk-operations'];

package/lib/content-type-utils.d.ts

@@ -1,7 +1,2 @@
-/**
- * Reads all content type schema files from a directory
- * @param dirPath - Path to content types directory
- * @param ignoredFiles - Files to ignore (defaults to schema.json, .DS_Store, __master.json, __priority.json)
- * @returns Array of content type schemas (empty if the path is missing or has no eligible files)
- */
+export declare function readGlobalFieldSchemas(dirPath: string, ignoredFiles?: string[]): Record<string, unknown>[];
 export declare function readContentTypeSchemas(dirPath: string, ignoredFiles?: string[]): Record<string, unknown>[];

package/lib/content-type-utils.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.readGlobalFieldSchemas = readGlobalFieldSchemas;
 exports.readContentTypeSchemas = readContentTypeSchemas;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -9,6 +10,10 @@ const node_path_1 = require("node:path");
  * @param ignoredFiles - Files to ignore (defaults to schema.json, .DS_Store, __master.json, __priority.json)
  * @returns Array of content type schemas (empty if the path is missing or has no eligible files)
  */
+const DEFAULT_GF_IGNORED_FILES = ['schema.json', '.DS_Store', '__master.json', '__priority.json', 'field_rules_uid.json', 'globalfields.json'];
+function readGlobalFieldSchemas(dirPath, ignoredFiles = DEFAULT_GF_IGNORED_FILES) {
+    return readContentTypeSchemas(dirPath, ignoredFiles);
+}
 function readContentTypeSchemas(dirPath, ignoredFiles = ['schema.json', '.DS_Store', '__master.json', '__priority.json', 'field_rules_uid.json']) {
     if (!(0, node_fs_1.existsSync)(dirPath)) {
         return [];

package/lib/feature-status/build-auth-headers.d.ts

@@ -0,0 +1,9 @@
+export interface AuthHeaders {
+    [key: string]: string;
+}
+export declare function buildAuthHeaders(ctx?: {
+    managementToken?: string;
+    apiKey?: string;
+    authToken?: string;
+    orgUid?: string;
+}): AuthHeaders;

package/lib/feature-status/build-auth-headers.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAuthHeaders = buildAuthHeaders;
+const tslib_1 = require("tslib");
+const config_handler_1 = tslib_1.__importDefault(require("../config-handler"));
+function buildAuthHeaders(ctx) {
+    var _a, _b;
+    // 1. Management token takes priority (no 'Bearer' prefix — API contract)
+    if ((ctx === null || ctx === void 0 ? void 0 : ctx.managementToken) && (ctx === null || ctx === void 0 ? void 0 : ctx.apiKey)) {
+        return {
+            Authorization: ctx.managementToken,
+            api_key: ctx.apiKey,
+        };
+    }
+    // 2. OAuth
+    const oauthToken = config_handler_1.default.get('oauthAccessToken');
+    if (oauthToken) {
+        return { Authorization: `Bearer ${oauthToken}` };
+    }
+    // 3. Authtoken + organization_uid
+    const authtoken = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.authToken) !== null && _a !== void 0 ? _a : config_handler_1.default.get('authtoken');
+    const orgUid = (_b = ctx === null || ctx === void 0 ? void 0 : ctx.orgUid) !== null && _b !== void 0 ? _b : config_handler_1.default.get('oauthOrgUid');
+    if (authtoken && orgUid) {
+        return { authtoken, organization_uid: orgUid };
+    }
+    // 4. Authtoken + api_key
+    if (authtoken && (ctx === null || ctx === void 0 ? void 0 : ctx.apiKey)) {
+        return { authtoken, api_key: ctx.apiKey };
+    }
+    throw new Error('PLAN_CHECK: Cannot build auth headers — no valid credentials available. ' +
+        'Please log in or provide a management token alias.');
+}

package/lib/feature-status/feature-status-handler.d.ts

@@ -0,0 +1,3 @@
+import { FeatureStatus, FeatureCtx } from './types';
+export declare function isFeatureEnabled(featureUid: string, ctx?: FeatureCtx): Promise<FeatureStatus>;
+export declare function assertFeatureEnabled(featureUid: string, ctx?: FeatureCtx): Promise<FeatureStatus>;

package/lib/feature-status/feature-status-handler.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFeatureEnabled = isFeatureEnabled;
+exports.assertFeatureEnabled = assertFeatureEnabled;
+const http_client_1 = require("../http-client");
+const resolve_auth_host_1 = require("./resolve-auth-host");
+const build_auth_headers_1 = require("./build-auth-headers");
+async function isFeatureEnabled(featureUid, ctx) {
+    const host = (0, resolve_auth_host_1.resolveAuthHost)(ctx);
+    const headers = (0, build_auth_headers_1.buildAuthHeaders)(ctx);
+    const client = new http_client_1.HttpClient();
+    client.baseUrl(host).headers(headers);
+    const res = await client.get(`/v1/feature-status?feature_uid=${encodeURIComponent(featureUid)}`);
+    if (res.status < 200 || res.status >= 300) {
+        throw new Error(`PLAN_CHECK: feature-status API returned ${res.status} for "${featureUid}".`);
+    }
+    return res.data;
+}
+async function assertFeatureEnabled(featureUid, ctx) {
+    let status;
+    try {
+        status = await isFeatureEnabled(featureUid, ctx);
+    }
+    catch (e) {
+        throw new Error(`Could not verify your plan for "${featureUid}". ` +
+            `This command requires a confirmed plan status to run. ` +
+            `Please retry; if the problem persists contact support. (${e.message})`);
+    }
+    if (!status.is_part_of_plan) {
+        throw new Error(`"${featureUid}" is not part of your current plan. Please upgrade your plan to use this feature.`);
+    }
+    if (status.status !== 'enabled') {
+        throw new Error(`"${featureUid}" is not enabled for your plan (status: ${status.status}).`);
+    }
+    return status;
+}

package/lib/feature-status/feature-uids.d.ts

@@ -0,0 +1,5 @@
+export declare const FEATURE: {
+    readonly ASSET_MANAGEMENT: "amAssets";
+    readonly ASSET_SCANNING: "assetsScan";
+};
+export type FeatureUid = (typeof FEATURE)[keyof typeof FEATURE];

package/lib/feature-status/feature-uids.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE = void 0;
+exports.FEATURE = {
+    ASSET_MANAGEMENT: 'amAssets',
+    ASSET_SCANNING: 'assetsScan',
+};

package/lib/feature-status/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './feature-uids';
+export { resolveAuthHost } from './resolve-auth-host';
+export { buildAuthHeaders } from './build-auth-headers';
+export { isFeatureEnabled, assertFeatureEnabled } from './feature-status-handler';

package/lib/feature-status/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertFeatureEnabled = exports.isFeatureEnabled = exports.buildAuthHeaders = exports.resolveAuthHost = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./feature-uids"), exports);
+var resolve_auth_host_1 = require("./resolve-auth-host");
+Object.defineProperty(exports, "resolveAuthHost", { enumerable: true, get: function () { return resolve_auth_host_1.resolveAuthHost; } });
+var build_auth_headers_1 = require("./build-auth-headers");
+Object.defineProperty(exports, "buildAuthHeaders", { enumerable: true, get: function () { return build_auth_headers_1.buildAuthHeaders; } });
+var feature_status_handler_1 = require("./feature-status-handler");
+Object.defineProperty(exports, "isFeatureEnabled", { enumerable: true, get: function () { return feature_status_handler_1.isFeatureEnabled; } });
+Object.defineProperty(exports, "assertFeatureEnabled", { enumerable: true, get: function () { return feature_status_handler_1.assertFeatureEnabled; } });

package/lib/feature-status/resolve-auth-host.d.ts

@@ -0,0 +1,8 @@
+export declare function resolveAuthHost(ctx?: {
+    region?: {
+        endpoints?: {
+            auth?: string;
+        };
+        cma?: string;
+    };
+}): string;

package/lib/feature-status/resolve-auth-host.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAuthHost = resolveAuthHost;
+const tslib_1 = require("tslib");
+const config_handler_1 = tslib_1.__importDefault(require("../config-handler"));
+// Mirrors config:set:region's own custom-region fallback (region.ts's transformUrl) —
+// same heuristic, applied retroactively for a custom region that predates auth-api.
+// Computed fresh on each call, never persisted back to config.
+function deriveAuthFromCma(cma) {
+    let transformed = cma.replace('api', 'auth-api');
+    if (transformed.startsWith('http')) {
+        transformed = transformed.split('//')[1];
+    }
+    transformed = transformed.replace(/^dev\d+/, 'dev');
+    transformed = transformed.endsWith('io') ? transformed.replace('io', 'com') : transformed;
+    return `https://${transformed}`;
+}
+function resolveAuthHost(ctx) {
+    var _a, _b;
+    const region = ((_a = ctx === null || ctx === void 0 ? void 0 : ctx.region) !== null && _a !== void 0 ? _a : config_handler_1.default.get('region'));
+    let authUrl = (_b = region === null || region === void 0 ? void 0 : region.endpoints) === null || _b === void 0 ? void 0 : _b.auth;
+    if (!authUrl && (region === null || region === void 0 ? void 0 : region.cma)) {
+        authUrl = deriveAuthFromCma(region.cma);
+    }
+    if (!authUrl) {
+        throw new Error('PLAN_CHECK: Auth host is not configured for the current region. ' +
+            "Re-run `csdx config:set:region` to refresh region endpoints.");
+    }
+    return String(authUrl).replace(/\/$/, '');
+}

package/lib/feature-status/types.d.ts

@@ -0,0 +1,21 @@
+export interface FeatureStatus {
+    org_uid: string;
+    feature_key: string;
+    status: 'enabled' | 'disabled' | string;
+    limit: number;
+    max_limit: number;
+    is_part_of_plan: boolean;
+}
+export interface FeatureCtx {
+    apiKey?: string;
+    orgUid?: string;
+    managementToken?: string;
+    authToken?: string;
+    region?: {
+        name?: string;
+        cma?: string;
+        endpoints?: {
+            auth?: string;
+        };
+    };
+}

package/lib/feature-status/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/index.d.ts

@@ -29,4 +29,7 @@ export type { ChalkInstance } from './chalk';
 export { Logger };
 export { default as authenticationHandler } from './authentication-handler';
 export { v2Logger as log, cliErrorHandler, handleAndLogError, getLogPath, getSessionLogPath } from './logger/log';
-export { CLIProgressManager, SummaryManager, PrimaryProcessStrategy, ProgressStrategyRegistry, CustomProgressStrategy, DefaultProgressStrategy } from './progress-summary';
+export { CLIProgressManager, SummaryManager, PrimaryProcessStrategy, ProgressStrategyRegistry, CustomProgressStrategy, DefaultProgressStrategy, } from './progress-summary';
+export * from './feature-status';
+export * from './region-endpoints';
+export { refreshRegionEndpoints } from './region-refresh';

package/lib/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultProgressStrategy = exports.CustomProgressStrategy = exports.ProgressStrategyRegistry = exports.PrimaryProcessStrategy = exports.SummaryManager = exports.CLIProgressManager = exports.getSessionLogPath = exports.getLogPath = exports.handleAndLogError = exports.cliErrorHandler = exports.log = exports.authenticationHandler = exports.Logger = exports.getChalk = exports.loadChalk = exports.TablePrompt = exports.execute = exports.ux = exports.flush = exports.settings = exports.toConfiguredId = exports.toStandardizedId = exports.Plugin = exports.Parser = exports.Interfaces = exports.HelpBase = exports.Help = exports.loadHelpClass = exports.Flags = exports.Errors = exports.Config = exports.CommandHelp = exports.Args = exports.marketplaceSDKInitiator = exports.MarketplaceSDKInitiator = exports.marketplaceSDKClient = exports.CLITable = exports.createLogContext = exports.Command = exports.flags = exports.args = exports.NodeCrypto = exports.managementSDKInitiator = exports.managementSDKClient = exports.configHandler = exports.authHandler = exports.messageHandler = exports.CLIError = exports.cliux = exports.LoggerService = void 0;
+exports.refreshRegionEndpoints = void 0;
 const tslib_1 = require("tslib");
 const logger_1 = tslib_1.__importDefault(require("./logger"));
 exports.Logger = logger_1.default;
@@ -82,3 +83,7 @@ Object.defineProperty(exports, "PrimaryProcessStrategy", { enumerable: true, get
 Object.defineProperty(exports, "ProgressStrategyRegistry", { enumerable: true, get: function () { return progress_summary_1.ProgressStrategyRegistry; } });
 Object.defineProperty(exports, "CustomProgressStrategy", { enumerable: true, get: function () { return progress_summary_1.CustomProgressStrategy; } });
 Object.defineProperty(exports, "DefaultProgressStrategy", { enumerable: true, get: function () { return progress_summary_1.DefaultProgressStrategy; } });
+tslib_1.__exportStar(require("./feature-status"), exports);
+tslib_1.__exportStar(require("./region-endpoints"), exports);
+var region_refresh_1 = require("./region-refresh");
+Object.defineProperty(exports, "refreshRegionEndpoints", { enumerable: true, get: function () { return region_refresh_1.refreshRegionEndpoints; } });

package/lib/logger/logger.d.ts

@@ -12,6 +12,12 @@ export default class Logger {
     private isSensitiveKey;
     private redactObject;
     private redact;
+    /**
+     * Stringifies a log entry without throwing on circular references.
+     * `redact()` can fall back to the original (still-circular) object when
+     * cloning fails, so this must never assume the input is cycle-free.
+     */
+    private safeStringify;
     private shouldLog;
     error(message: string, meta?: any): void;
     warn(message: string, meta?: any): void;

package/lib/logger/logger.js

@@ -52,7 +52,7 @@ class Logger {
             new winston.transports.File(Object.assign(Object.assign({}, this.loggerOptions), { filename: `${filePath}/${level}.log`, format: winston.format.combine(winston.format.timestamp(), winston.format.printf((info) => {
                     // Apply minimal redaction for files (debugging info preserved)
                     const redactedInfo = this.redact(info, false);
-                    return JSON.stringify(redactedInfo);
+                    return this.safeStringify(redactedInfo);
                 })) })),
         ];
         // Determine console logging based on configuration
@@ -70,7 +70,11 @@ class Logger {
                 showConsoleLogs = true;
             }
         }
-        if (showConsoleLogs) {
+        // Errors and warnings must always reach the console, even when progress bars
+        // suppress info/success/debug output — otherwise failures (e.g. an invalid
+        // stack API key or a taxonomy error) are silently swallowed in progress mode.
+        const isErrorOrWarn = level === 'error' || level === 'warn';
+        if (showConsoleLogs || isErrorOrWarn) {
             transports.push(new winston.transports.Console({
                 format: winston.format.combine(winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.printf((info) => {
                     // Apply full redaction for console (user-facing)
@@ -117,6 +121,28 @@ class Logger {
             return info;
         }
     }
+    /**
+     * Stringifies a log entry without throwing on circular references.
+     * `redact()` can fall back to the original (still-circular) object when
+     * cloning fails, so this must never assume the input is cycle-free.
+     */
+    safeStringify(value) {
+        var _a;
+        const seen = new WeakSet();
+        try {
+            return JSON.stringify(value, (_key, val) => {
+                if (typeof val === 'object' && val !== null) {
+                    if (seen.has(val))
+                        return '[Circular]';
+                    seen.add(val);
+                }
+                return val;
+            });
+        }
+        catch (_b) {
+            return JSON.stringify({ level: value === null || value === void 0 ? void 0 : value.level, message: (_a = value === null || value === void 0 ? void 0 : value.message) !== null && _a !== void 0 ? _a : '[Unserializable log entry]' });
+        }
+    }
     shouldLog(level, target) {
         // If console logging is disabled, don't log to console
         if (target === 'console' && this.config.consoleLoggingEnabled === false) {
@@ -163,9 +189,12 @@ class Logger {
         if (this.shouldLog('error', 'file')) {
             this.loggers.error.error(logPayload);
         }
-        // For console, use debug level if hidden, otherwise error level
+        // For console, use debug level if hidden, otherwise error level. Each level's
+        // winston logger instance bundles both the file and console transports, so only
+        // write again here when the target differs from the one already written above —
+        // otherwise this would duplicate both the console line and the file entry.
         const consoleLevel = params.hidden ? 'debug' : 'error';
-        if (this.shouldLog(consoleLevel, 'console')) {
+        if (consoleLevel !== 'error' && this.shouldLog(consoleLevel, 'console')) {
             this.loggers[consoleLevel].error(logPayload);
         }
     }

package/lib/message-handler.d.ts

@@ -2,9 +2,6 @@
  * Message handler
  */
 declare class Messages {
-    private messages;
-    messageFilePath: any;
-    constructor();
     init(context: any): void;
     parse(messageKey: string, ...substitutions: Array<any>): string;
 }

package/lib/message-handler.js

@@ -3,32 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const fs_1 = tslib_1.__importDefault(require("fs"));
 const cli_error_1 = tslib_1.__importDefault(require("./cli-error"));
+const STORE_KEY = '__cs_messages__';
 /**
  * Message handler
  */
 class Messages {
-    constructor() {
-        this.messages = {};
-    }
     init(context) {
         if (!context.messageFilePath) {
             return;
         }
         try {
-            this.messages = JSON.parse(fs_1.default.readFileSync(context.messageFilePath, 'utf-8'));
+            const loaded = JSON.parse(fs_1.default.readFileSync(context.messageFilePath, 'utf-8'));
+            globalThis[STORE_KEY] = Object.assign(Object.assign({}, globalThis[STORE_KEY]), loaded);
         }
         catch (error) {
-            // create empty messages object if message file is not exist
-            if (error.code === 'ENOENT') {
-                this.messages = {};
-            }
-            else {
+            if (error.code !== 'ENOENT') {
                 throw new cli_error_1.default(`Error: ${error.message}`);
             }
         }
     }
     parse(messageKey, ...substitutions) {
-        const msg = this.messages[messageKey];
+        const store = globalThis[STORE_KEY] || {};
+        const msg = store[messageKey];
         if (!msg) {
             return messageKey;
         }

package/lib/progress-summary/cli-progress-manager.js

@@ -353,14 +353,19 @@ class CLIProgressManager {
             }
             if (!this.showConsoleLogs && process.progressBar) {
                 const totalProcessed = process.current;
-                const percentage = Math.round((totalProcessed / process.total) * 100);
+                // Reconcile the bar's total with the number of items actually processed so the
+                // rendered "value/total" matches the "Complete (success/processed)" summary. A
+                // process registered with an estimated total larger than the items actually ticked
+                // would otherwise render mismatched counts, e.g. "37/37 | Complete (27/27)".
+                process.progressBar.setTotal(totalProcessed);
+                const percentage = totalProcessed > 0 ? 100 : 0;
                 const formattedPercentage = this.formatPercentage(percentage);
                 const statusText = success
-                    ? (0, chalk_1.getChalk)().green(`✓ Complete (${process.successCount}/${process.current})`)
-                    : (0, chalk_1.getChalk)().red(`✗ Failed (${process.successCount}/${process.current})`);
+                    ? (0, chalk_1.getChalk)().green(`✓ Complete (${process.successCount}/${totalProcessed})`)
+                    : (0, chalk_1.getChalk)().red(`✗ Failed (${process.successCount}/${totalProcessed})`);
                 const displayName = this.formatProcessName(processName);
                 const indentedLabel = `  ├─ ${displayName}`.padEnd(25);
-                process.progressBar.update(process.total, {
+                process.progressBar.update(totalProcessed, {
                     label: success ? (0, chalk_1.getChalk)().green(indentedLabel) : (0, chalk_1.getChalk)().red(indentedLabel),
                     status: statusText,
                     percentage: formattedPercentage,

package/lib/region-endpoints.d.ts

@@ -0,0 +1,26 @@
+export interface RegionEndpoints {
+    [key: string]: string;
+}
+export interface CanonicalRegion {
+    name: string;
+    cma: string;
+    cda: string;
+    uiHost: string;
+    developerHubUrl: string;
+    launchHubUrl: string;
+    personalizeUrl: string;
+    composableStudioUrl: string;
+    csAssetsUrl?: string;
+    endpoints: RegionEndpoints;
+}
+/**
+ * Resolve the canonical endpoint set for a region name/alias via @contentstack/utils.
+ * Returns null when the name isn't a recognized region (e.g. a custom region name).
+ */
+export declare function resolveCanonicalEndpoints(name: string): RegionEndpoints | null;
+/**
+ * Build a region object from a raw endpoints map, keeping the existing named
+ * fields (cma/cda/uiHost/...) plus a full raw `endpoints` passthrough so any
+ * future endpoint Contentstack adds is available without further code changes.
+ */
+export declare function buildRegionFromEndpoints(name: string, endpoints: RegionEndpoints): CanonicalRegion;

package/lib/region-endpoints.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCanonicalEndpoints = resolveCanonicalEndpoints;
+exports.buildRegionFromEndpoints = buildRegionFromEndpoints;
+const utils_1 = require("@contentstack/utils");
+/**
+ * Resolve the canonical endpoint set for a region name/alias via @contentstack/utils.
+ * Returns null when the name isn't a recognized region (e.g. a custom region name).
+ */
+function resolveCanonicalEndpoints(name) {
+    try {
+        const endpoints = (0, utils_1.getContentstackEndpoint)(name);
+        if (!endpoints || typeof endpoints === 'string')
+            return null;
+        return endpoints;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+/**
+ * Build a region object from a raw endpoints map, keeping the existing named
+ * fields (cma/cda/uiHost/...) plus a full raw `endpoints` passthrough so any
+ * future endpoint Contentstack adds is available without further code changes.
+ */
+function buildRegionFromEndpoints(name, endpoints) {
+    return {
+        name,
+        cma: endpoints.contentManagement,
+        cda: endpoints.contentDelivery,
+        uiHost: endpoints.application,
+        developerHubUrl: endpoints.developerHub,
+        launchHubUrl: endpoints.launch,
+        personalizeUrl: endpoints.personalizeManagement,
+        composableStudioUrl: endpoints.composableStudio,
+        csAssetsUrl: endpoints.assetManagement,
+        endpoints,
+    };
+}

package/lib/region-refresh.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Self-heals the persisted region config on every CLI invocation so that
+ * customers who set their region on an older CLI version (before a field
+ * like authUrl existed) get it backfilled without re-running
+ * `csdx config:set:region`. Only named/built-in regions are touched — a
+ * custom region's name won't resolve via resolveCanonicalEndpoints, so it's
+ * left untouched. Never throws.
+ */
+export declare function refreshRegionEndpoints(): void;

package/lib/region-refresh.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshRegionEndpoints = refreshRegionEndpoints;
+const tslib_1 = require("tslib");
+const config_handler_1 = tslib_1.__importDefault(require("./config-handler"));
+const region_endpoints_1 = require("./region-endpoints");
+/**
+ * Self-heals the persisted region config on every CLI invocation so that
+ * customers who set their region on an older CLI version (before a field
+ * like authUrl existed) get it backfilled without re-running
+ * `csdx config:set:region`. Only named/built-in regions are touched — a
+ * custom region's name won't resolve via resolveCanonicalEndpoints, so it's
+ * left untouched. Never throws.
+ */
+function refreshRegionEndpoints() {
+    const stored = config_handler_1.default.get('region');
+    if (!(stored === null || stored === void 0 ? void 0 : stored.name))
+        return;
+    const endpoints = (0, region_endpoints_1.resolveCanonicalEndpoints)(stored.name);
+    if (!endpoints)
+        return;
+    const merged = Object.assign(Object.assign({}, stored), (0, region_endpoints_1.buildRegionFromEndpoints)(stored.name, endpoints));
+    if (JSON.stringify(merged) !== JSON.stringify(stored)) {
+        config_handler_1.default.set('region', merged);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/cli-utilities",
-  "version": "2.0.0-beta.9",
+  "version": "2.0.1",
   "description": "Utilities for contentstack projects",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -14,7 +14,8 @@
   },
   "repository": {
     "type": "git",
-    "url": ""
+    "url": "git+https://github.com/contentstack/cli.git",
+    "directory": "packages/contentstack-utilities"
   },
   "keywords": [
     "contentstack",
@@ -27,10 +28,11 @@
   "author": "contentstack",
   "license": "MIT",
   "dependencies": {
-    "@contentstack/management": "~1.30.3",
-    "@contentstack/marketplace-sdk": "^1.5.2",
-    "@oclif/core": "^4.11.4",
-    "axios": "^1.16.1",
+    "@contentstack/management": "~1.31.1",
+    "@contentstack/marketplace-sdk": "^1.5.4",
+    "@contentstack/utils": "~1.9.1",
+    "@oclif/core": "^4.11.14",
+    "axios": "^1.20.0",
     "chalk": "^5.6.2",
     "cli-cursor": "^3.1.0",
     "cli-progress": "^3.12.0",
@@ -41,39 +43,39 @@
     "inquirer": "12.11.1",
     "inquirer-search-checkbox": "^1.0.0",
     "inquirer-search-list": "^1.2.6",
-    "js-yaml": "^4.1.1",
+    "js-yaml": "^4.3.2",
     "klona": "^2.0.6",
     "lodash": "^4.18.1",
     "mkdirp": "^1.0.4",
     "open": "^8.4.2",
     "ora": "^5.4.1",
-    "papaparse": "^5.5.3",
+    "papaparse": "^5.5.4",
     "recheck": "~4.5.0",
     "rxjs": "^6.6.7",
     "traverse": "^0.6.11",
     "tty-table": "^4.2.3",
     "unique-string": "^2.0.0",
     "short-uuid": "^6.0.3",
-    "uuid": "^14.0.0",
+    "uuid": "^14.0.1",
     "winston": "^3.19.0",
     "xdg-basedir": "^4.0.0"
   },
   "overrides": {
     "@oclif/core": {
-      "picomatch": "^4.0.4"
+      "picomatch": "^4.0.7"
     }
   },
   "devDependencies": {
     "@types/chai": "^4.3.20",
-    "@types/inquirer": "^9.0.9",
+    "@types/inquirer": "^9.0.10",
     "@types/mkdirp": "^1.0.2",
     "@types/mocha": "^10.0.10",
     "@types/node": "^18.19.130",
-    "@types/sinon": "^21.0.0",
+    "@types/sinon": "^21.0.1",
     "@types/traverse": "^0.6.37",
     "chai": "^4.5.0",
-    "eslint": "^9.26.0",
-    "eslint-config-oclif": "^6.0.62",
+    "eslint": "^10.6.0",
+    "eslint-config-oclif": "^6.0.175",
     "eslint-config-oclif-typescript": "^3.1.14",
     "mocha": "10.8.2",
     "nyc": "^15.1.0",
@@ -82,4 +84,4 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   }
-}
+}