@@ -11,11 +11,84 @@ export interface ProxyConfig {
1111}
1212
1313/**
14- * Get proxy configuration with priority: Environment variables > Global config
14+ * Parse NO_PROXY / no_proxy env (both uppercase and lowercase).
15+ * NO_PROXY has priority over HTTP_PROXY/HTTPS_PROXY: hosts in this list never use the proxy.
16+ * Values are hostnames only, comma-separated; leading dot matches subdomains (e.g. .contentstack.io).
17+ * The bypass list is fully dynamic: only env values are used (no hardcoded default).
18+ * @returns List of trimmed entries, or empty array when NO_PROXY/no_proxy is unset
19+ */
20+ export function getNoProxyList ( ) : string [ ] {
21+ const raw = process . env . NO_PROXY || process . env . no_proxy || '' ;
22+ return raw
23+ . split ( ',' )
24+ . map ( ( s ) => s . trim ( ) )
25+ . filter ( Boolean ) ;
26+ }
27+
28+ /**
29+ * Normalize host for NO_PROXY matching: strip protocol/URL, port, lowercase, handle IPv6 brackets.
30+ * Accepts hostname, host:port, or full URL (e.g. https://api.contentstack.io).
31+ */
32+ function normalizeHost ( host : string ) : string {
33+ if ( ! host || typeof host !== 'string' ) return '' ;
34+ let h = host . trim ( ) . toLowerCase ( ) ;
35+ // If it looks like a URL, extract hostname so NO_PROXY matching works (e.g. region.cma is full URL)
36+ if ( h . includes ( '://' ) ) {
37+ try {
38+ const u = new URL ( h ) ;
39+ h = u . hostname ;
40+ } catch {
41+ // fall through to port stripping below
42+ }
43+ }
44+ const portIdx = h . lastIndexOf ( ':' ) ;
45+ if ( h . startsWith ( '[' ) ) {
46+ const close = h . indexOf ( ']' ) ;
47+ if ( close !== - 1 && h . length > close + 1 && h [ close + 1 ] === ':' ) {
48+ h = h . slice ( 1 , close ) ;
49+ }
50+ } else if ( portIdx !== - 1 ) {
51+ const after = h . slice ( portIdx + 1 ) ;
52+ if ( / ^ \d + $ / . test ( after ) ) {
53+ h = h . slice ( 0 , portIdx ) ;
54+ }
55+ }
56+ return h ;
57+ }
58+
59+ /**
60+ * Check if the given host should bypass the proxy based on NO_PROXY / no_proxy.
61+ * Supports: exact host, leading-dot subdomain match (e.g. .contentstack.io), and wildcard *.
62+ * @param host - Request hostname (with or without port; will be normalized)
63+ * @returns true if proxy should not be used for this host
64+ */
65+ export function shouldBypassProxy ( host : string ) : boolean {
66+ const normalized = normalizeHost ( host ) ;
67+ if ( ! normalized ) return false ;
68+
69+ const list = getNoProxyList ( ) ;
70+ for ( const entry of list ) {
71+ const e = entry . trim ( ) . toLowerCase ( ) ;
72+ if ( ! e ) continue ;
73+ if ( e === '*' ) return true ;
74+ if ( e . startsWith ( '.' ) ) {
75+ const domain = e . slice ( 1 ) ;
76+ if ( normalized === domain || normalized . endsWith ( e ) ) return true ;
77+ } else {
78+ if ( normalized === e ) return true ;
79+ }
80+ }
81+ return false ;
82+ }
83+
84+ /**
85+ * Get proxy configuration. Sources (in order): env (HTTP_PROXY/HTTPS_PROXY), then global config
86+ * from `csdx config:set:proxy --host <host> --port <port> --protocol <protocol>`.
87+ * For per-request use, prefer getProxyConfigForHost(host) so NO_PROXY overrides both sources.
1588 * @returns ProxyConfig object or undefined if no proxy is configured
1689 */
1790export function getProxyConfig ( ) : ProxyConfig | undefined {
18- // Priority 1: Check environment variables (HTTPS_PROXY or HTTP_PROXY)
91+ // Priority 1: Environment variables (HTTPS_PROXY or HTTP_PROXY)
1992 const proxyUrl = process . env . HTTPS_PROXY || process . env . HTTP_PROXY ;
2093
2194 if ( proxyUrl ) {
@@ -46,7 +119,7 @@ export function getProxyConfig(): ProxyConfig | undefined {
46119 }
47120 }
48121
49- // Priority 2: Check global config store
122+ // Priority 2: Global config (csdx config:set:proxy)
50123 const globalProxyConfig = configStore . get ( 'proxy' ) ;
51124 if ( globalProxyConfig ) {
52125 if ( typeof globalProxyConfig === 'object' ) {
@@ -86,6 +159,63 @@ export function getProxyConfig(): ProxyConfig | undefined {
86159 return undefined ;
87160}
88161
162+ /**
163+ * Get proxy config only when the request host is not in NO_PROXY.
164+ * NO_PROXY has priority over both HTTP_PROXY/HTTPS_PROXY and over proxy set via
165+ * `csdx config:set:proxy` — if the host matches NO_PROXY, no proxy is used.
166+ * Use this for all outbound requests so Contentstack and localhost bypass the proxy when set.
167+ * @param host - Request hostname (e.g. api.contentstack.io or full URL like https://api.contentstack.io)
168+ * @returns ProxyConfig or undefined if proxy is disabled or host should bypass (NO_PROXY)
169+ */
170+ export function getProxyConfigForHost ( host : string ) : ProxyConfig | undefined {
171+ if ( shouldBypassProxy ( host ) ) return undefined ;
172+ return getProxyConfig ( ) ;
173+ }
174+
175+ /**
176+ * Resolve request host for proxy/NO_PROXY checks: config.host or default CMA from region.
177+ * Use when the caller may omit host so NO_PROXY still applies (e.g. from region.cma).
178+ * @param config - Object with optional host (e.g. API client config)
179+ * @returns Host string (hostname or empty)
180+ */
181+ export function resolveRequestHost ( config : { host ?: string } ) : string {
182+ if ( config . host ) return config . host ;
183+ const cma = configStore . get ( 'region' ) ?. cma ;
184+ if ( cma && typeof cma === 'string' ) {
185+ if ( cma . startsWith ( 'http' ) ) {
186+ try {
187+ const u = new URL ( cma ) ;
188+ return u . hostname || cma ;
189+ } catch {
190+ return cma ;
191+ }
192+ }
193+ return cma ;
194+ }
195+ return '' ;
196+ }
197+
198+ /**
199+ * Temporarily clear proxy-related env vars so SDK/axios cannot use them.
200+ * Call the returned function to restore. Use when creating a client for a host in NO_PROXY.
201+ * @returns Restore function (call to put env back)
202+ */
203+ export function clearProxyEnv ( ) : ( ) => void {
204+ const saved : Record < string , string | undefined > = { } ;
205+ const keys = [ 'HTTP_PROXY' , 'HTTPS_PROXY' , 'http_proxy' , 'https_proxy' , 'ALL_PROXY' , 'all_proxy' ] ;
206+ for ( const k of keys ) {
207+ if ( k in process . env ) {
208+ saved [ k ] = process . env [ k ] ;
209+ delete process . env [ k ] ;
210+ }
211+ }
212+ return ( ) => {
213+ for ( const k of keys ) {
214+ if ( saved [ k ] !== undefined ) process . env [ k ] = saved [ k ] ;
215+ }
216+ } ;
217+ }
218+
89219/**
90220 * Check if proxy is configured (from any source)
91221 * @returns true if proxy is configured, false otherwise
0 commit comments