import { describe, expect, it } from 'vitest'; import { formValuesToWirePayload, rawOutboundToFormValues } from '@/lib/xray/outbound-form-adapter'; // Round-trip parity: wire → form → wire should preserve the legacy // Outbound.fromJson(...).toJson() output shape for each protocol's quirks. // Spot-checking the cases the modal exercised in v0.x — vmess vnext flatten, // vless reverse-wrap, wireguard address csv ↔ array, freedom finalRules // emission, blackhole type wrap, dns rule normalization, mux gating. describe('outbound-form-adapter: round-trip', () => { it('vmess flattens vnext to address/port/id/security and re-nests', () => { const wire = { protocol: 'vmess', tag: 'outbound-vmess', settings: { vnext: [ { address: '1.2.3.4', port: 443, users: [{ id: '11111111-2222-4333-8444-555555555555', security: 'auto' }], }, ], }, }; const form = rawOutboundToFormValues(wire); expect(form.protocol).toBe('vmess'); if (form.protocol === 'vmess') { expect(form.settings.address).toBe('1.2.3.4'); expect(form.settings.port).toBe(443); expect(form.settings.id).toBe('11111111-2222-4333-8444-555555555555'); expect(form.settings.security).toBe('auto'); } const back = formValuesToWirePayload(form); expect(back).toMatchObject({ protocol: 'vmess', tag: 'outbound-vmess', settings: { vnext: [ { address: '1.2.3.4', port: 443, users: [{ id: '11111111-2222-4333-8444-555555555555', security: 'auto' }], }, ], }, }); }); it('vless preserves flat shape and emits reverse only when reverseTag is set', () => { const wire = { protocol: 'vless', tag: 'out-vless', settings: { address: 'srv.example', port: 8443, id: '11111111-2222-4333-8444-555555555555', flow: 'xtls-rprx-vision', encryption: 'none', }, streamSettings: { network: 'tcp', security: 'reality' }, }; const form = rawOutboundToFormValues(wire); expect(form.protocol).toBe('vless'); if (form.protocol === 'vless') { expect(form.settings.reverseTag).toBe(''); } const back = formValuesToWirePayload(form); expect(back.settings).not.toHaveProperty('reverse'); expect(back.settings).toMatchObject({ address: 'srv.example', port: 8443, id: '11111111-2222-4333-8444-555555555555', flow: 'xtls-rprx-vision', encryption: 'none', }); }); it('vless preserves a non-none encryption value (post-quantum)', () => { const enc = 'mlkem768x25519plus.native.0rtt.G3cdPSd1-NnlpTbWNSM5vHsT5VNzWfFzYSKwbUMnV1Y'; const wire = { protocol: 'vless', settings: { address: 'srv', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: '', encryption: enc, }, }; const form = rawOutboundToFormValues(wire); if (form.protocol === 'vless') { expect(form.settings.encryption).toBe(enc); } expect((formValuesToWirePayload(form).settings as Record).encryption).toBe( enc, ); }); it('vless emits reverse + sniffing when reverseTag is set', () => { const wire = { protocol: 'vless', settings: { address: 'srv', port: 8443, id: '11111111-2222-4333-8444-555555555555', flow: '', encryption: 'none', reverse: { tag: 'rev-1', sniffing: { enabled: true, destOverride: ['tls'] } }, }, }; const form = rawOutboundToFormValues(wire); if (form.protocol === 'vless') { expect(form.settings.reverseTag).toBe('rev-1'); expect(form.settings.reverseSniffing.enabled).toBe(true); expect(form.settings.reverseSniffing.destOverride).toEqual(['tls']); } const back = formValuesToWirePayload(form); const settings = back.settings as Record; expect(settings.reverse).toMatchObject({ tag: 'rev-1' }); }); // The flow select hides off TCP+TLS/REALITY but keeps its value; xray then fails every dial. it('vless drops a Vision flow its transport cannot carry, and lets mux back on', () => { const outbound = (streamSettings: Record) => formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'vless', settings: { address: 'srv', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: 'xtls-rprx-vision', encryption: 'none', testpre: 5, }, streamSettings, mux: { enabled: true, concurrency: 8 }, }), ); const xdrive = outbound({ network: 'xdrive', security: 'none', xdriveSettings: { service: 'local', remoteFolder: '/tmp/shared' }, }); expect(xdrive.settings).toMatchObject({ flow: '' }); expect(xdrive.settings).not.toHaveProperty('testpre'); expect(xdrive.mux).toMatchObject({ enabled: true }); const ws = outbound({ network: 'ws', security: 'tls', wsSettings: { path: '/' } }); expect(ws.settings).toMatchObject({ flow: '' }); const reality = outbound({ network: 'tcp', security: 'reality', realitySettings: { serverName: 'a.example', publicKey: 'k', fingerprint: 'chrome' }, }); expect(reality.settings).toMatchObject({ flow: 'xtls-rprx-vision', testpre: 5 }); expect(reality).not.toHaveProperty('mux'); }); // VLESS encryption carries Vision on any transport; stripping it gets the server's "client flow is empty". it('vless keeps a Vision flow over VLESS encryption on RAW without TLS', () => { const wire = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'vless', settings: { address: 'srv', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: 'xtls-rprx-vision', encryption: 'mlkem768x25519plus.native.0rtt.cbEXq-_hfkxDUex6HqmSaemEELvnFWc8qQ1MxlNDHnE', }, streamSettings: { network: 'tcp', security: 'none' }, }), ); expect(wire.settings).toMatchObject({ flow: 'xtls-rprx-vision' }); }); it('vless does not emit testpre/testseed unless flow is vision', () => { const wire = { protocol: 'vless', settings: { address: 'srv', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: '', encryption: 'none', testpre: 5, testseed: [1, 2, 3, 4], }, }; const back = formValuesToWirePayload(rawOutboundToFormValues(wire)); expect(back.settings).not.toHaveProperty('testpre'); expect(back.settings).not.toHaveProperty('testseed'); }); it('trojan flattens servers[0] and re-nests', () => { const wire = { protocol: 'trojan', settings: { servers: [{ address: 's', port: 443, password: 'pw' }] }, }; const form = rawOutboundToFormValues(wire); if (form.protocol === 'trojan') { expect(form.settings).toEqual({ address: 's', port: 443, password: 'pw' }); } expect(formValuesToWirePayload(form).settings).toEqual({ servers: [{ address: 's', port: 443, password: 'pw' }], }); }); it('shadowsocks preserves uot + UoTVersion', () => { const wire = { protocol: 'shadowsocks', settings: { servers: [ { address: 's', port: 443, password: 'pw', method: '2022-blake3-aes-128-gcm', uot: true, UoTVersion: 2, }, ], }, }; const back = formValuesToWirePayload(rawOutboundToFormValues(wire)); expect(back.settings).toMatchObject({ servers: [{ uot: true, UoTVersion: 2 }], }); }); it('socks emits users:[] when user is empty, users:[{...}] when set', () => { const noUser = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'socks', settings: { servers: [{ address: 's', port: 1080 }] }, }), ); expect(noUser.settings).toMatchObject({ servers: [{ users: [] }] }); const withUser = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'socks', settings: { servers: [{ address: 's', port: 1080, users: [{ user: 'u', pass: 'p' }] }] }, }), ); expect(withUser.settings).toMatchObject({ servers: [{ users: [{ user: 'u', pass: 'p' }] }], }); }); it('http preserves top-level settings.headers across wire → form → wire (#5519)', () => { const headers = { 'X-T5-Auth': '683556433', Host: '153.3.236.22:443' }; const form = rawOutboundToFormValues({ protocol: 'http', tag: 'h', settings: { servers: [{ address: 'a', port: 443, users: [] }], headers }, }); expect(form.protocol).toBe('http'); if (form.protocol === 'http') { expect(form.settings.headers).toEqual(headers); } const back = formValuesToWirePayload(form); expect(back.settings).toMatchObject({ headers }); }); it('http omits headers when empty', () => { const back = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'http', settings: { servers: [{ address: 'a', port: 8080, users: [] }] }, }), ); expect(back.settings).not.toHaveProperty('headers'); }); it('wireguard csv-joins address and reserved on read, splits on write', () => { const wire = { protocol: 'wireguard', settings: { mtu: 1420, secretKey: 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=', address: ['10.0.0.1', 'fd00::1'], peers: [ { publicKey: 'pk', allowedIPs: ['0.0.0.0/0'], endpoint: 'e:51820', preSharedKey: 'psk' }, ], reserved: [1, 2, 3], noKernelTun: false, }, }; const form = rawOutboundToFormValues(wire); if (form.protocol === 'wireguard') { expect(form.settings.address).toBe('10.0.0.1,fd00::1'); expect(form.settings.reserved).toBe('1,2,3'); expect(form.settings.peers[0].psk).toBe('psk'); } const back = formValuesToWirePayload(form); expect(back.settings).toMatchObject({ address: ['10.0.0.1', 'fd00::1'], reserved: [1, 2, 3], peers: [{ preSharedKey: 'psk' }], }); }); it('blackhole wraps type into {response:{type}} and omits when empty', () => { const empty = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'blackhole', settings: {}, }), ); expect(empty.settings).toEqual({ response: undefined }); const withType = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'blackhole', settings: { response: { type: 'http' } }, }), ); expect(withType.settings).toEqual({ response: { type: 'http' } }); }); it('blackhole carries customResponseData only for the custom response type', () => { const custom = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'blackhole', settings: { response: { type: 'custom', customResponseData: 'SFRUUC8xLjEgNDAz' } }, }), ); expect(custom.settings).toEqual({ response: { type: 'custom', customResponseData: 'SFRUUC8xLjEgNDAz' }, }); const http = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'blackhole', settings: { response: { type: 'http', customResponseData: 'ignored' } }, }), ); expect(http.settings).toEqual({ response: { type: 'http' } }); }); it('wireguard csv-joins remoteDNS on read and splits it on write', () => { const wire = { protocol: 'wireguard', settings: { secretKey: 'YFVmTVCBsLxXJCe4i+jK8PgD3S6vUqfZ4Zl0JVNDfHA=', remoteDNS: ['1.1.1.1', '2606:4700:4700::1111'], peers: [{ publicKey: 'pk', endpoint: 'wg.example.com:51820' }], }, }; const form = rawOutboundToFormValues(wire); if (form.protocol === 'wireguard') { expect(form.settings.remoteDNS).toBe('1.1.1.1,2606:4700:4700::1111'); } const back = formValuesToWirePayload(form); expect((back.settings as { remoteDNS?: string[] }).remoteDNS).toEqual([ '1.1.1.1', '2606:4700:4700::1111', ]); const unset = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'wireguard', settings: { secretKey: wire.settings.secretKey, peers: wire.settings.peers }, }), ); expect((unset.settings as { remoteDNS?: string[] }).remoteDNS).toBeUndefined(); }); // xray-core 26.9.30 ignores wireguard's settings.domainStrategy and panics on remoteDNS // "local"; the endpoint lookup reads sockopt.domainStrategy, in-tunnel targets targetStrategy. it('wireguard lifts the removed domainStrategy and remoteDNS local where the core reads them', () => { const settings = { secretKey: 'YFVmTVCBsLxXJCe4i+jK8PgD3S6vUqfZ4Zl0JVNDfHA=', peers: [{ publicKey: 'pk', endpoint: 'engage.cloudflareclient.com:2408' }], }; const warp = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'wireguard', settings: { ...settings, domainStrategy: 'ForceIPv4v6' }, }), ); expect(warp.targetStrategy).toBe('ForceIPv4v6'); expect(warp.streamSettings).toEqual({ sockopt: { domainStrategy: 'ForceIPv4v6' } }); expect((warp.settings as Record).domainStrategy).toBeUndefined(); const local = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'wireguard', settings: { ...settings, remoteDNS: ['local'] }, }), ); expect(local.targetStrategy).toBe('ForceIP'); expect((local.settings as Record).remoteDNS).toBeUndefined(); const admin = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'wireguard', targetStrategy: 'UseIPv6', streamSettings: { sockopt: { domainStrategy: 'UseIPv4' } }, settings: { ...settings, domainStrategy: 'ForceIPv6' }, }), ); expect(admin.targetStrategy).toBe('UseIPv6'); expect(admin.streamSettings).toEqual({ sockopt: { domainStrategy: 'UseIPv4' } }); }); // The core dials a wireguard peer through its finalmask (noise "exp" was built for WARP), // so saving through the form must keep the masks next to sockopt instead of dropping them. it('wireguard keeps its finalmask on save and drops an empty one', () => { const settings = { secretKey: 'YFVmTVCBsLxXJCe4i+jK8PgD3S6vUqfZ4Zl0JVNDfHA=', peers: [{ publicKey: 'pk', endpoint: 'engage.cloudflareclient.com:2408' }], }; const noise = { type: 'noise', settings: { noise: [{ type: 'exp', packet: '', delay: '1-3' }] }, }; const masked = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'wireguard', settings, streamSettings: { sockopt: { mark: 255 }, finalmask: { tcp: [], udp: [noise] } }, }), ); expect(masked.streamSettings).toEqual({ sockopt: { mark: 255 }, finalmask: { udp: [noise] } }); const empty = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'wireguard', settings, streamSettings: { sockopt: { mark: 255 }, finalmask: { tcp: [], udp: [] } }, }), ); expect(empty.streamSettings).toEqual({ sockopt: { mark: 255 } }); }); it('dns rules normalize qType numeric strings, split domains, carry rCode', () => { const wire = { protocol: 'dns', settings: { rewriteNetwork: 'udp', rewriteAddress: '1.1.1.1', rewritePort: 53, rules: [ { action: 'direct', qType: 'A,AAAA', domain: ['example.com', 'ext.org'] }, { action: 'return', qType: 28, domain: 'blocked.com', rCode: 3 }, ], }, }; const back = formValuesToWirePayload(rawOutboundToFormValues(wire)); const settings = back.settings as Record; const rules = settings.rules as Array>; expect(rules[0]).toEqual({ action: 'direct', qType: 'A,AAAA', domain: ['example.com', 'ext.org'], }); expect(rules[1]).toEqual({ action: 'return', qType: 28, domain: ['blocked.com'], rCode: 3 }); }); it('dns rules keep qType 0 a string, since the core reads a numeric 0 as every query', () => { const back = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'dns', settings: { rules: [{ action: 'drop', qType: 0 }] }, }), ); const rules = (back.settings as Record).rules as Array< Record >; expect(rules[0]).toEqual({ action: 'drop', qType: '0' }); }); it('dns rules read the legacy qtype wire key for back-compat', () => { const wire = { protocol: 'dns', settings: { rules: [{ action: 'direct', qtype: 'TXT' }] }, }; const back = formValuesToWirePayload(rawOutboundToFormValues(wire)); const rules = (back.settings as Record).rules as Array< Record >; expect(rules[0]).toEqual({ action: 'direct', qType: 'TXT' }); }); it('freedom emits domainStrategy/redirect/fragment conditionally', () => { const empty = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'freedom', settings: {}, }), ); expect(empty.settings).toEqual({ domainStrategy: undefined, redirect: undefined, fragment: undefined, noises: undefined, finalRules: undefined, }); const filled = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'freedom', settings: { domainStrategy: 'UseIPv4', redirect: '1.1.1.1', userLevel: 3, proxyProtocol: 2, fragment: { packets: 'tlshello', length: '100-200' }, noises: [{ type: 'rand', packet: '10-20', delay: '10-16', applyTo: 'ipv4' }], }, }), ); // The strategy no longer rides in settings; see freedom-strategy-placement.test.ts. expect(filled.streamSettings).toEqual({ sockopt: { domainStrategy: 'UseIPv4' } }); expect(filled.settings).toMatchObject({ redirect: '1.1.1.1', userLevel: 3, proxyProtocol: 2, fragment: { packets: 'tlshello', length: '100-200' }, noises: [{ type: 'rand', packet: '10-20', delay: '10-16', applyTo: 'ipv4' }], }); }); it('freedom tolerates settings without a fragment object (issue #4686)', () => { const values = { protocol: 'freedom', tag: 'direct', settings: { domainStrategy: '', redirect: '', proxyProtocol: 0, noises: [], finalRules: [ { action: 'block', network: '', port: '', ip: ['geoip:private'], blockDelay: '' }, ], }, } as unknown as Parameters[0]; expect(() => formValuesToWirePayload(values)).not.toThrow(); const back = formValuesToWirePayload(values); expect((back.settings as { fragment?: unknown }).fragment).toBeUndefined(); expect((back.settings as { finalRules?: unknown[] }).finalRules).toHaveLength(1); }); it('freedom omits proxyProtocol when disabled (0)', () => { const round = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'freedom', settings: { proxyProtocol: 0 }, }), ); expect((round.settings as { proxyProtocol?: number }).proxyProtocol).toBeUndefined(); }); it('mux is only emitted when enabled AND protocol/network/flow allow it', () => { // Disabled mux: omitted const disabled = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'vless', settings: { address: 's', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: '', encryption: 'none', }, mux: { enabled: false }, }), ); expect(disabled).not.toHaveProperty('mux'); // Enabled mux on vless without flow: emitted const enabled = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'vless', settings: { address: 's', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: '', encryption: 'none', }, mux: { enabled: true, concurrency: 8, xudpConcurrency: 16, xudpProxyUDP443: 'reject' }, }), ); expect(enabled.mux).toMatchObject({ enabled: true }); // Enabled mux on vless with vision flow: gated out const withFlow = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'vless', settings: { address: 's', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: 'xtls-rprx-vision', encryption: 'none', }, streamSettings: { network: 'tcp', security: 'reality' }, mux: { enabled: true }, }), ); expect(withFlow).not.toHaveProperty('mux'); // Freedom (non-mux protocol): gated out even if enabled const freedom = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'freedom', settings: {}, mux: { enabled: true }, }), ); expect(freedom).not.toHaveProperty('mux'); }); it('hysteria preserves address/port/version literal 2', () => { const back = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'hysteria', settings: { address: 'h.example', port: 8443, version: 2 }, }), ); expect(back.settings).toEqual({ address: 'h.example', port: 8443, version: 2 }); }); it('loopback inboundTag round-trips', () => { const back = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'loopback', settings: { inboundTag: 'tagged-inbound' }, }), ); expect(back.settings).toEqual({ inboundTag: 'tagged-inbound' }); }); it('loopback omits sniffing when disabled', () => { const form = rawOutboundToFormValues({ protocol: 'loopback', settings: { inboundTag: 'tagged-inbound' }, }); if (form.protocol === 'loopback') { expect(form.settings.sniffing.enabled).toBe(false); } const back = formValuesToWirePayload(form); expect(back.settings).not.toHaveProperty('sniffing'); }); it('loopback round-trips sniffing when enabled', () => { const wire = { protocol: 'loopback', settings: { inboundTag: 'tagged-inbound', sniffing: { enabled: true, destOverride: ['tls', 'http'], routeOnly: true }, }, }; const form = rawOutboundToFormValues(wire); if (form.protocol === 'loopback') { expect(form.settings.sniffing.enabled).toBe(true); expect(form.settings.sniffing.destOverride).toEqual(['tls', 'http']); expect(form.settings.sniffing.routeOnly).toBe(true); } const back = formValuesToWirePayload(form); const sniffing = (back.settings as Record).sniffing as Record; expect(sniffing.enabled).toBe(true); expect(sniffing.destOverride).toEqual(['tls', 'http']); expect(sniffing.routeOnly).toBe(true); }); it('unknown protocol falls back to vless without throwing', () => { const form = rawOutboundToFormValues({ protocol: 'mysterious', settings: {} }); expect(form.protocol).toBe('vless'); }); it('reads a protocol id the way the core does, whatever its case', () => { const freedom = rawOutboundToFormValues({ protocol: 'Freedom', tag: 'direct', settings: { redirect: '1.1.1.1' }, streamSettings: { sockopt: { domainStrategy: 'UseIPv4' } }, }); expect(freedom.protocol).toBe('freedom'); if (freedom.protocol === 'freedom') { expect(freedom.settings.redirect).toBe('1.1.1.1'); } const back = formValuesToWirePayload(freedom); expect(back.protocol).toBe('freedom'); expect(back.tag).toBe('direct'); expect((back.settings as Record).redirect).toBe('1.1.1.1'); const vless = rawOutboundToFormValues({ protocol: 'VLESS', settings: { address: 'srv', port: 443, id: '11111111-2222-4333-8444-555555555555' }, }); expect(vless.protocol).toBe('vless'); if (vless.protocol === 'vless') { expect(vless.settings.address).toBe('srv'); } }); }); describe('outbound-form-adapter: targetStrategy', () => { it('round-trips a top-level targetStrategy', () => { const back = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'vless', settings: { address: 's', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: '', encryption: 'none', }, targetStrategy: 'ForceIPv6v4', }), ); expect(back.targetStrategy).toBe('ForceIPv6v4'); }); it('normalizes wire case to the canonical spelling (core matches case-insensitively)', () => { const form = rawOutboundToFormValues({ protocol: 'vless', settings: {}, targetStrategy: 'useipv4v6', }); expect(form.targetStrategy).toBe('UseIPv4v6'); }); it('omits targetStrategy when unset and drops unknown values', () => { const unset = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'freedom', settings: {}, }), ); expect(unset).not.toHaveProperty('targetStrategy'); const invalid = formValuesToWirePayload( rawOutboundToFormValues({ protocol: 'freedom', settings: {}, targetStrategy: 'UseIPv5', }), ); expect(invalid).not.toHaveProperty('targetStrategy'); }); it('freedom prefers settings.targetStrategy over domainStrategy and moves it to sockopt', () => { const form = rawOutboundToFormValues({ protocol: 'freedom', settings: { targetStrategy: 'UseIPv6', domainStrategy: 'UseIPv4' }, }); if (form.protocol === 'freedom') { expect(form.settings.domainStrategy).toBe('UseIPv6'); } const back = formValuesToWirePayload(form); // Neither legacy key may survive: the core warns about both, and sockopt is // the only placement freedom resolves with. expect(back.settings).not.toHaveProperty('domainStrategy'); expect(back.settings).not.toHaveProperty('targetStrategy'); expect(back.streamSettings).toEqual({ sockopt: { domainStrategy: 'UseIPv6' } }); }); }); describe('outbound-form-adapter: xhttp xmux toggle', () => { const xmuxWire = { protocol: 'vless', tag: 'out-xhttp', settings: { address: 's', port: 443, id: '11111111-2222-4333-8444-555555555555', flow: '', encryption: 'none', }, streamSettings: { network: 'xhttp', security: 'none', xhttpSettings: { path: '/', host: '', mode: '', xPaddingBytes: '100-1000', scMaxEachPostBytes: '1000000', xmux: { maxConcurrency: '11', maxConnections: '1', hMaxRequestTimes: '1', hMaxReusableSecs: '1', }, }, }, }; it('derives enableXmux from a saved xmux object and backfills missing knobs', () => { const form = rawOutboundToFormValues(xmuxWire); const stream = form.streamSettings as Record; const xhttp = stream.xhttpSettings as Record; expect(xhttp.enableXmux).toBe(true); expect(xhttp.xmux).toMatchObject({ maxConcurrency: '11', maxConnections: '1', hMaxRequestTimes: '1', hMaxReusableSecs: '1', cMaxReuseTimes: 0, hKeepAlivePeriod: 0, }); }); it('round-trips xmux on save, strips enableXmux, and enforces xmux exclusivity', () => { const back = formValuesToWirePayload(rawOutboundToFormValues(xmuxWire)); const xhttp = (back.streamSettings as Record).xhttpSettings as Record< string, unknown >; expect(xhttp).not.toHaveProperty('enableXmux'); const xmux = xhttp.xmux as Record; // xray-core rejects maxConnections + maxConcurrency together; the // explicit maxConnections wins and maxConcurrency is dropped. expect(xmux).not.toHaveProperty('maxConcurrency'); expect(xmux).toMatchObject({ maxConnections: '1', hMaxRequestTimes: '1', hMaxReusableSecs: '1', }); }); it('drops xmux on save when the toggle is off', () => { const form = rawOutboundToFormValues(xmuxWire); const xhttp = (form.streamSettings as Record).xhttpSettings as Record< string, unknown >; xhttp.enableXmux = false; const back = formValuesToWirePayload(form); const wireXhttp = (back.streamSettings as Record).xhttpSettings as Record< string, unknown >; expect(wireXhttp).not.toHaveProperty('xmux'); }); it('keeps a saved maxConcurrency through a load/re-save round-trip', () => { const wire = { ...xmuxWire, streamSettings: { ...xmuxWire.streamSettings, xhttpSettings: { ...xmuxWire.streamSettings.xhttpSettings, xmux: { maxConcurrency: '1-2' }, }, }, }; const form = rawOutboundToFormValues(wire); const xhttp = (form.streamSettings as Record).xhttpSettings as Record< string, unknown >; const xmux = xhttp.xmux as Record; expect(xmux.maxConcurrency).toBe('1-2'); expect(xmux.maxConnections).toBe(0); const back = formValuesToWirePayload(form); const wireXhttp = (back.streamSettings as Record).xhttpSettings as Record< string, unknown >; const wireXmux = wireXhttp.xmux as Record; expect(wireXmux.maxConcurrency).toBe('1-2'); }); }); describe('outbound-form-adapter: full optional-block round-trip', () => { const wire = { protocol: 'vless', settings: { address: '1', port: 443, id: '1', flow: '', encryption: 'none', reverse: { tag: '1', sniffing: { enabled: true, destOverride: ['http', 'tls', 'quic', 'fakedns'], metadataOnly: true, routeOnly: true, ipsExcluded: ['1'], domainsExcluded: ['1'], }, }, }, tag: '1', streamSettings: { network: 'tcp', tcpSettings: { header: { type: 'http', request: { version: '1.1', method: 'GET', path: ['/'], headers: { '1': ['1'] } }, response: { version: '1.1', status: '200', reason: 'OK', headers: { '1': ['1'] } }, }, }, security: 'none', sockopt: { tcpFastOpen: true, customSockopt: [{ type: 'int', level: '6', opt: '1', value: '1' }], }, finalmask: { tcp: [ { type: 'fragment', settings: { packets: '1-3', length: '1', delay: '1', maxSplit: '1' }, }, ], }, }, sendThrough: '1', mux: { enabled: true, concurrency: 8, xudpConcurrency: 16, xudpProxyUDP443: 'reject' }, }; it('preserves sockopt, finalmask, mux, and reverse excludes', () => { const back = formValuesToWirePayload(rawOutboundToFormValues(wire)); const settings = back.settings as Record; const sniffing = (settings.reverse as Record).sniffing as Record< string, unknown >; expect(sniffing.ipsExcluded).toEqual(['1']); expect(sniffing.domainsExcluded).toEqual(['1']); const stream = back.streamSettings as Record; expect(stream.sockopt).toMatchObject({ tcpFastOpen: true }); expect((stream.sockopt as Record).customSockopt).toHaveLength(1); expect(stream.finalmask).toMatchObject({ tcp: [{ type: 'fragment' }] }); expect(back.mux).toMatchObject({ enabled: true }); }); });