Function resolveSocksProxy

packages/agent-core/src/utils/proxy.ts:86–114

(env: Env = process.env)

 * `HTTPS_PROXY`, then `HTTP_PROXY`. `socks://` is an alias for `socks5://`.
 */
export function resolveSocksProxy(env: Env = process.env): SocksProxyConfig | undefined {
  const candidates = [
    firstNonBlank(env, ['all_proxy', 'ALL_PROXY']),
    firstNonBlank(env, ['https_proxy', 'HTTPS_PROXY']),
    firstNonBlank(env, ['http_proxy', 'HTTP_PROXY']),
  ];
  for (const value of candidates) {
    if (value === undefined) continue;
    const scheme = schemeOf(value);
    if (scheme === undefined || !SOCKS_SCHEMES.has(scheme)) continue;
    let url: URL;
    try {
      url = new URL(value);
    } catch {
      continue;
    }
    const config: SocksProxyConfig = {
      type: scheme === 'socks4' || scheme === 'socks4a' ? 4 : 5,
      // Strip IPv6 brackets: the `socks` client wants the bare address (`::1`),
      // not the URL's bracketed `[::1]`, which it would treat as a hostname.
      host: url.hostname.replaceAll(/^\[|\]$/g, ''),
      port: url.port ? Number(url.port) : 1080,
      ...(url.username ? { userId: decodeURIComponent(url.username) } : {}),
      ...(url.password ? { password: decodeURIComponent(url.password) } : {}),
    };
    return config;
  }
  return undefined;
}

/** True when any HTTP(S) or SOCKS proxy variable is set to a usable value. */
export function isProxyConfigured(env: Env = process.env): boolean {