@undefineds.co/xpod 0.3.53 → 0.3.54

package/dist/edge/reachability/TcpP2PDataPlaneTransport.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTcpP2PDataPlaneTransport = createTcpP2PDataPlaneTransport;
+exports.createTcpP2PDataPlaneServer = createTcpP2PDataPlaneServer;
+exports.attachTcpP2PDataPlaneSocket = attachTcpP2PDataPlaneSocket;
+exports.computeTcpHolePunchPlan = computeTcpHolePunchPlan;
+const node_net_1 = require("node:net");
+const REQUEST_ENVELOPE = 'xpod-p2p-http-request';
+const RESPONSE_ENVELOPE = 'xpod-p2p-http-response';
+const ERROR_ENVELOPE = 'xpod-p2p-http-error';
+const DEFAULT_TIMEOUT_MS = 5_000;
+const DEFAULT_WINDOW_SECONDS = 42;
+const DEFAULT_MAX_CLOCK_ERROR_SECONDS = 20;
+const DEFAULT_MIN_RUN_WINDOW_SECONDS = 10;
+const DEFAULT_NUM_PORTS = 16;
+const DEFAULT_BASE_PORT = 30_000;
+const DEFAULT_PORT_RANGE = 20_000;
+const LARGE_PRIME = 2654435761n;
+const UINT32_MODULUS = 0xffffffffn;
+function createTcpP2PDataPlaneTransport(options) {
+    return new TcpP2PTransport(options);
+}
+function createTcpP2PDataPlaneServer(options) {
+    return new TcpP2PServer(options);
+}
+function attachTcpP2PDataPlaneSocket(options) {
+    return attachTcpP2PDataPlaneSocketInternal(options.socket, options.handler);
+}
+function computeTcpHolePunchPlan(options = {}) {
+    const nowSeconds = options.nowSeconds ?? Math.floor(Date.now() / 1_000);
+    const windowSeconds = positiveInteger(options.windowSeconds, DEFAULT_WINDOW_SECONDS, 'windowSeconds');
+    const maxClockErrorSeconds = positiveInteger(options.maxClockErrorSeconds, DEFAULT_MAX_CLOCK_ERROR_SECONDS, 'maxClockErrorSeconds');
+    const minRunWindowSeconds = positiveInteger(options.minRunWindowSeconds, DEFAULT_MIN_RUN_WINDOW_SECONDS, 'minRunWindowSeconds');
+    const numPorts = positiveInteger(options.numPorts, DEFAULT_NUM_PORTS, 'numPorts');
+    const basePort = positiveInteger(options.basePort, DEFAULT_BASE_PORT, 'basePort');
+    const portRange = positiveInteger(options.portRange, DEFAULT_PORT_RANGE, 'portRange');
+    let bucket = Math.floor((nowSeconds - maxClockErrorSeconds) / windowSeconds);
+    let rendezvousTimeSeconds = (bucket + 1) * windowSeconds + maxClockErrorSeconds;
+    if (rendezvousTimeSeconds - nowSeconds < minRunWindowSeconds) {
+        bucket += 1;
+        rendezvousTimeSeconds = (bucket + 1) * windowSeconds + maxClockErrorSeconds;
+    }
+    const boundary = stableBoundary(bucket);
+    return {
+        bucket,
+        boundary,
+        rendezvousTimeSeconds,
+        ports: stablePorts(boundary, numPorts, basePort, portRange),
+    };
+}
+class TcpP2PTransport {
+    constructor(options) {
+        this.options = options;
+        this.readBuffer = '';
+        this.pending = new Map();
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.randomId = options.randomId ?? (() => `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);
+        if (options.socket) {
+            this.attachSocket(options.socket);
+        }
+    }
+    async request(frame) {
+        const requestId = frame.requestId ?? `tcp_${this.randomId()}`;
+        const requestFrame = { ...frame, requestId };
+        const socket = await this.ensureSocket();
+        const response = new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pending.delete(requestId);
+                reject(new Error(`TCP P2P request ${requestId} timed out after ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+            this.pending.set(requestId, { resolve, reject, timeout });
+        });
+        writeEnvelope(socket, { type: REQUEST_ENVELOPE, requestId, frame: requestFrame });
+        return response;
+    }
+    close() {
+        this.rejectPending(new Error('TCP P2P transport closed'));
+        this.socket?.destroy();
+        this.socket = undefined;
+        this.connectPromise = undefined;
+        this.readBuffer = '';
+    }
+    async ensureSocket() {
+        if (this.socket && !this.socket.destroyed) {
+            return this.socket;
+        }
+        if (!this.connectPromise) {
+            this.connectPromise = new Promise((resolve, reject) => {
+                const socket = (0, node_net_1.createConnection)({ host: this.options.remoteHost, port: this.options.remotePort });
+                const onError = (error) => {
+                    socket.off('connect', onConnect);
+                    reject(error);
+                };
+                const onConnect = () => {
+                    socket.off('error', onError);
+                    this.attachSocket(socket);
+                    resolve(socket);
+                };
+                socket.once('error', onError);
+                socket.once('connect', onConnect);
+            });
+        }
+        return this.connectPromise;
+    }
+    attachSocket(socket) {
+        this.socket = socket;
+        socket.on('data', (chunk) => this.handleData(chunk));
+        socket.on('error', (error) => this.rejectPending(error));
+        socket.on('close', () => this.rejectPending(new Error('TCP P2P socket closed')));
+    }
+    handleData(chunk) {
+        this.readBuffer += chunk.toString('utf8');
+        const { lines, remainder } = splitLines(this.readBuffer);
+        this.readBuffer = remainder;
+        for (const line of lines) {
+            const envelope = parseEnvelope(line);
+            if (!envelope || (envelope.type !== RESPONSE_ENVELOPE && envelope.type !== ERROR_ENVELOPE)) {
+                continue;
+            }
+            const pending = this.pending.get(envelope.requestId);
+            if (!pending) {
+                continue;
+            }
+            clearTimeout(pending.timeout);
+            this.pending.delete(envelope.requestId);
+            if (envelope.type === ERROR_ENVELOPE) {
+                pending.reject(new Error(envelope.error));
+                continue;
+            }
+            pending.resolve(envelope.frame);
+        }
+    }
+    rejectPending(error) {
+        for (const [requestId, pending] of this.pending) {
+            clearTimeout(pending.timeout);
+            pending.reject(error);
+            this.pending.delete(requestId);
+        }
+    }
+}
+class TcpP2PServer {
+    constructor(options) {
+        this.options = options;
+        this.sockets = new Set();
+        this.host = options.host ?? '0.0.0.0';
+    }
+    async listen(port = 0) {
+        if (this.server) {
+            return;
+        }
+        const server = (0, node_net_1.createServer)((socket) => this.handleSocket(socket));
+        this.server = server;
+        await new Promise((resolve, reject) => {
+            server.once('listening', resolve);
+            server.once('error', reject);
+            server.listen(port, this.host);
+        });
+    }
+    address() {
+        const address = this.server?.address();
+        if (!address || typeof address === 'string') {
+            throw new Error(`Expected TCP server address info, got ${String(address)}`);
+        }
+        return address;
+    }
+    async close() {
+        for (const socket of this.sockets) {
+            socket.close();
+        }
+        this.sockets.clear();
+        const server = this.server;
+        this.server = undefined;
+        if (!server) {
+            return;
+        }
+        await new Promise((resolve, reject) => {
+            server.close((error) => error ? reject(error) : resolve());
+        });
+    }
+    handleSocket(socket) {
+        const handle = attachTcpP2PDataPlaneSocketInternal(socket, this.options.handler, () => {
+            this.sockets.delete(handle);
+        });
+        this.sockets.add(handle);
+    }
+}
+function attachTcpP2PDataPlaneSocketInternal(socket, handler, onClose) {
+    let readBuffer = '';
+    const onData = (chunk) => {
+        readBuffer += chunk.toString('utf8');
+        const split = splitLines(readBuffer);
+        readBuffer = split.remainder;
+        for (const line of split.lines) {
+            void handleRequestLine(socket, handler, line);
+        }
+    };
+    const onSocketClose = () => {
+        onClose?.();
+    };
+    socket.on('data', onData);
+    socket.on('close', onSocketClose);
+    return {
+        close() {
+            socket.off('data', onData);
+            socket.off('close', onSocketClose);
+            socket.destroy();
+            onClose?.();
+        },
+    };
+}
+async function handleRequestLine(socket, handler, line) {
+    const envelope = parseEnvelope(line);
+    if (!envelope || envelope.type !== REQUEST_ENVELOPE) {
+        return;
+    }
+    try {
+        const response = await handler.handleRequest(envelope.frame);
+        writeEnvelope(socket, { type: RESPONSE_ENVELOPE, requestId: envelope.requestId, frame: response });
+    }
+    catch (error) {
+        writeEnvelope(socket, {
+            type: ERROR_ENVELOPE,
+            requestId: envelope.requestId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function writeEnvelope(socket, envelope) {
+    socket.write(`${JSON.stringify(envelope)}\n`);
+}
+function splitLines(value) {
+    const parts = value.split('\n');
+    return { lines: parts.slice(0, -1).filter((line) => line.length > 0), remainder: parts.at(-1) ?? '' };
+}
+function parseEnvelope(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (parsed.type === REQUEST_ENVELOPE && typeof parsed.requestId === 'string' && parsed.frame) {
+            return parsed;
+        }
+        if (parsed.type === RESPONSE_ENVELOPE && typeof parsed.requestId === 'string' && parsed.frame) {
+            return parsed;
+        }
+        if (parsed.type === ERROR_ENVELOPE && typeof parsed.requestId === 'string' && typeof parsed.error === 'string') {
+            return parsed;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function stableBoundary(bucket) {
+    const value = (BigInt(bucket) * LARGE_PRIME) % UINT32_MODULUS;
+    return Number(value < 0 ? value + UINT32_MODULUS : value);
+}
+function stablePorts(boundary, numPorts, basePort, portRange) {
+    const rng = mulberry32(boundary >>> 0);
+    const ports = new Set();
+    while (ports.size < numPorts) {
+        ports.add(basePort + Math.floor(rng() * portRange));
+    }
+    return [...ports].sort((a, b) => b - a);
+}
+function mulberry32(seed) {
+    let value = seed;
+    return () => {
+        value = (value + 0x6D2B79F5) | 0;
+        let result = Math.imul(value ^ (value >>> 15), 1 | value);
+        result ^= result + Math.imul(result ^ (result >>> 7), 61 | result);
+        return ((result ^ (result >>> 14)) >>> 0) / 4_294_967_296;
+    };
+}
+function positiveInteger(value, fallback, name) {
+    const resolved = value ?? fallback;
+    if (!Number.isInteger(resolved) || resolved <= 0) {
+        throw new Error(`${name} must be a positive integer`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=TcpP2PDataPlaneTransport.js.map

package/dist/edge/reachability/TcpP2PDataPlaneTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TcpP2PDataPlaneTransport.js","sourceRoot":"","sources":["../../../src/edge/reachability/TcpP2PDataPlaneTransport.ts"],"names":[],"mappings":"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","sourcesContent":["import { createConnection, createServer, type AddressInfo, type Server, type Socket } from 'node:net';\nimport type {\n  P2PDataPlaneHandler,\n  P2PDataPlaneTransport,\n  P2PHttpRequestFrame,\n  P2PHttpResponseFrame,\n} from './P2PDataPlane';\n\nconst REQUEST_ENVELOPE = 'xpod-p2p-http-request' as const;\nconst RESPONSE_ENVELOPE = 'xpod-p2p-http-response' as const;\nconst ERROR_ENVELOPE = 'xpod-p2p-http-error' as const;\nconst DEFAULT_TIMEOUT_MS = 5_000;\nconst DEFAULT_WINDOW_SECONDS = 42;\nconst DEFAULT_MAX_CLOCK_ERROR_SECONDS = 20;\nconst DEFAULT_MIN_RUN_WINDOW_SECONDS = 10;\nconst DEFAULT_NUM_PORTS = 16;\nconst DEFAULT_BASE_PORT = 30_000;\nconst DEFAULT_PORT_RANGE = 20_000;\nconst LARGE_PRIME = 2_654_435_761n;\nconst UINT32_MODULUS = 0xffff_ffffn;\n\ntype TcpP2PEnvelope =\n  | { type: typeof REQUEST_ENVELOPE; requestId: string; frame: P2PHttpRequestFrame }\n  | { type: typeof RESPONSE_ENVELOPE; requestId: string; frame: P2PHttpResponseFrame }\n  | { type: typeof ERROR_ENVELOPE; requestId: string; error: string };\n\nexport interface TcpP2PDataPlaneTransportOptions {\n  remoteHost: string;\n  remotePort: number;\n  socket?: Socket;\n  timeoutMs?: number;\n  randomId?: () => string;\n}\n\nexport interface TcpP2PDataPlaneTransport extends P2PDataPlaneTransport {\n  close(): void;\n}\n\nexport interface TcpP2PDataPlaneServerOptions {\n  handler: P2PDataPlaneHandler;\n  host?: string;\n}\n\nexport interface TcpP2PDataPlaneServer {\n  listen(port?: number): Promise<void>;\n  address(): AddressInfo;\n  close(): Promise<void>;\n}\n\nexport interface TcpP2PDataPlaneSocketOptions {\n  socket: Socket;\n  handler: P2PDataPlaneHandler;\n}\n\nexport interface TcpP2PDataPlaneSocketHandle {\n  close(): void;\n}\n\nexport interface TcpHolePunchPlanOptions {\n  nowSeconds?: number;\n  windowSeconds?: number;\n  maxClockErrorSeconds?: number;\n  minRunWindowSeconds?: number;\n  numPorts?: number;\n  basePort?: number;\n  portRange?: number;\n}\n\nexport interface TcpHolePunchPlan {\n  bucket: number;\n  boundary: number;\n  rendezvousTimeSeconds: number;\n  ports: number[];\n}\n\nexport function createTcpP2PDataPlaneTransport(options: TcpP2PDataPlaneTransportOptions): TcpP2PDataPlaneTransport {\n  return new TcpP2PTransport(options);\n}\n\nexport function createTcpP2PDataPlaneServer(options: TcpP2PDataPlaneServerOptions): TcpP2PDataPlaneServer {\n  return new TcpP2PServer(options);\n}\n\nexport function attachTcpP2PDataPlaneSocket(options: TcpP2PDataPlaneSocketOptions): TcpP2PDataPlaneSocketHandle {\n  return attachTcpP2PDataPlaneSocketInternal(options.socket, options.handler);\n}\n\nexport function computeTcpHolePunchPlan(options: TcpHolePunchPlanOptions = {}): TcpHolePunchPlan {\n  const nowSeconds = options.nowSeconds ?? Math.floor(Date.now() / 1_000);\n  const windowSeconds = positiveInteger(options.windowSeconds, DEFAULT_WINDOW_SECONDS, 'windowSeconds');\n  const maxClockErrorSeconds = positiveInteger(options.maxClockErrorSeconds, DEFAULT_MAX_CLOCK_ERROR_SECONDS, 'maxClockErrorSeconds');\n  const minRunWindowSeconds = positiveInteger(options.minRunWindowSeconds, DEFAULT_MIN_RUN_WINDOW_SECONDS, 'minRunWindowSeconds');\n  const numPorts = positiveInteger(options.numPorts, DEFAULT_NUM_PORTS, 'numPorts');\n  const basePort = positiveInteger(options.basePort, DEFAULT_BASE_PORT, 'basePort');\n  const portRange = positiveInteger(options.portRange, DEFAULT_PORT_RANGE, 'portRange');\n\n  let bucket = Math.floor((nowSeconds - maxClockErrorSeconds) / windowSeconds);\n  let rendezvousTimeSeconds = (bucket + 1) * windowSeconds + maxClockErrorSeconds;\n  if (rendezvousTimeSeconds - nowSeconds < minRunWindowSeconds) {\n    bucket += 1;\n    rendezvousTimeSeconds = (bucket + 1) * windowSeconds + maxClockErrorSeconds;\n  }\n  const boundary = stableBoundary(bucket);\n  return {\n    bucket,\n    boundary,\n    rendezvousTimeSeconds,\n    ports: stablePorts(boundary, numPorts, basePort, portRange),\n  };\n}\n\nclass TcpP2PTransport implements TcpP2PDataPlaneTransport {\n  private readonly timeoutMs: number;\n  private readonly randomId: () => string;\n  private socket?: Socket;\n  private connectPromise?: Promise<Socket>;\n  private readBuffer = '';\n  private readonly pending = new Map<string, {\n    resolve: (frame: P2PHttpResponseFrame) => void;\n    reject: (error: Error) => void;\n    timeout: NodeJS.Timeout;\n  }>();\n\n  public constructor(private readonly options: TcpP2PDataPlaneTransportOptions) {\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.randomId = options.randomId ?? (() => `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);\n    if (options.socket) {\n      this.attachSocket(options.socket);\n    }\n  }\n\n  public async request(frame: P2PHttpRequestFrame): Promise<P2PHttpResponseFrame> {\n    const requestId = frame.requestId ?? `tcp_${this.randomId()}`;\n    const requestFrame: P2PHttpRequestFrame = { ...frame, requestId };\n    const socket = await this.ensureSocket();\n    const response = new Promise<P2PHttpResponseFrame>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.pending.delete(requestId);\n        reject(new Error(`TCP P2P request ${requestId} timed out after ${this.timeoutMs}ms`));\n      }, this.timeoutMs);\n      this.pending.set(requestId, { resolve, reject, timeout });\n    });\n    writeEnvelope(socket, { type: REQUEST_ENVELOPE, requestId, frame: requestFrame });\n    return response;\n  }\n\n  public close(): void {\n    this.rejectPending(new Error('TCP P2P transport closed'));\n    this.socket?.destroy();\n    this.socket = undefined;\n    this.connectPromise = undefined;\n    this.readBuffer = '';\n  }\n\n  private async ensureSocket(): Promise<Socket> {\n    if (this.socket && !this.socket.destroyed) {\n      return this.socket;\n    }\n    if (!this.connectPromise) {\n      this.connectPromise = new Promise((resolve, reject) => {\n        const socket = createConnection({ host: this.options.remoteHost, port: this.options.remotePort });\n        const onError = (error: Error): void => {\n          socket.off('connect', onConnect);\n          reject(error);\n        };\n        const onConnect = (): void => {\n          socket.off('error', onError);\n          this.attachSocket(socket);\n          resolve(socket);\n        };\n        socket.once('error', onError);\n        socket.once('connect', onConnect);\n      });\n    }\n    return this.connectPromise;\n  }\n\n  private attachSocket(socket: Socket): void {\n    this.socket = socket;\n    socket.on('data', (chunk) => this.handleData(chunk));\n    socket.on('error', (error) => this.rejectPending(error));\n    socket.on('close', () => this.rejectPending(new Error('TCP P2P socket closed')));\n  }\n\n  private handleData(chunk: Buffer): void {\n    this.readBuffer += chunk.toString('utf8');\n    const { lines, remainder } = splitLines(this.readBuffer);\n    this.readBuffer = remainder;\n    for (const line of lines) {\n      const envelope = parseEnvelope(line);\n      if (!envelope || (envelope.type !== RESPONSE_ENVELOPE && envelope.type !== ERROR_ENVELOPE)) {\n        continue;\n      }\n      const pending = this.pending.get(envelope.requestId);\n      if (!pending) {\n        continue;\n      }\n      clearTimeout(pending.timeout);\n      this.pending.delete(envelope.requestId);\n      if (envelope.type === ERROR_ENVELOPE) {\n        pending.reject(new Error(envelope.error));\n        continue;\n      }\n      pending.resolve(envelope.frame);\n    }\n  }\n\n  private rejectPending(error: Error): void {\n    for (const [requestId, pending] of this.pending) {\n      clearTimeout(pending.timeout);\n      pending.reject(error);\n      this.pending.delete(requestId);\n    }\n  }\n}\n\nclass TcpP2PServer implements TcpP2PDataPlaneServer {\n  private readonly host: string;\n  private server?: Server;\n  private sockets = new Set<TcpP2PDataPlaneSocketHandle>();\n\n  public constructor(private readonly options: TcpP2PDataPlaneServerOptions) {\n    this.host = options.host ?? '0.0.0.0';\n  }\n\n  public async listen(port = 0): Promise<void> {\n    if (this.server) {\n      return;\n    }\n    const server = createServer((socket) => this.handleSocket(socket));\n    this.server = server;\n    await new Promise<void>((resolve, reject) => {\n      server.once('listening', resolve);\n      server.once('error', reject);\n      server.listen(port, this.host);\n    });\n  }\n\n  public address(): AddressInfo {\n    const address = this.server?.address();\n    if (!address || typeof address === 'string') {\n      throw new Error(`Expected TCP server address info, got ${String(address)}`);\n    }\n    return address;\n  }\n\n  public async close(): Promise<void> {\n    for (const socket of this.sockets) {\n      socket.close();\n    }\n    this.sockets.clear();\n    const server = this.server;\n    this.server = undefined;\n    if (!server) {\n      return;\n    }\n    await new Promise<void>((resolve, reject) => {\n      server.close((error) => error ? reject(error) : resolve());\n    });\n  }\n\n  private handleSocket(socket: Socket): void {\n    const handle = attachTcpP2PDataPlaneSocketInternal(socket, this.options.handler, () => {\n      this.sockets.delete(handle);\n    });\n    this.sockets.add(handle);\n  }\n}\n\nfunction attachTcpP2PDataPlaneSocketInternal(\n  socket: Socket,\n  handler: P2PDataPlaneHandler,\n  onClose?: () => void,\n): TcpP2PDataPlaneSocketHandle {\n  let readBuffer = '';\n  const onData = (chunk: Buffer): void => {\n    readBuffer += chunk.toString('utf8');\n    const split = splitLines(readBuffer);\n    readBuffer = split.remainder;\n    for (const line of split.lines) {\n      void handleRequestLine(socket, handler, line);\n    }\n  };\n  const onSocketClose = (): void => {\n    onClose?.();\n  };\n  socket.on('data', onData);\n  socket.on('close', onSocketClose);\n  return {\n    close(): void {\n      socket.off('data', onData);\n      socket.off('close', onSocketClose);\n      socket.destroy();\n      onClose?.();\n    },\n  };\n}\n\nasync function handleRequestLine(socket: Socket, handler: P2PDataPlaneHandler, line: string): Promise<void> {\n  const envelope = parseEnvelope(line);\n  if (!envelope || envelope.type !== REQUEST_ENVELOPE) {\n    return;\n  }\n  try {\n    const response = await handler.handleRequest(envelope.frame);\n    writeEnvelope(socket, { type: RESPONSE_ENVELOPE, requestId: envelope.requestId, frame: response });\n  } catch (error) {\n    writeEnvelope(socket, {\n      type: ERROR_ENVELOPE,\n      requestId: envelope.requestId,\n      error: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\n\nfunction writeEnvelope(socket: Socket, envelope: TcpP2PEnvelope): void {\n  socket.write(`${JSON.stringify(envelope)}\\n`);\n}\n\nfunction splitLines(value: string): { lines: string[]; remainder: string } {\n  const parts = value.split('\\n');\n  return { lines: parts.slice(0, -1).filter((line) => line.length > 0), remainder: parts.at(-1) ?? '' };\n}\n\nfunction parseEnvelope(line: string): TcpP2PEnvelope | undefined {\n  try {\n    const parsed = JSON.parse(line) as Partial<TcpP2PEnvelope>;\n    if (parsed.type === REQUEST_ENVELOPE && typeof parsed.requestId === 'string' && parsed.frame) {\n      return parsed as TcpP2PEnvelope;\n    }\n    if (parsed.type === RESPONSE_ENVELOPE && typeof parsed.requestId === 'string' && parsed.frame) {\n      return parsed as TcpP2PEnvelope;\n    }\n    if (parsed.type === ERROR_ENVELOPE && typeof parsed.requestId === 'string' && typeof parsed.error === 'string') {\n      return parsed as TcpP2PEnvelope;\n    }\n  } catch {\n    return undefined;\n  }\n  return undefined;\n}\n\nfunction stableBoundary(bucket: number): number {\n  const value = (BigInt(bucket) * LARGE_PRIME) % UINT32_MODULUS;\n  return Number(value < 0 ? value + UINT32_MODULUS : value);\n}\n\nfunction stablePorts(boundary: number, numPorts: number, basePort: number, portRange: number): number[] {\n  const rng = mulberry32(boundary >>> 0);\n  const ports = new Set<number>();\n  while (ports.size < numPorts) {\n    ports.add(basePort + Math.floor(rng() * portRange));\n  }\n  return [...ports].sort((a, b) => b - a);\n}\n\nfunction mulberry32(seed: number): () => number {\n  let value = seed;\n  return () => {\n    value = (value + 0x6D2B79F5) | 0;\n    let result = Math.imul(value ^ (value >>> 15), 1 | value);\n    result ^= result + Math.imul(result ^ (result >>> 7), 61 | result);\n    return ((result ^ (result >>> 14)) >>> 0) / 4_294_967_296;\n  };\n}\n\nfunction positiveInteger(value: number | undefined, fallback: number, name: string): number {\n  const resolved = value ?? fallback;\n  if (!Number.isInteger(resolved) || resolved <= 0) {\n    throw new Error(`${name} must be a positive integer`);\n  }\n  return resolved;\n}\n"]}

package/dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld

@@ -0,0 +1,183 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransportOptions",
+      "@type": "AbstractClass",
+      "requireElement": "TcpP2PDataPlaneTransportOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransportOptions__member_remoteHost",
+          "memberFieldName": "remoteHost"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransportOptions__member_remotePort",
+          "memberFieldName": "remotePort"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransportOptions__member_socket",
+          "memberFieldName": "socket"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransportOptions__member_timeoutMs",
+          "memberFieldName": "timeoutMs"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransportOptions__member_randomId",
+          "memberFieldName": "randomId"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransport",
+      "@type": "AbstractClass",
+      "requireElement": "TcpP2PDataPlaneTransport",
+      "extends": [
+        "undefineds:dist/edge/reachability/P2PDataPlane.jsonld#P2PDataPlaneTransport"
+      ],
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneTransport__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneServerOptions",
+      "@type": "AbstractClass",
+      "requireElement": "TcpP2PDataPlaneServerOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneServerOptions__member_handler",
+          "memberFieldName": "handler"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneServerOptions__member_host",
+          "memberFieldName": "host"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneServer",
+      "@type": "AbstractClass",
+      "requireElement": "TcpP2PDataPlaneServer",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneServer__member_listen",
+          "memberFieldName": "listen"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneServer__member_address",
+          "memberFieldName": "address"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneServer__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneSocketOptions",
+      "@type": "AbstractClass",
+      "requireElement": "TcpP2PDataPlaneSocketOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneSocketOptions__member_socket",
+          "memberFieldName": "socket"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneSocketOptions__member_handler",
+          "memberFieldName": "handler"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneSocketHandle",
+      "@type": "AbstractClass",
+      "requireElement": "TcpP2PDataPlaneSocketHandle",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpP2PDataPlaneSocketHandle__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions",
+      "@type": "AbstractClass",
+      "requireElement": "TcpHolePunchPlanOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions__member_nowSeconds",
+          "memberFieldName": "nowSeconds"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions__member_windowSeconds",
+          "memberFieldName": "windowSeconds"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions__member_maxClockErrorSeconds",
+          "memberFieldName": "maxClockErrorSeconds"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions__member_minRunWindowSeconds",
+          "memberFieldName": "minRunWindowSeconds"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions__member_numPorts",
+          "memberFieldName": "numPorts"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions__member_basePort",
+          "memberFieldName": "basePort"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlanOptions__member_portRange",
+          "memberFieldName": "portRange"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlan",
+      "@type": "AbstractClass",
+      "requireElement": "TcpHolePunchPlan",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlan__member_bucket",
+          "memberFieldName": "bucket"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlan__member_boundary",
+          "memberFieldName": "boundary"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlan__member_rendezvousTimeSeconds",
+          "memberFieldName": "rendezvousTimeSeconds"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/TcpP2PDataPlaneTransport.jsonld#TcpHolePunchPlan__member_ports",
+          "memberFieldName": "ports"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/edge/reachability/TcpP2PSignalingSession.d.ts

@@ -0,0 +1,149 @@
+import { type Socket } from 'node:net';
+import type { AccessRoute, P2PCandidateRole, P2PSession, P2PTransportCandidate } from './types';
+import type { P2PSignalingClient } from './P2PSignalingClient';
+import type { P2PDataPlaneHandler } from './P2PDataPlane';
+import { type TcpP2PDataPlaneSocketHandle, type TcpP2PDataPlaneTransport, type TcpHolePunchPlan, type TcpHolePunchPlanOptions } from './TcpP2PDataPlaneTransport';
+export declare const RAW_TCP_HOLE_PUNCH_TRANSPORT: "raw-tcp-hole-punch";
+export declare const RAW_TCP_HOLE_PUNCH_CAPABILITY: "tcp-punch";
+export interface CreateRawTcpHolePunchCandidatesOptions {
+    role: P2PCandidateRole;
+    sourceId: string;
+    host?: string;
+    address?: string;
+    createdAt?: Date;
+    priority?: number;
+    plan?: TcpHolePunchPlan;
+    planOptions?: TcpHolePunchPlanOptions;
+    candidateIdPrefix?: string;
+}
+export interface SignaledRawTcpP2PSessionOptions {
+    signaling: P2PSignalingClient;
+    clientId: string;
+    host?: string;
+    address?: string;
+    capabilities?: string[];
+    priority?: number;
+    createdAt?: Date;
+    plan?: TcpHolePunchPlan;
+    planOptions?: TcpHolePunchPlanOptions;
+    candidateIdPrefix?: string;
+}
+export interface SignaledRawTcpP2PSession {
+    session: P2PSession;
+    plan: TcpHolePunchPlan;
+    localCandidates: P2PTransportCandidate[];
+    rawTcpRoute?: AccessRoute;
+}
+export interface AnswerPendingRawTcpP2PSessionsOnceOptions {
+    signaling: P2PSignalingClient;
+    sourceId: string;
+    host?: string;
+    address?: string;
+    priority?: number;
+    createdAt?: Date;
+    candidateIdPrefix?: string;
+}
+export interface WaitForRawTcpRemoteCandidatesOptions {
+    signaling: P2PSignalingClient;
+    sessionIdOrUrl: string;
+    localRole: P2PCandidateRole;
+    localSourceId: string;
+    bucket?: number;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}
+export interface ConnectRawTcpP2PTransportOptions {
+    localCandidates: P2PTransportCandidate[];
+    remoteCandidates: P2PTransportCandidate[];
+    connectTimeoutMs?: number;
+    timeoutMs?: number;
+    winnerSelectionWindowMs?: number;
+    localAddress?: string;
+    nowMs?: () => number;
+    sleepMs?: RawTcpP2PSleep;
+    connectSocket?: RawTcpP2PConnectSocket;
+}
+export interface RawTcpP2PConnectAttempt {
+    local: P2PTransportCandidate;
+    remote: P2PTransportCandidate;
+    remoteHost: string;
+    remotePort: number;
+    localAddress?: string;
+    localPort?: number;
+    rendezvousTimeMs: number;
+    timeoutMs: number;
+    signal?: AbortSignal;
+}
+export type RawTcpP2PConnectSocket = (attempt: RawTcpP2PConnectAttempt) => Promise<Socket>;
+export type RawTcpP2PSleep = (ms: number, signal?: AbortSignal) => Promise<void>;
+export interface NodeRawTcpP2PConnectSocketEventBase {
+    attempt: RawTcpP2PConnectAttempt;
+    error?: Error;
+    remainingMs?: number;
+    retryDelayMs?: number;
+    socket?: Socket;
+}
+export type NodeRawTcpP2PConnectSocketEvent = (NodeRawTcpP2PConnectSocketEventBase & {
+    type: 'attempt';
+    remainingMs: number;
+}) | (NodeRawTcpP2PConnectSocketEventBase & {
+    type: 'retry';
+    error: Error;
+    remainingMs: number;
+    retryDelayMs: number;
+}) | (NodeRawTcpP2PConnectSocketEventBase & {
+    type: 'success';
+    socket: Socket;
+}) | (NodeRawTcpP2PConnectSocketEventBase & {
+    type: 'timeout';
+    error: Error;
+}) | (NodeRawTcpP2PConnectSocketEventBase & {
+    type: 'aborted';
+    error?: Error;
+});
+export interface CreateNodeRawTcpP2PConnectSocketOptions {
+    retryIntervalMs?: number;
+    onEvent?: (event: NodeRawTcpP2PConnectSocketEvent) => void;
+}
+export interface ConnectSignaledRawTcpP2PTransportOptions extends SignaledRawTcpP2PSessionOptions {
+    connectTimeoutMs?: number;
+    timeoutMs?: number;
+    winnerSelectionWindowMs?: number;
+    localAddress?: string;
+    nowMs?: () => number;
+    sleepMs?: RawTcpP2PSleep;
+    connectSocket?: RawTcpP2PConnectSocket;
+    pollIntervalMs?: number;
+    waitTimeoutMs?: number;
+}
+export interface ConnectedSignaledRawTcpP2PTransport extends SignaledRawTcpP2PSession {
+    remoteCandidates: P2PTransportCandidate[];
+    transport: TcpP2PDataPlaneTransport;
+}
+export interface AcceptSignaledRawTcpP2PConnectionOnceOptions extends AnswerPendingRawTcpP2PSessionsOnceOptions {
+    handler: P2PDataPlaneHandler;
+    connectTimeoutMs?: number;
+    winnerSelectionWindowMs?: number;
+    localAddress?: string;
+    nowMs?: () => number;
+    sleepMs?: RawTcpP2PSleep;
+    connectSocket?: RawTcpP2PConnectSocket;
+}
+export interface AcceptedSignaledRawTcpP2PConnection {
+    session: P2PSession;
+    plan: TcpHolePunchPlan;
+    localCandidates: P2PTransportCandidate[];
+    remoteCandidates: P2PTransportCandidate[];
+    socketHandle: TcpP2PDataPlaneSocketHandle;
+}
+export declare function createNodeRawTcpP2PConnectSocket(options?: CreateNodeRawTcpP2PConnectSocketOptions): RawTcpP2PConnectSocket;
+export declare function createRawTcpHolePunchCandidates(options: CreateRawTcpHolePunchCandidatesOptions): P2PTransportCandidate[];
+export declare function createSignaledRawTcpP2PSession(options: SignaledRawTcpP2PSessionOptions): Promise<SignaledRawTcpP2PSession>;
+export declare function answerPendingRawTcpP2PSessionsOnce(options: AnswerPendingRawTcpP2PSessionsOnceOptions): Promise<P2PSession[]>;
+export declare function acceptSignaledRawTcpP2PConnectionOnce(options: AcceptSignaledRawTcpP2PConnectionOnceOptions): Promise<AcceptedSignaledRawTcpP2PConnection | undefined>;
+export declare function waitForRawTcpRemoteCandidates(options: WaitForRawTcpRemoteCandidatesOptions): Promise<P2PTransportCandidate[]>;
+export declare function connectSignaledRawTcpP2PTransport(options: ConnectSignaledRawTcpP2PTransportOptions): Promise<ConnectedSignaledRawTcpP2PTransport>;
+export declare function connectRawTcpP2PTransport(options: ConnectRawTcpP2PTransportOptions): Promise<TcpP2PDataPlaneTransport>;
+export declare function filterRawTcpRemoteCandidates(candidates: P2PTransportCandidate[], localRole: P2PCandidateRole, localSourceId: string, bucket?: number): P2PTransportCandidate[];
+export declare function selectRawTcpP2PRoute(routes: AccessRoute[]): AccessRoute | undefined;
+export declare function isRawTcpHolePunchCandidate(candidate: P2PTransportCandidate): boolean;