feat(server): add global httpProxy config + HQ audio format tags

feat(server): global httpProxy config
  config.default.js
    - Add server.httpProxy block (enabled, url, username, password)
  src/typings/config/config.types.ts
    - ServerConfig: add httpProxy? field with JSDoc
  src/typings/utils.types.ts
    - NodelinkRuntime: add options?.server?.httpProxy field
  src/utils.ts
    - makeRequest(): fall back to server.httpProxy when no
      per-request proxy is set (HttpProxyConfig already imported)
  src/index.ts
    - Import makeRequest from utils
    - constructor(): log proxy URL + call _testProxyConnectivity()
    - Add _testProxyConnectivity(): probes generate_204 (non-fatal)

feat(youtube): add HQ audio format tags 774 and 141
  src/sources/youtube/common.ts
    - _getQualityPriority(): add itag 774 (Opus ~260-360 kbps) and
      141 (AAC 256 kbps) at the top of high/medium priority lists
    - These formats require a valid cookiePath to be served by YouTube

Author: dripink

config.default.js

@@ -3,7 +3,13 @@ export default {
     host: '0.0.0.0',
     port: 3000,
     password: 'youshallnotpass',
-    useBunServer: false // set to true to use Bun.serve websocket (experimental)
+    useBunServer: false, // set to true to use Bun.serve websocket (experimental)
+    httpProxy: {
+      enabled: false, // route all outbound HTTP requests through a proxy
+      url: '', // e.g. 'http://user:pass@host:3128' or 'socks5://host:1080'
+      username: '', // Optional — overrides credentials in the URL
+      password: '' // Optional — overrides credentials in the URL
+    }
   },
   cluster: {
     enabled: true, // active cluster (or use env CLUSTER_ENABLED)

src/index.ts

@@ -19,6 +19,7 @@ import {
   getVersion,
   initLogger,
   logger,
+  makeRequest,
   parseClient,
   verifyDiscordID
 } from './utils.ts'
@@ -595,6 +596,34 @@ class NodelinkServer extends EventEmitter {
       'Server',
       `git branch: ${this.gitInfo.branch}, commit: ${this.gitInfo.commit}, committed on: ${new Date(this.gitInfo.commitTime).toISOString()}`
     )
+
+    // [feat] global-http-proxy: log proxy status and test connectivity at startup
+    const proxyCfg = options?.server?.httpProxy
+    if (proxyCfg?.enabled && proxyCfg.url) {
+      logger('info', 'Proxy', `HTTP proxy enabled: ${proxyCfg.url}`)
+      this._testProxyConnectivity(proxyCfg.url)
+    }
+  }
+
+  /**
+   * Tests HTTP proxy connectivity at startup by probing a known endpoint.
+   * Logs success or failure without throwing — a failed probe is non-fatal.
+   * @internal
+   */
+  private _testProxyConnectivity(proxyUrl: string): void {
+    makeRequest('http://connectivitycheck.gstatic.com/generate_204', {
+      proxy: { url: proxyUrl }
+    })
+      .then(() => {
+        logger('info', 'Proxy', `Connected successfully via ${proxyUrl}`)
+      })
+      .catch((err: Error) => {
+        logger(
+          'warn',
+          'Proxy',
+          `Proxy connectivity check failed (${proxyUrl}): ${err.message}`
+        )
+      })
   }
 
   /**

src/sources/youtube/common.ts

@@ -3111,9 +3111,12 @@ export abstract class BaseClient {
    * @internal
    */
   _getQualityPriority(): Record<string, number[]> {
+    // 774 = Opus ~260-360 kbps (premium HQ audio)
+    // 141 = AAC 256 kbps (premium HQ audio, non-Opus fallback)
+    // These are only served to authenticated/premium accounts (requires cookiePath).
     return {
-      high: [251, 250, 140],
-      medium: [250, 140],
+      high: [774, 141, 251, 250, 140],
+      medium: [141, 251, 250, 140],
       low: [249, 250, 140],
       lowest: [249, 139]
     }

src/typings/config/config.types.ts

@@ -32,6 +32,19 @@ export interface ServerConfig {
    * @experimental
    */
   useBunServer?: boolean
+
+  /**
+   * Global HTTP proxy applied to all outbound requests from NodeLink.
+   * When enabled, every call to makeRequest() will be routed through
+   * the proxy unless the request already specifies its own proxy.
+   * Supports http, https, and socks5 proxy URLs.
+   */
+  httpProxy?: {
+    enabled: boolean
+    url: string
+    username?: string
+    password?: string
+  }
 }
 
 /**

src/typings/utils.types.ts

@@ -353,6 +353,17 @@ export interface NodelinkRuntime {
   routePlanner?: RoutePlannerRuntime
   /** Optional stats manager instance. */
   statsManager?: StatsManager
+  /** Global HTTP proxy server options. */
+  options?: {
+    server?: {
+      httpProxy?: {
+        enabled: boolean
+        url: string
+        username?: string
+        password?: string
+      }
+    }
+  }
 }
 
 /**

src/utils.ts

@@ -1658,6 +1658,17 @@ async function makeRequest(
     return http1makeRequest(urlString, options)
   }
 
+  // [feat] global-http-proxy: fall back to server-wide proxy when no per-request proxy is set
+  const globalProxyCfg = finalNodeLink?.options?.server?.httpProxy
+  if (globalProxyCfg?.enabled && globalProxyCfg.url) {
+    const globalProxy: HttpProxyConfig = {
+      url: globalProxyCfg.url,
+      username: globalProxyCfg.username,
+      password: globalProxyCfg.password
+    }
+    return http1makeRequest(urlString, { ...options, proxy: globalProxy })
+  }
+
   const localAddress = finalNodeLink?.routePlanner?.getIP?.() ?? undefined
 
   try {