feat(http): add headers support to Clash HTTP/HTTPS proxies

- Add headers field output to getClashNodes for HTTP and HTTPS proxy types
- Parse headers from Clash configuration input in ClashProvider
- Update username/password to conditionally include in output when present
- Add comprehensive test coverage for HTTP/HTTPS proxies with and without headers

Also handles optional username/password fields from validators change.

Fixes #321 (part 2/2)

Author: geekdada

src/provider/ClashProvider.ts

@@ -462,6 +462,7 @@ export const parseClashConfig = (
               port: item.port,
               username: item.username /* istanbul ignore next */ || '',
               password: item.password /* istanbul ignore next */ || '',
+              ...(item.headers ? { headers: item.headers } : null),
             } as HttpNodeConfig
           }
 
@@ -474,6 +475,7 @@ export const parseClashConfig = (
             password: item.password || '',
             tls13: tls13 ?? false,
             skipCertVerify: item['skip-cert-verify'] === true,
+            ...(item.headers ? { headers: item.headers } : null),
           } as HttpsNodeConfig
 
         case 'snell':

src/utils/__tests__/clash.test.ts

@@ -1204,3 +1204,111 @@ test('getClashNodes', async (t) => {
     ],
   )
 })
+
+test('getClashNodes - HTTP/HTTPS with headers', async (t) => {
+  t.deepEqual(
+    clash.getClashNodes([
+      {
+        type: NodeTypeEnum.HTTP,
+        nodeName: 'HTTP Proxy',
+        hostname: '1.1.1.1',
+        port: 8080,
+        username: 'user',
+        password: 'pass',
+        headers: {
+          'X-Custom': 'value',
+          Host: 'example.com',
+        },
+      },
+    ]),
+    [
+      {
+        type: 'http',
+        name: 'HTTP Proxy',
+        server: '1.1.1.1',
+        port: 8080,
+        username: 'user',
+        password: 'pass',
+        headers: {
+          'X-Custom': 'value',
+          Host: 'example.com',
+        },
+      },
+    ],
+  )
+
+  t.deepEqual(
+    clash.getClashNodes([
+      {
+        type: NodeTypeEnum.HTTP,
+        nodeName: 'HTTP Proxy No Headers',
+        hostname: '1.1.1.1',
+        port: 8080,
+        username: 'user',
+        password: 'pass',
+      },
+    ]),
+    [
+      {
+        type: 'http',
+        name: 'HTTP Proxy No Headers',
+        server: '1.1.1.1',
+        port: 8080,
+        username: 'user',
+        password: 'pass',
+      },
+    ],
+  )
+
+  t.deepEqual(
+    clash.getClashNodes([
+      {
+        type: NodeTypeEnum.HTTPS,
+        nodeName: 'HTTPS Proxy',
+        hostname: '1.1.1.1',
+        port: 443,
+        username: 'user',
+        password: 'pass',
+        tls13: false,
+        skipCertVerify: false,
+        headers: {
+          'X-Custom': 'value',
+        },
+      },
+    ]),
+    [
+      {
+        type: 'http',
+        name: 'HTTPS Proxy',
+        server: '1.1.1.1',
+        port: 443,
+        username: 'user',
+        password: 'pass',
+        tls: true,
+        'skip-cert-verify': false,
+        headers: {
+          'X-Custom': 'value',
+        },
+      },
+    ],
+  )
+
+  t.deepEqual(
+    clash.getClashNodes([
+      {
+        type: NodeTypeEnum.HTTP,
+        nodeName: 'HTTP No Auth',
+        hostname: '1.1.1.1',
+        port: 8080,
+      },
+    ]),
+    [
+      {
+        type: 'http',
+        name: 'HTTP No Auth',
+        server: '1.1.1.1',
+        port: 8080,
+      },
+    ],
+  )
+})

src/utils/clash.ts

@@ -337,10 +337,15 @@ function nodeListMapper(nodeConfig: PossibleNodeConfigType) {
         name: nodeConfig.nodeName,
         server: nodeConfig.hostname,
         port: nodeConfig.port,
-        username: nodeConfig.username /* istanbul ignore next */ || '',
-        password: nodeConfig.password /* istanbul ignore next */ || '',
+        ...(typeof nodeConfig.username === 'string'
+          ? { username: nodeConfig.username }
+          : null),
+        ...(typeof nodeConfig.password === 'string'
+          ? { password: nodeConfig.password }
+          : null),
         tls: true,
         'skip-cert-verify': nodeConfig.skipCertVerify === true,
+        ...(nodeConfig.headers ? { headers: nodeConfig.headers } : null),
       } as const
 
     case NodeTypeEnum.HTTP:
@@ -349,8 +354,13 @@ function nodeListMapper(nodeConfig: PossibleNodeConfigType) {
         name: nodeConfig.nodeName,
         server: nodeConfig.hostname,
         port: nodeConfig.port,
-        username: nodeConfig.username /* istanbul ignore next */ || '',
-        password: nodeConfig.password /* istanbul ignore next */ || '',
+        ...(typeof nodeConfig.username === 'string'
+          ? { username: nodeConfig.username }
+          : null),
+        ...(typeof nodeConfig.password === 'string'
+          ? { password: nodeConfig.password }
+          : null),
+        ...(nodeConfig.headers ? { headers: nodeConfig.headers } : null),
       } as const
 
     case NodeTypeEnum.Trojan: