AtlatestRepositorysigil-quic

sigil-quic / tree / scriptsinject-packet-spy.mjs

1// Observe actual connection-owned packet buffers in an isolated remote tree.
2// Never install as a hook or rewrite the shipped module in place.
3import { readFileSync, writeFileSync } from 'node:fs';
4
5const [input, output] = process.argv.slice(2);
6if (!input || !output || input === output) {
7 throw new Error('Usage: inject-packet-spy.mjs INPUT OUTPUT');
8}
9let source = readFileSync(input, 'utf8');
10const imported = '(import (sigil crypto)';
11if (!source.includes('(define-library (sigil quic connection)') ||
12 source.includes('packet-spy') || source.split(imported).length !== 2) {
13 throw new Error('Expected an uninstrumented QUIC connection');
15function replaceOnce(original, observed) {
16 if (source.split(original).length !== 2) throw new Error('Connection key site changed');
17 source = source.replace(original, () => observed);
19for (const [side, direction] of [['peer', 'read'], ['local', 'write']]) {
20 replaceOnce(`(initial-keys (quic-connection-original-id connection) ${side})`,
21 `(packet-spy-initial (quic-role connection) '${direction} (quic-connection-original-id connection) ${side})`);
23for (const [part, direction] of [['car', 'read'], ['cdr', 'write']]) {
24 replaceOnce(`(traffic-keys (${part} data))`,
25 `(packet-spy-traffic (quic-role connection) level '${direction} (${part} data))`);
27replaceOnce('(next-traffic-keys (connection-level-read-keys state))',
28 '(packet-spy-next (quic-role connection) (connection-level-read-keys state))');
29source = source.replace(imported,
30 '(import (sigil quic tests packet spy)\n (sigil crypto)');
31writeFileSync(output,
32 ';;; TEST ONLY: observed connection packet buffers; never ship this variant.\n' + source);