AtlatestRepositorysigil-http3
sigil-http3 / tree / testtest-punch-prime.mjs
1
import assert from 'node:assert/strict';2
import { test } from 'node:test';3
import { createSocket } from 'node:dgram';4
import { primeSocket, validateRendezvous } from '../scripts/punch-prime.mjs';6
async function socket(port = 0) {7
const value = createSocket('udp6');8
await new Promise((done, reject) => { value.once('error', reject); value.bind(port, '::1', done); });9
return value;10
}11
async function close(value) { await new Promise(done => value.close(done)); }13
test('six priming datagrams preserve one exact source tuple and release it', async () => {14
const receivers = await Promise.all([socket(), socket(), socket()]);15
const source = await socket();16
const sourcePort = source.address().port;17
await close(source);18
const received = [];19
for (const receiver of receivers) receiver.on('message', (bytes, peer) => received.push({ bytes, peer }));20
try {21
const result = await primeSocket({ scope: 'test-loopback', bindAddress: '::1', phoneIPv6: '::1',22
sourcePort, ports: receivers.map(receiver => receiver.address().port) });23
assert.equal(result.socketClosed, true);24
assert.equal(result.packets.length, 6);25
assert.equal(received.length, 6);26
assert.ok(received.every(packet => packet.bytes.length === 8 && packet.peer.port === sourcePort && packet.peer.address === '::1'));27
const replacement = createSocket('udp6');28
await new Promise((done, reject) => { replacement.once('error', reject); replacement.bind(sourcePort, '::1', done); });29
await close(replacement);30
} finally { await Promise.all(receivers.map(close)); }31
});33
test('parent cancellation closes priming socket before another owner binds', async () => {34
const receiver = await socket(), source = await socket();35
const port = source.address().port;36
await close(source);37
const cancellation = new AbortController();38
let receipt;39
try {40
await assert.rejects(primeSocket({ scope: 'test-loopback', bindAddress: '::1', phoneIPv6: '::1', sourcePort: port,41
ports: [receiver.address().port, receiver.address().port, receiver.address().port], signal: cancellation.signal,42
onRecord(value) { receipt = value; if (value.packets.length === 1) cancellation.abort(); } }), /abort/i);43
assert.equal(receipt.socketClosed, true);44
assert.equal(receipt.packets.length, 1);45
const replacement = await socket(port);46
await close(replacement);47
} finally { await close(receiver); }48
});50
test('address rendezvous rejects home-prefix, stale, and noncellular targets', () => {51
const now = Date.now(), local = '2001:db8:1:2::1';52
const good = { cellularOnly: true, phoneIPv6: '2a00:1234:abcd:2345::1', observedAt: new Date(now).toISOString() };53
assert.equal(validateRendezvous(good, local, now), good.phoneIPv6);54
assert.throws(() => validateRendezvous({ ...good, phoneIPv6: '2001:db8:1:2::9' }, local, now));55
assert.throws(() => validateRendezvous({ ...good, cellularOnly: false }, local, now));56
assert.throws(() => validateRendezvous({ ...good, observedAt: new Date(now - 600001).toISOString() }, local, now));57
assert.throws(() => validateRendezvous({ ...good, phoneIPv6: '::1' }, local, now));58
});