@contentstack/cli-utilities 2.0.0-beta.1 → 2.0.0-beta.11

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = require("../chalk");
 const ora_1 = tslib_1.__importDefault(require("ora"));
 const cli_progress_1 = tslib_1.__importDefault(require("cli-progress"));
 const summary_manager_1 = tslib_1.__importDefault(require("./summary-manager"));
@@ -46,11 +46,11 @@ class CLIProgressManager {
             return;
         const safeBranchName = branchName || 'main';
         const branchInfo = headerTitle || `${safeBranchName === null || safeBranchName === void 0 ? void 0 : safeBranchName.toUpperCase()} CONTENT`;
-        console.log('\n' + chalk_1.default.bold('='.repeat(80)));
+        console.log('\n' + (0, chalk_1.getChalk)().bold('='.repeat(80)));
         if (branchInfo) {
-            console.log(chalk_1.default.bold.white(`                   ${branchInfo}`));
+            console.log((0, chalk_1.getChalk)().bold.white(`                   ${branchInfo}`));
         }
-        console.log(chalk_1.default.bold('='.repeat(80)) + '\n');
+        console.log((0, chalk_1.getChalk)().bold('='.repeat(80)) + '\n');
     }
     /**
      * Print the final summary for all modules using strategies.
@@ -240,20 +240,20 @@ class CLIProgressManager {
             this.multiBar = new cli_progress_1.default.MultiBar({
                 clearOnComplete: false,
                 hideCursor: true,
-                format: ' {label} |' + chalk_1.default.cyan('{bar}') + '| {percentage}% | {value}/{total} | {status}',
+                format: ' {label} |' + (0, chalk_1.getChalk)().cyan('{bar}') + '| {percentage}% | {value}/{total} | {status}',
                 barCompleteChar: '\u2588',
                 barIncompleteChar: '\u2591',
             }, cli_progress_1.default.Presets.shades_classic);
             if (!this.showConsoleLogs) {
-                console.log(chalk_1.default.bold.cyan(`\n${this.moduleName}:`));
+                console.log((0, chalk_1.getChalk)().bold.cyan(`\n${this.moduleName}:`));
             }
         }
         else if (this.total > 0) {
             if (!this.showConsoleLogs) {
-                console.log(chalk_1.default.bold.cyan(`\n${this.moduleName}:`));
+                console.log((0, chalk_1.getChalk)().bold.cyan(`\n${this.moduleName}:`));
             }
             this.progressBar = new cli_progress_1.default.SingleBar({
-                format: ' {label} |' + chalk_1.default.cyan('{bar}') + '| {percentage}% | {value}/{total} | {status}',
+                format: ' {label} |' + (0, chalk_1.getChalk)().cyan('{bar}') + '| {percentage}% | {value}/{total} | {status}',
                 barCompleteChar: '\u2588',
                 barIncompleteChar: '\u2591',
                 hideCursor: true,
@@ -261,13 +261,13 @@ class CLIProgressManager {
             const formattedName = this.formatModuleName(this.moduleName);
             const displayName = formattedName.length > 20 ? formattedName.substring(0, 17) + '...' : formattedName;
             this.progressBar.start(this.total, 0, {
-                label: chalk_1.default.gray(`   └─ ${displayName}`.padEnd(25)),
-                status: chalk_1.default.gray('Starting...'),
+                label: (0, chalk_1.getChalk)().gray(`   └─ ${displayName}`.padEnd(25)),
+                status: (0, chalk_1.getChalk)().gray('Starting...'),
                 percentage: '  0',
             });
         }
         else {
-            this.spinner = (0, ora_1.default)(`${chalk_1.default.bold(this.moduleName)}: Processing...`).start();
+            this.spinner = (0, ora_1.default)(`${(0, chalk_1.getChalk)().bold(this.moduleName)}: Processing...`).start();
         }
     }
     /**
@@ -289,8 +289,8 @@ class CLIProgressManager {
             const displayName = this.formatProcessName(processName);
             const indentedLabel = `  ├─ ${displayName}`.padEnd(25);
             process.progressBar = this.multiBar.create(total, 0, {
-                label: chalk_1.default.gray(indentedLabel),
-                status: chalk_1.default.gray('Pending'),
+                label: (0, chalk_1.getChalk)().gray(indentedLabel),
+                status: (0, chalk_1.getChalk)().gray('Pending'),
                 percentage: '  0',
             });
         }
@@ -326,8 +326,8 @@ class CLIProgressManager {
                 const displayName = this.formatProcessName(processName);
                 const indentedLabel = `  ├─ ${displayName}`.padEnd(25);
                 process.progressBar.update(0, {
-                    label: chalk_1.default.yellow(indentedLabel),
-                    status: chalk_1.default.yellow('Processing'),
+                    label: (0, chalk_1.getChalk)().yellow(indentedLabel),
+                    status: (0, chalk_1.getChalk)().yellow('Processing'),
                     percentage: '  0',
                 });
             }
@@ -356,12 +356,12 @@ class CLIProgressManager {
                 const percentage = Math.round((totalProcessed / process.total) * 100);
                 const formattedPercentage = this.formatPercentage(percentage);
                 const statusText = success
-                    ? chalk_1.default.green(`✓ Complete (${process.successCount}/${process.current})`)
-                    : chalk_1.default.red(`✗ Failed (${process.successCount}/${process.current})`);
+                    ? (0, chalk_1.getChalk)().green(`✓ Complete (${process.successCount}/${process.current})`)
+                    : (0, chalk_1.getChalk)().red(`✗ Failed (${process.successCount}/${process.current})`);
                 const displayName = this.formatProcessName(processName);
                 const indentedLabel = `  ├─ ${displayName}`.padEnd(25);
                 process.progressBar.update(process.total, {
-                    label: success ? chalk_1.default.green(indentedLabel) : chalk_1.default.red(indentedLabel),
+                    label: success ? (0, chalk_1.getChalk)().green(indentedLabel) : (0, chalk_1.getChalk)().red(indentedLabel),
                     status: statusText,
                     percentage: formattedPercentage,
                 });
@@ -382,8 +382,8 @@ class CLIProgressManager {
                     const displayName = this.formatProcessName(processName);
                     const indentedLabel = `  ├─ ${displayName}`.padEnd(25);
                     process.progressBar.update(process.current, {
-                        label: chalk_1.default.yellow(indentedLabel),
-                        status: chalk_1.default.yellow(message),
+                        label: (0, chalk_1.getChalk)().yellow(indentedLabel),
+                        status: (0, chalk_1.getChalk)().yellow(message),
                         percentage: formattedPercentage,
                     });
                 }
@@ -394,13 +394,13 @@ class CLIProgressManager {
                 const formattedName = this.formatModuleName(this.moduleName);
                 const displayName = formattedName.length > 20 ? formattedName.substring(0, 17) + '...' : formattedName;
                 this.progressBar.update(this.progressBar.getProgress() * this.total, {
-                    label: chalk_1.default.yellow(`   └─ ${displayName}`.padEnd(25)),
-                    status: chalk_1.default.yellow(message),
+                    label: (0, chalk_1.getChalk)().yellow(`   └─ ${displayName}`.padEnd(25)),
+                    status: (0, chalk_1.getChalk)().yellow(message),
                     percentage: formattedPercentage,
                 });
             }
             else if (this.spinner) {
-                this.spinner.text = `${chalk_1.default.bold(this.moduleName)}: ${message}`;
+                this.spinner.text = `${(0, chalk_1.getChalk)().bold(this.moduleName)}: ${message}`;
             }
         }
         return this;
@@ -444,8 +444,8 @@ class CLIProgressManager {
                     const displayName = this.formatProcessName(targetProcess);
                     const indentedLabel = `  ├─ ${displayName}`.padEnd(25);
                     process.progressBar.increment(1, {
-                        label: chalk_1.default.cyan(indentedLabel),
-                        status: chalk_1.default.cyan(statusText),
+                        label: (0, chalk_1.getChalk)().cyan(indentedLabel),
+                        status: (0, chalk_1.getChalk)().cyan(statusText),
                         percentage: formattedPercentage,
                     });
                 }
@@ -461,10 +461,14 @@ class CLIProgressManager {
                     // Show completion status when finished, otherwise show running count
                     const statusText = totalProcessed >= this.total
                         ? this.failureCount === 0
-                            ? chalk_1.default.green(`✓ Complete (${this.successCount}/${totalProcessed})`)
-                            : chalk_1.default.yellow(`✓ Complete (${this.successCount}/${totalProcessed})`)
-                        : chalk_1.default.cyan(`${this.successCount}✓ ${this.failureCount}✗`);
-                    const labelColor = totalProcessed >= this.total ? (this.failureCount === 0 ? chalk_1.default.green : chalk_1.default.yellow) : chalk_1.default.cyan;
+                            ? (0, chalk_1.getChalk)().green(`✓ Complete (${this.successCount}/${totalProcessed})`)
+                            : (0, chalk_1.getChalk)().yellow(`✓ Complete (${this.successCount}/${totalProcessed})`)
+                        : (0, chalk_1.getChalk)().cyan(`${this.successCount}✓ ${this.failureCount}✗`);
+                    const labelColor = totalProcessed >= this.total
+                        ? this.failureCount === 0
+                            ? (0, chalk_1.getChalk)().green
+                            : (0, chalk_1.getChalk)().yellow
+                        : (0, chalk_1.getChalk)().cyan;
                     const formattedName = this.formatModuleName(this.moduleName);
                     const displayName = formattedName.length > 20 ? formattedName.substring(0, 17) + '...' : formattedName;
                     this.progressBar.increment(1, {
@@ -475,7 +479,7 @@ class CLIProgressManager {
                 }
                 else if (this.spinner) {
                     const total = this.successCount + this.failureCount;
-                    this.spinner.text = `${chalk_1.default.bold(this.moduleName)}: ${total} items (${this.successCount}✓ ${this.failureCount}✗)`;
+                    this.spinner.text = `${(0, chalk_1.getChalk)().bold(this.moduleName)}: ${total} items (${this.successCount}✓ ${this.failureCount}✗)`;
                 }
             }
         }
@@ -520,13 +524,13 @@ class CLIProgressManager {
         }
         if (!this.enableNestedProgress) {
             // Simple summary for single progress
-            this.log('\n' + chalk_1.default.bold(`${this.moduleName} Summary:`));
-            this.log(`✓ Success: ${chalk_1.default.green(this.successCount)}`);
-            this.log(`✗ Failures: ${chalk_1.default.red(this.failureCount)}`);
+            this.log('\n' + (0, chalk_1.getChalk)().bold(`${this.moduleName} Summary:`));
+            this.log(`✓ Success: ${(0, chalk_1.getChalk)().green(this.successCount)}`);
+            this.log(`✗ Failures: ${(0, chalk_1.getChalk)().red(this.failureCount)}`);
             return;
         }
         // Detailed summary for nested progress
-        this.log('\n' + chalk_1.default.bold(`${this.moduleName} Detailed Summary:`));
+        this.log('\n' + (0, chalk_1.getChalk)().bold(`${this.moduleName} Detailed Summary:`));
         for (const [processName, process] of this.processes) {
             const status = process.status === 'completed'
                 ? '✓'
@@ -546,5 +550,5 @@ class CLIProgressManager {
         return this.failureCount;
     }
 }
-exports.default = CLIProgressManager;
 CLIProgressManager.globalSummary = null;
+exports.default = CLIProgressManager;

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

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = require("../chalk");
 class SummaryManager {
     constructor({ operationName, context }) {
         this.modules = new Map();
@@ -83,16 +82,16 @@ class SummaryManager {
         const totalItems = Array.from(this.modules.values()).reduce((sum, m) => sum + m.successCount + m.failureCount, 0);
         const totalSuccess = Array.from(this.modules.values()).reduce((sum, m) => sum + m.successCount, 0);
         const totalFailures = Array.from(this.modules.values()).reduce((sum, m) => sum + m.failureCount, 0);
-        console.log('\n' + chalk_1.default.bold('='.repeat(80)));
-        console.log(chalk_1.default.bold(`${this.operationName} SUMMARY`));
-        console.log('\n' + chalk_1.default.bold('Overall Statistics:'));
-        console.log(`  Total ${this.operationName} Time: ${chalk_1.default.cyan(this.formatDuration(totalDuration))}`);
-        console.log(`  Modules Processed: ${chalk_1.default.cyan(completedModules)}/${chalk_1.default.cyan(totalModules)}`);
-        console.log(`  Items Processed: ${chalk_1.default.green(totalSuccess)} success, ${chalk_1.default.red(totalFailures)} failed of ${chalk_1.default.cyan(totalItems)} total`);
-        console.log(`  Success Rate: ${chalk_1.default.cyan(this.calculateSuccessRate(totalSuccess, totalItems))}%`);
+        console.log('\n' + (0, chalk_1.getChalk)().bold('='.repeat(80)));
+        console.log((0, chalk_1.getChalk)().bold(`${this.operationName} SUMMARY`));
+        console.log('\n' + (0, chalk_1.getChalk)().bold('Overall Statistics:'));
+        console.log(`  Total ${this.operationName} Time: ${(0, chalk_1.getChalk)().cyan(this.formatDuration(totalDuration))}`);
+        console.log(`  Modules Processed: ${(0, chalk_1.getChalk)().cyan(completedModules)}/${(0, chalk_1.getChalk)().cyan(totalModules)}`);
+        console.log(`  Items Processed: ${(0, chalk_1.getChalk)().green(totalSuccess)} success, ${(0, chalk_1.getChalk)().red(totalFailures)} failed of ${(0, chalk_1.getChalk)().cyan(totalItems)} total`);
+        console.log(`  Success Rate: ${(0, chalk_1.getChalk)().cyan(this.calculateSuccessRate(totalSuccess, totalItems))}%`);
         // Module Details
-        console.log('\n' + chalk_1.default.bold('Module Details:'));
-        console.log(chalk_1.default.gray('-'.repeat(80)));
+        console.log('\n' + (0, chalk_1.getChalk)().bold('Module Details:'));
+        console.log((0, chalk_1.getChalk)().gray('-'.repeat(80)));
         Array.from(this.modules.values()).forEach((module) => {
             const status = this.getStatusIcon(module.status);
             const totalCount = module.successCount + module.failureCount;
@@ -104,18 +103,18 @@ class SummaryManager {
                 `${duration.padStart(8)}`);
         });
         // Final Status
-        console.log('\n' + chalk_1.default.bold('Final Status:'));
+        console.log('\n' + (0, chalk_1.getChalk)().bold('Final Status:'));
         if (!this.hasFailures() && failedModules === 0) {
-            console.log(chalk_1.default.bold.green(`✅ ${this.operationName} completed successfully!`));
+            console.log((0, chalk_1.getChalk)().bold.green(`✅ ${this.operationName} completed successfully!`));
         }
         else if (this.hasFailures() || failedModules > 0) {
-            console.log(chalk_1.default.bold.yellow(`⚠️ ${this.operationName} completed with failures, see the logs for more details.`));
+            console.log((0, chalk_1.getChalk)().bold.yellow(`⚠️ ${this.operationName} completed with failures, see the logs for more details.`));
         }
         else {
-            console.log(chalk_1.default.bold.red(`❌ ${this.operationName} failed`));
+            console.log((0, chalk_1.getChalk)().bold.red(`❌ ${this.operationName} failed`));
         }
-        console.log(chalk_1.default.bold('='.repeat(80)));
-        console.log(chalk_1.default.bold('='.repeat(80)));
+        console.log((0, chalk_1.getChalk)().bold('='.repeat(80)));
+        console.log((0, chalk_1.getChalk)().bold('='.repeat(80)));
         // Simple failure summary with log reference
         this.printFailureSummaryWithLogReference();
     }
@@ -129,36 +128,37 @@ class SummaryManager {
         const modulesWithFailures = Array.from(this.modules.values()).filter((m) => m.failures.length > 0);
         if (modulesWithFailures.length === 0)
             return;
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars -- kept for future session log path / totals UX
         const totalFailures = modulesWithFailures.reduce((sum, m) => sum + m.failures.length, 0);
-        console.log('\n' + chalk_1.default.bold.red('Failure Summary:'));
-        console.log(chalk_1.default.red('-'.repeat(50)));
+        console.log('\n' + (0, chalk_1.getChalk)().bold.red('Failure Summary:'));
+        console.log((0, chalk_1.getChalk)().red('-'.repeat(50)));
         modulesWithFailures.forEach((module) => {
-            console.log(`${chalk_1.default.bold.red('✗')} ${chalk_1.default.bold(module.name)}: ${chalk_1.default.red(module.failures.length)} failures`);
+            console.log(`${(0, chalk_1.getChalk)().bold.red('✗')} ${(0, chalk_1.getChalk)().bold(module.name)}: ${(0, chalk_1.getChalk)().red(module.failures.length)} failures`);
             // Show just first 2-3 failures briefly
             const preview = module.failures.slice(0, 2);
             preview.forEach((failure) => {
-                console.log(`    • ${chalk_1.default.gray(failure.item)}`);
+                console.log(`    • ${(0, chalk_1.getChalk)().gray(failure.item)}`);
             });
             if (module.failures.length > 2) {
-                console.log(`    ${chalk_1.default.gray(`... and ${module.failures.length - 2} more`)}`);
+                console.log(`    ${(0, chalk_1.getChalk)().gray(`... and ${module.failures.length - 2} more`)}`);
             }
         });
-        console.log(chalk_1.default.blue('\n📋 For detailed error information, check the log files:'));
-        //console.log(chalk.blue(`   ${getSessionLogPath()}`));
-        console.log(chalk_1.default.gray('   Recent errors are logged with full context and stack traces.'));
+        console.log((0, chalk_1.getChalk)().blue('\n📋 For detailed error information, check the log files:'));
+        //console.log(getChalk().blue(`   ${getSessionLogPath()}`));
+        console.log((0, chalk_1.getChalk)().gray('   Recent errors are logged with full context and stack traces.'));
     }
     getStatusIcon(status) {
         switch (status) {
             case 'completed':
-                return chalk_1.default.green('✓');
+                return (0, chalk_1.getChalk)().green('✓');
             case 'failed':
-                return chalk_1.default.red('✗');
+                return (0, chalk_1.getChalk)().red('✗');
             case 'running':
-                return chalk_1.default.yellow('●');
+                return (0, chalk_1.getChalk)().yellow('●');
             case 'pending':
-                return chalk_1.default.gray('○');
+                return (0, chalk_1.getChalk)().gray('○');
             default:
-                return chalk_1.default.gray('?');
+                return (0, chalk_1.getChalk)().gray('?');
         }
     }
     formatDuration(ms) {

package/lib/proxy-helper.d.ts

@@ -8,10 +8,51 @@ export interface ProxyConfig {
     };
 }
 /**
- * Get proxy configuration with priority: Environment variables > Global config
+ * Parse NO_PROXY / no_proxy env (both uppercase and lowercase).
+ * NO_PROXY has priority over HTTP_PROXY/HTTPS_PROXY: hosts in this list never use the proxy.
+ * Values are hostnames only, comma-separated; leading dot matches subdomains (e.g. .contentstack.io).
+ * The bypass list is fully dynamic: only env values are used (no hardcoded default).
+ * @returns List of trimmed entries, or empty array when NO_PROXY/no_proxy is unset
+ */
+export declare function getNoProxyList(): string[];
+/**
+ * Check if the given host should bypass the proxy based on NO_PROXY / no_proxy.
+ * Supports: exact host, leading-dot subdomain match (e.g. .contentstack.io), and wildcard *.
+ * @param host - Request hostname (with or without port; will be normalized)
+ * @returns true if proxy should not be used for this host
+ */
+export declare function shouldBypassProxy(host: string): boolean;
+/**
+ * Get proxy configuration. Priority order (per spec):
+ * 1. Global CLI config from `csdx config:set:proxy --host <host> --port <port> --protocol <protocol>`
+ * 2. Environment variables (HTTPS_PROXY or HTTP_PROXY)
+ * For per-request use, prefer getProxyConfigForHost(host) so NO_PROXY overrides both sources.
  * @returns ProxyConfig object or undefined if no proxy is configured
  */
 export declare function getProxyConfig(): ProxyConfig | undefined;
+/**
+ * Get proxy config only when the request host is not in NO_PROXY.
+ * NO_PROXY has priority over both HTTP_PROXY/HTTPS_PROXY and over proxy set via
+ * `csdx config:set:proxy` — if the host matches NO_PROXY, no proxy is used.
+ * Use this for all outbound requests so Contentstack and localhost bypass the proxy when set.
+ * @param host - Request hostname (e.g. api.contentstack.io or full URL like https://api.contentstack.io)
+ * @returns ProxyConfig or undefined if proxy is disabled or host should bypass (NO_PROXY)
+ */
+export declare function getProxyConfigForHost(host: string): ProxyConfig | undefined;
+/**
+ * Hostname for NO_PROXY / proxy. Prefer `region.cma` when set so callers that pass a
+ * default SDK host (e.g. bulk-entries -> api.contentstack.io) still match rules like
+ * `.csnonprod.com` against the real API host (e.g. dev11-api.csnonprod.com).
+ */
+export declare function resolveRequestHost(config: {
+    host?: string;
+}): string;
+/**
+ * Temporarily clear proxy-related env vars so SDK/axios cannot use them.
+ * Call the returned function to restore. Use when creating a client for a host in NO_PROXY.
+ * @returns Restore function (call to put env back)
+ */
+export declare function clearProxyEnv(): () => void;
 /**
  * Check if proxy is configured (from any source)
  * @returns true if proxy is configured, false otherwise

package/lib/proxy-helper.js

@@ -1,41 +1,100 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProxyUrl = exports.hasProxy = exports.getProxyConfig = void 0;
+exports.getNoProxyList = getNoProxyList;
+exports.shouldBypassProxy = shouldBypassProxy;
+exports.getProxyConfig = getProxyConfig;
+exports.getProxyConfigForHost = getProxyConfigForHost;
+exports.resolveRequestHost = resolveRequestHost;
+exports.clearProxyEnv = clearProxyEnv;
+exports.hasProxy = hasProxy;
+exports.getProxyUrl = getProxyUrl;
 const tslib_1 = require("tslib");
 const config_handler_1 = tslib_1.__importDefault(require("./config-handler"));
 /**
- * Get proxy configuration with priority: Environment variables > Global config
- * @returns ProxyConfig object or undefined if no proxy is configured
+ * Parse NO_PROXY / no_proxy env (both uppercase and lowercase).
+ * NO_PROXY has priority over HTTP_PROXY/HTTPS_PROXY: hosts in this list never use the proxy.
+ * Values are hostnames only, comma-separated; leading dot matches subdomains (e.g. .contentstack.io).
+ * The bypass list is fully dynamic: only env values are used (no hardcoded default).
+ * @returns List of trimmed entries, or empty array when NO_PROXY/no_proxy is unset
  */
-function getProxyConfig() {
-    // Priority 1: Check environment variables (HTTPS_PROXY or HTTP_PROXY)
-    const proxyUrl = process.env.HTTPS_PROXY || process.env.HTTP_PROXY;
-    if (proxyUrl) {
+function getNoProxyList() {
+    const raw = process.env.NO_PROXY || process.env.no_proxy || '';
+    return raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Normalize host for NO_PROXY matching: strip protocol/URL, port, lowercase, handle IPv6 brackets.
+ * Accepts hostname, host:port, or full URL (e.g. https://api.contentstack.io).
+ */
+function normalizeHost(host) {
+    if (!host || typeof host !== 'string')
+        return '';
+    let h = host.trim().toLowerCase();
+    // If it looks like a URL, extract hostname so NO_PROXY matching works (e.g. region.cma is full URL)
+    if (h.includes('://')) {
         try {
-            const url = new URL(proxyUrl);
-            const defaultPort = url.protocol === 'https:' ? 443 : 80;
-            const port = url.port ? Number.parseInt(url.port, 10) : defaultPort;
-            if (!Number.isNaN(port) && port >= 1 && port <= 65535) {
-                const protocol = url.protocol.replace(':', '');
-                const proxyConfig = {
-                    protocol: protocol,
-                    host: url.hostname,
-                    port: port,
-                };
-                if (url.username || url.password) {
-                    proxyConfig.auth = {
-                        username: url.username,
-                        password: url.password,
-                    };
-                }
-                return proxyConfig;
-            }
+            const u = new URL(h);
+            h = u.hostname;
         }
         catch (_a) {
-            // Invalid URL, continue to check global config
+            // fall through to port stripping below
+        }
+    }
+    const portIdx = h.lastIndexOf(':');
+    if (h.startsWith('[')) {
+        const close = h.indexOf(']');
+        if (close !== -1 && h.length > close + 1 && h[close + 1] === ':') {
+            h = h.slice(1, close);
+        }
+    }
+    else if (portIdx !== -1) {
+        const after = h.slice(portIdx + 1);
+        if (/^\d+$/.test(after)) {
+            h = h.slice(0, portIdx);
+        }
+    }
+    return h;
+}
+/**
+ * Check if the given host should bypass the proxy based on NO_PROXY / no_proxy.
+ * Supports: exact host, leading-dot subdomain match (e.g. .contentstack.io), and wildcard *.
+ * @param host - Request hostname (with or without port; will be normalized)
+ * @returns true if proxy should not be used for this host
+ */
+function shouldBypassProxy(host) {
+    const normalized = normalizeHost(host);
+    if (!normalized)
+        return false;
+    const list = getNoProxyList();
+    for (const entry of list) {
+        const e = entry.trim().toLowerCase();
+        if (!e)
+            continue;
+        if (e === '*')
+            return true;
+        if (e.startsWith('.')) {
+            const domain = e.slice(1);
+            if (normalized === domain || normalized.endsWith(e))
+                return true;
+        }
+        else {
+            if (normalized === e)
+                return true;
         }
     }
-    // Priority 2: Check global config store
+    return false;
+}
+/**
+ * Get proxy configuration. Priority order (per spec):
+ * 1. Global CLI config from `csdx config:set:proxy --host <host> --port <port> --protocol <protocol>`
+ * 2. Environment variables (HTTPS_PROXY or HTTP_PROXY)
+ * For per-request use, prefer getProxyConfigForHost(host) so NO_PROXY overrides both sources.
+ * @returns ProxyConfig object or undefined if no proxy is configured
+ */
+function getProxyConfig() {
+    // Priority 1: Global config (csdx config:set:proxy)
     const globalProxyConfig = config_handler_1.default.get('proxy');
     if (globalProxyConfig) {
         if (typeof globalProxyConfig === 'object') {
@@ -65,14 +124,108 @@ function getProxyConfig() {
                     return proxyConfig;
                 }
             }
-            catch (_b) {
-                // Invalid URL, return undefined
+            catch (_a) {
+                // Invalid URL, continue to check environment
+            }
+        }
+    }
+    // Priority 2: Environment variables (HTTPS_PROXY or HTTP_PROXY)
+    const proxyUrl = process.env.HTTPS_PROXY || process.env.HTTP_PROXY;
+    if (proxyUrl) {
+        try {
+            const url = new URL(proxyUrl);
+            const defaultPort = url.protocol === 'https:' ? 443 : 80;
+            const port = url.port ? Number.parseInt(url.port, 10) : defaultPort;
+            if (!Number.isNaN(port) && port >= 1 && port <= 65535) {
+                const protocol = url.protocol.replace(':', '');
+                const proxyConfig = {
+                    protocol: protocol,
+                    host: url.hostname,
+                    port: port,
+                };
+                if (url.username || url.password) {
+                    proxyConfig.auth = {
+                        username: url.username,
+                        password: url.password,
+                    };
+                }
+                return proxyConfig;
             }
         }
+        catch (_b) {
+            // Invalid URL, return undefined
+        }
     }
     return undefined;
 }
-exports.getProxyConfig = getProxyConfig;
+/**
+ * Get proxy config only when the request host is not in NO_PROXY.
+ * NO_PROXY has priority over both HTTP_PROXY/HTTPS_PROXY and over proxy set via
+ * `csdx config:set:proxy` — if the host matches NO_PROXY, no proxy is used.
+ * Use this for all outbound requests so Contentstack and localhost bypass the proxy when set.
+ * @param host - Request hostname (e.g. api.contentstack.io or full URL like https://api.contentstack.io)
+ * @returns ProxyConfig or undefined if proxy is disabled or host should bypass (NO_PROXY)
+ */
+function getProxyConfigForHost(host) {
+    if (shouldBypassProxy(host))
+        return undefined;
+    return getProxyConfig();
+}
+function regionCmaHostname() {
+    var _a;
+    const cma = (_a = config_handler_1.default.get('region')) === null || _a === void 0 ? void 0 : _a.cma;
+    if (!cma || typeof cma !== 'string') {
+        return '';
+    }
+    if (cma.startsWith('http')) {
+        try {
+            const u = new URL(cma);
+            return u.hostname || cma;
+        }
+        catch (_b) {
+            return cma;
+        }
+    }
+    return cma;
+}
+/**
+ * Hostname for NO_PROXY / proxy. Prefer `region.cma` when set so callers that pass a
+ * default SDK host (e.g. bulk-entries -> api.contentstack.io) still match rules like
+ * `.csnonprod.com` against the real API host (e.g. dev11-api.csnonprod.com).
+ */
+function resolveRequestHost(config) {
+    var _a;
+    const fromRegion = regionCmaHostname();
+    if (fromRegion) {
+        return normalizeHost(fromRegion) || fromRegion;
+    }
+    const raw = ((_a = config.host) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+    if (!raw) {
+        return '';
+    }
+    return normalizeHost(raw) || raw;
+}
+/**
+ * Temporarily clear proxy-related env vars so SDK/axios cannot use them.
+ * Call the returned function to restore. Use when creating a client for a host in NO_PROXY.
+ * @returns Restore function (call to put env back)
+ */
+function clearProxyEnv() {
+    const saved = {};
+    const keys = ['HTTP_PROXY', 'HTTPS_PROXY', 'http_proxy', 'https_proxy', 'ALL_PROXY', 'all_proxy'];
+    for (const k of keys) {
+        if (k in process.env) {
+            saved[k] = process.env[k];
+            delete process.env[k];
+        }
+    }
+    return () => {
+        for (const k of keys) {
+            if (saved[k] !== undefined)
+                process.env[k] = saved[k];
+        }
+    };
+}
 /**
  * Check if proxy is configured (from any source)
  * @returns true if proxy is configured, false otherwise
@@ -80,7 +233,6 @@ exports.getProxyConfig = getProxyConfig;
 function hasProxy() {
     return !!getProxyConfig() || !!process.env.HTTPS_PROXY || !!process.env.HTTP_PROXY || !!config_handler_1.default.get('proxy');
 }
-exports.hasProxy = hasProxy;
 /**
  * Get proxy URL string for display purposes
  * @returns Proxy URL string or 'proxy server' if not available
@@ -100,4 +252,3 @@ function getProxyUrl() {
     }
     return 'proxy server';
 }
-exports.getProxyUrl = getProxyUrl;