agentic-qe 2.7.3 → 2.8.0

package/dist/edge/p2p/index.js

@@ -0,0 +1,242 @@
+"use strict";
+/**
+ * P2P Module for @ruvector/edge
+ *
+ * Provides peer-to-peer communication infrastructure for browser agents.
+ * Built on Ed25519 cryptographic identities for secure agent communication.
+ *
+ * Modules:
+ * - crypto: Ed25519 cryptographic identity system (P2-001)
+ * - webrtc: WebRTC peer connection management (P2-002)
+ * - protocol: Agent-to-agent communication protocol (P2-003)
+ * - sharing: Pattern sharing protocol (P2-004)
+ * - federated: Federated learning infrastructure (P2-005)
+ * - crdt: CRDT-based conflict resolution (P2-006)
+ * - coordination: Two-machine coordination (P2-007)
+ * - nat: NAT traversal and TURN fallback (P2-008)
+ *
+ * @module edge/p2p
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   // Crypto (P2-001)
+ *   IdentityManager,
+ *   KeyManager,
+ *   Signer,
+ *
+ *   // WebRTC (P2-002)
+ *   PeerConnectionManager,
+ *   SignalingClient,
+ *
+ *   // Protocol (P2-003)
+ *   AgentChannel,
+ *   ProtocolHandler,
+ *   MessageEncoder,
+ *
+ *   // NAT Traversal (P2-008)
+ *   NATDetector,
+ *   TURNManager,
+ *   HolePuncher,
+ *   ConnectivityTester,
+ * } from '@ruvector/edge/p2p';
+ *
+ * // Create identity
+ * const identity = await IdentityManager.create({
+ *   displayName: 'My Agent',
+ *   password: 'secure-password'
+ * });
+ *
+ * // Detect NAT type
+ * const detector = new NATDetector();
+ * const natResult = await detector.detect();
+ *
+ * // Setup WebRTC with NAT-aware configuration
+ * const manager = new PeerConnectionManager({
+ *   localPeerId: identity.agentId,
+ * });
+ *
+ * // Create communication channel
+ * const channel = new AgentChannel({
+ *   localIdentity: identity,
+ *   localKeyPair: keyPair,
+ *   remoteAgentId: 'remote-agent',
+ *   connectionManager: manager,
+ * });
+ *
+ * await channel.open();
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.P2P_CAPABILITIES = exports.P2P_PHASE = exports.P2P_VERSION = exports.generateCoordinationMessageId = exports.HEALTH_PACKET_LOSS_CRITICAL = exports.HEALTH_PACKET_LOSS_WARNING = exports.HEALTH_RTT_CRITICAL_THRESHOLD = exports.HEALTH_RTT_WARNING_THRESHOLD = exports.DEFAULT_SYNC_BATCH_SIZE = exports.MAX_RECONNECT_ATTEMPTS = exports.DEFAULT_RECONNECT_TIMEOUT = exports.DEFAULT_HEALTH_CHECK_INTERVAL = exports.DEFAULT_PING_INTERVAL = exports.COORDINATION_VERSION = exports.generateChallenge = exports.createDefaultHealthStatus = exports.createDefaultMetrics = exports.createDefaultSyncStatus = exports.createDefaultCapabilities = exports.CoordinationErrorCode = exports.CoordinationMessageType = exports.CoordinationEventType = exports.DEFAULT_COORDINATION_CONFIG = exports.HealthLevel = exports.CoordinationRole = exports.CoordinationState = exports.HealthMonitor = exports.SyncOrchestrator = exports.CoordinationManager = exports.MAX_MERGE_DEPTH = exports.DEFAULT_TOMBSTONE_TTL = exports.MAX_VECTOR_CLOCK_SIZE = exports.CRDT_PROTOCOL_VERSION = exports.CRDT_CAPABILITIES = exports.CRDT_VERSION = exports.VectorClockComparison = exports.CRDTErrorCode = exports.CRDTEventType = exports.DEFAULT_STORE_CONFIG = exports.DeltaOpType = exports.ResolutionStrategy = exports.ConflictType = exports.CRDTType = exports.CRDTStore = exports.VectorClock = exports.PatternCRDT = exports.ORSet = exports.LWWRegister = exports.GCounter = void 0;
+// Cryptographic Identity System (P2-001)
+__exportStar(require("./crypto"), exports);
+// WebRTC Peer Connections (P2-002)
+__exportStar(require("./webrtc"), exports);
+// Agent-to-Agent Communication Protocol (P2-003)
+__exportStar(require("./protocol"), exports);
+// Pattern Sharing Protocol (P2-004)
+__exportStar(require("./sharing"), exports);
+// Federated Learning Infrastructure (P2-005)
+__exportStar(require("./federated"), exports);
+// CRDT-Based Conflict Resolution (P2-006)
+// Note: Some types conflict with sharing module, re-export with namespace prefix
+var crdt_1 = require("./crdt");
+// Classes
+Object.defineProperty(exports, "GCounter", { enumerable: true, get: function () { return crdt_1.GCounter; } });
+Object.defineProperty(exports, "LWWRegister", { enumerable: true, get: function () { return crdt_1.LWWRegister; } });
+Object.defineProperty(exports, "ORSet", { enumerable: true, get: function () { return crdt_1.ORSet; } });
+Object.defineProperty(exports, "PatternCRDT", { enumerable: true, get: function () { return crdt_1.PatternCRDT; } });
+Object.defineProperty(exports, "VectorClock", { enumerable: true, get: function () { return crdt_1.VectorClock; } });
+Object.defineProperty(exports, "CRDTStore", { enumerable: true, get: function () { return crdt_1.CRDTStore; } });
+// Types that don't conflict
+Object.defineProperty(exports, "CRDTType", { enumerable: true, get: function () { return crdt_1.CRDTType; } });
+Object.defineProperty(exports, "ConflictType", { enumerable: true, get: function () { return crdt_1.ConflictType; } });
+Object.defineProperty(exports, "ResolutionStrategy", { enumerable: true, get: function () { return crdt_1.ResolutionStrategy; } });
+Object.defineProperty(exports, "DeltaOpType", { enumerable: true, get: function () { return crdt_1.DeltaOpType; } });
+Object.defineProperty(exports, "DEFAULT_STORE_CONFIG", { enumerable: true, get: function () { return crdt_1.DEFAULT_STORE_CONFIG; } });
+Object.defineProperty(exports, "CRDTEventType", { enumerable: true, get: function () { return crdt_1.CRDTEventType; } });
+Object.defineProperty(exports, "CRDTErrorCode", { enumerable: true, get: function () { return crdt_1.CRDTErrorCode; } });
+Object.defineProperty(exports, "VectorClockComparison", { enumerable: true, get: function () { return crdt_1.VectorClockComparison; } });
+// Constants
+Object.defineProperty(exports, "CRDT_VERSION", { enumerable: true, get: function () { return crdt_1.CRDT_VERSION; } });
+Object.defineProperty(exports, "CRDT_CAPABILITIES", { enumerable: true, get: function () { return crdt_1.CRDT_CAPABILITIES; } });
+Object.defineProperty(exports, "CRDT_PROTOCOL_VERSION", { enumerable: true, get: function () { return crdt_1.CRDT_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "MAX_VECTOR_CLOCK_SIZE", { enumerable: true, get: function () { return crdt_1.MAX_VECTOR_CLOCK_SIZE; } });
+Object.defineProperty(exports, "DEFAULT_TOMBSTONE_TTL", { enumerable: true, get: function () { return crdt_1.DEFAULT_TOMBSTONE_TTL; } });
+Object.defineProperty(exports, "MAX_MERGE_DEPTH", { enumerable: true, get: function () { return crdt_1.MAX_MERGE_DEPTH; } });
+// Two-Machine Coordination (P2-007)
+// Note: Some types conflict with sharing and protocol modules
+var coordination_1 = require("./coordination");
+// Classes/Functions
+Object.defineProperty(exports, "CoordinationManager", { enumerable: true, get: function () { return coordination_1.CoordinationManager; } });
+Object.defineProperty(exports, "SyncOrchestrator", { enumerable: true, get: function () { return coordination_1.SyncOrchestrator; } });
+Object.defineProperty(exports, "HealthMonitor", { enumerable: true, get: function () { return coordination_1.HealthMonitor; } });
+// Types that don't conflict
+Object.defineProperty(exports, "CoordinationState", { enumerable: true, get: function () { return coordination_1.CoordinationState; } });
+Object.defineProperty(exports, "CoordinationRole", { enumerable: true, get: function () { return coordination_1.CoordinationRole; } });
+Object.defineProperty(exports, "HealthLevel", { enumerable: true, get: function () { return coordination_1.HealthLevel; } });
+Object.defineProperty(exports, "DEFAULT_COORDINATION_CONFIG", { enumerable: true, get: function () { return coordination_1.DEFAULT_COORDINATION_CONFIG; } });
+Object.defineProperty(exports, "CoordinationEventType", { enumerable: true, get: function () { return coordination_1.CoordinationEventType; } });
+Object.defineProperty(exports, "CoordinationMessageType", { enumerable: true, get: function () { return coordination_1.CoordinationMessageType; } });
+Object.defineProperty(exports, "CoordinationErrorCode", { enumerable: true, get: function () { return coordination_1.CoordinationErrorCode; } });
+Object.defineProperty(exports, "createDefaultCapabilities", { enumerable: true, get: function () { return coordination_1.createDefaultCapabilities; } });
+Object.defineProperty(exports, "createDefaultSyncStatus", { enumerable: true, get: function () { return coordination_1.createDefaultSyncStatus; } });
+Object.defineProperty(exports, "createDefaultMetrics", { enumerable: true, get: function () { return coordination_1.createDefaultMetrics; } });
+Object.defineProperty(exports, "createDefaultHealthStatus", { enumerable: true, get: function () { return coordination_1.createDefaultHealthStatus; } });
+Object.defineProperty(exports, "generateChallenge", { enumerable: true, get: function () { return coordination_1.generateChallenge; } });
+// Constants
+Object.defineProperty(exports, "COORDINATION_VERSION", { enumerable: true, get: function () { return coordination_1.COORDINATION_VERSION; } });
+Object.defineProperty(exports, "DEFAULT_PING_INTERVAL", { enumerable: true, get: function () { return coordination_1.DEFAULT_PING_INTERVAL; } });
+Object.defineProperty(exports, "DEFAULT_HEALTH_CHECK_INTERVAL", { enumerable: true, get: function () { return coordination_1.DEFAULT_HEALTH_CHECK_INTERVAL; } });
+Object.defineProperty(exports, "DEFAULT_RECONNECT_TIMEOUT", { enumerable: true, get: function () { return coordination_1.DEFAULT_RECONNECT_TIMEOUT; } });
+Object.defineProperty(exports, "MAX_RECONNECT_ATTEMPTS", { enumerable: true, get: function () { return coordination_1.MAX_RECONNECT_ATTEMPTS; } });
+Object.defineProperty(exports, "DEFAULT_SYNC_BATCH_SIZE", { enumerable: true, get: function () { return coordination_1.DEFAULT_SYNC_BATCH_SIZE; } });
+Object.defineProperty(exports, "HEALTH_RTT_WARNING_THRESHOLD", { enumerable: true, get: function () { return coordination_1.HEALTH_RTT_WARNING_THRESHOLD; } });
+Object.defineProperty(exports, "HEALTH_RTT_CRITICAL_THRESHOLD", { enumerable: true, get: function () { return coordination_1.HEALTH_RTT_CRITICAL_THRESHOLD; } });
+Object.defineProperty(exports, "HEALTH_PACKET_LOSS_WARNING", { enumerable: true, get: function () { return coordination_1.HEALTH_PACKET_LOSS_WARNING; } });
+Object.defineProperty(exports, "HEALTH_PACKET_LOSS_CRITICAL", { enumerable: true, get: function () { return coordination_1.HEALTH_PACKET_LOSS_CRITICAL; } });
+// Re-export generateMessageId from coordination with prefix (conflicts with protocol)
+var coordination_2 = require("./coordination");
+Object.defineProperty(exports, "generateCoordinationMessageId", { enumerable: true, get: function () { return coordination_2.generateMessageId; } });
+// NAT Traversal and TURN Fallback (P2-008)
+__exportStar(require("./nat"), exports);
+/**
+ * P2P Module version
+ */
+exports.P2P_VERSION = '1.0.0';
+/**
+ * P2P Module phase
+ */
+exports.P2P_PHASE = 'P2-Foundation';
+/**
+ * P2P module capabilities
+ */
+exports.P2P_CAPABILITIES = {
+    // P2-001: Cryptographic Identity
+    ed25519KeyGeneration: true,
+    identityManagement: true,
+    messageSigning: true,
+    signatureVerification: true,
+    keyRotation: true,
+    seedPhraseRecovery: true,
+    // P2-002: WebRTC
+    peerConnections: true,
+    dataChannels: true,
+    iceNegotiation: true,
+    signalingProtocol: true,
+    connectionPooling: true,
+    autoReconnect: true,
+    // P2-003: Protocol
+    binaryMessageEncoding: true,
+    messageCompression: true,
+    requestResponse: true,
+    pubSub: true,
+    messageRouting: true,
+    reliableDelivery: true,
+    rateLimiting: true,
+    protocolVersionNegotiation: true,
+    heartbeat: true,
+    deadLetterQueue: true,
+    // P2-004: Pattern Sharing
+    patternSharing: true,
+    patternSerialization: true,
+    patternAnonymization: true,
+    differentialPrivacy: true,
+    vectorSimilaritySearch: true,
+    patternDeduplication: true,
+    vectorClockSync: true,
+    conflictResolution: true,
+    gossipProtocol: true,
+    subscriptionFiltering: true,
+    // P2-005: Federated Learning
+    federatedLearning: true,
+    fedAvgAggregation: true,
+    fedProxAggregation: true,
+    secureAggregation: true,
+    gradientClipping: true,
+    differentialPrivacyFL: true,
+    byzantineResilience: true,
+    modelCheckpointing: true,
+    convergenceMonitoring: true,
+    // P2-006: CRDT Conflict Resolution
+    crdtGCounter: true,
+    crdtLWWRegister: true,
+    crdtORSet: true,
+    crdtPatternCRDT: true,
+    crdtVectorClocks: true,
+    crdtDeltaSync: true,
+    crdtTombstoneGC: true,
+    crdtConflictTracking: true,
+    // P2-007: Two-Machine Coordination
+    peerCoordination: true,
+    authenticationHandshake: true,
+    healthMonitoring: true,
+    syncOrchestration: true,
+    incrementalSync: true,
+    reconnectionManagement: true,
+    // P2-008: NAT Traversal
+    natTypeDetection: true,
+    turnManagement: true,
+    turnCredentialRefresh: true,
+    holePunching: true,
+    portPrediction: true,
+    connectivityTesting: true,
+    fallbackEscalation: true,
+};
+//# sourceMappingURL=index.js.map

package/dist/edge/p2p/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/edge/p2p/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;;;;;;;;;;;;;;;;;AAEH,yCAAyC;AACzC,2CAAyB;AAEzB,mCAAmC;AACnC,2CAAyB;AAEzB,iDAAiD;AACjD,6CAA2B;AAE3B,oCAAoC;AACpC,4CAA0B;AAE1B,6CAA6C;AAC7C,8CAA4B;AAE5B,0CAA0C;AAC1C,iFAAiF;AACjF,+BAiEgB;AAhEd,UAAU;AACV,gGAAA,QAAQ,OAAA;AACR,mGAAA,WAAW,OAAA;AACX,6FAAA,KAAK,OAAA;AACL,mGAAA,WAAW,OAAA;AACX,mGAAA,WAAW,OAAA;AACX,iGAAA,SAAS,OAAA;AACT,4BAA4B;AAC5B,gGAAA,QAAQ,OAAA;AAOR,oGAAA,YAAY,OAAA;AACZ,0GAAA,kBAAkB,OAAA;AAElB,mGAAA,WAAW,OAAA;AAkBX,4GAAA,oBAAoB,OAAA;AAEpB,qGAAA,aAAa,OAAA;AAGb,qGAAA,aAAa,OAAA;AAOb,6GAAA,qBAAqB,OAAA;AAKrB,YAAY;AACZ,oGAAA,YAAY,OAAA;AACZ,yGAAA,iBAAiB,OAAA;AACjB,6GAAA,qBAAqB,OAAA;AACrB,6GAAA,qBAAqB,OAAA;AACrB,6GAAA,qBAAqB,OAAA;AACrB,uGAAA,eAAe,OAAA;AAajB,oCAAoC;AACpC,8DAA8D;AAC9D,+CA2CwB;AA1CtB,oBAAoB;AACpB,mHAAA,mBAAmB,OAAA;AACnB,gHAAA,gBAAgB,OAAA;AAChB,6GAAA,aAAa,OAAA;AACb,4BAA4B;AAC5B,iHAAA,iBAAiB,OAAA;AACjB,gHAAA,gBAAgB,OAAA;AAEhB,2GAAA,WAAW,OAAA;AAMX,2HAAA,2BAA2B,OAAA;AAC3B,qHAAA,qBAAqB,OAAA;AAGrB,uHAAA,uBAAuB,OAAA;AAOvB,qHAAA,qBAAqB,OAAA;AACrB,yHAAA,yBAAyB,OAAA;AACzB,uHAAA,uBAAuB,OAAA;AACvB,oHAAA,oBAAoB,OAAA;AACpB,yHAAA,yBAAyB,OAAA;AACzB,iHAAA,iBAAiB,OAAA;AACjB,YAAY;AACZ,oHAAA,oBAAoB,OAAA;AACpB,qHAAA,qBAAqB,OAAA;AACrB,6HAAA,6BAA6B,OAAA;AAC7B,yHAAA,yBAAyB,OAAA;AACzB,sHAAA,sBAAsB,OAAA;AACtB,uHAAA,uBAAuB,OAAA;AACvB,4HAAA,4BAA4B,OAAA;AAC5B,6HAAA,6BAA6B,OAAA;AAC7B,0HAAA,0BAA0B,OAAA;AAC1B,2HAAA,2BAA2B,OAAA;AAS7B,sFAAsF;AACtF,+CAAoF;AAA3E,6HAAA,iBAAiB,OAAiC;AAE3D,2CAA2C;AAC3C,wCAAsB;AAEtB;;GAEG;AACU,QAAA,WAAW,GAAG,OAAO,CAAC;AAEnC;;GAEG;AACU,QAAA,SAAS,GAAG,eAAe,CAAC;AAEzC;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,iCAAiC;IACjC,oBAAoB,EAAE,IAAI;IAC1B,kBAAkB,EAAE,IAAI;IACxB,cAAc,EAAE,IAAI;IACpB,qBAAqB,EAAE,IAAI;IAC3B,WAAW,EAAE,IAAI;IACjB,kBAAkB,EAAE,IAAI;IAExB,iBAAiB;IACjB,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,IAAI;IAEnB,mBAAmB;IACnB,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;IACrB,MAAM,EAAE,IAAI;IACZ,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,0BAA0B,EAAE,IAAI;IAChC,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IAErB,0BAA0B;IAC1B,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,IAAI;IAC1B,oBAAoB,EAAE,IAAI;IAC1B,mBAAmB,EAAE,IAAI;IACzB,sBAAsB,EAAE,IAAI;IAC5B,oBAAoB,EAAE,IAAI;IAC1B,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,cAAc,EAAE,IAAI;IACpB,qBAAqB,EAAE,IAAI;IAE3B,6BAA6B;IAC7B,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,qBAAqB,EAAE,IAAI;IAC3B,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,IAAI;IACxB,qBAAqB,EAAE,IAAI;IAE3B,mCAAmC;IACnC,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,IAAI;IACrB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,oBAAoB,EAAE,IAAI;IAE1B,mCAAmC;IACnC,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,IAAI;IAC7B,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IACrB,sBAAsB,EAAE,IAAI;IAE5B,wBAAwB;IACxB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;IACpB,qBAAqB,EAAE,IAAI;IAC3B,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,IAAI;CACzB,CAAC"}

package/dist/edge/p2p/nat/ConnectivityTester.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Connectivity Tester for @ruvector/edge P2P
+ *
+ * Tests connectivity between peers, measures RTT, ranks connection candidates,
+ * and provides connectivity recommendations.
+ *
+ * @module edge/p2p/nat/ConnectivityTester
+ * @version 1.0.0
+ */
+import { PeerId, ICECandidate } from '../webrtc/types';
+import { ConnectivityTestResult, ConnectivityTesterConfig, CandidateRanking, ConnectivityRecommendation, NATClassification, TURNConfig, NATEventType, NATEventHandler } from './types';
+/**
+ * Connectivity Tester - Tests and ranks peer connectivity
+ *
+ * @example
+ * ```typescript
+ * const tester = new ConnectivityTester({
+ *   timeout: 15000,
+ *   pingCount: 10,
+ *   maxAcceptableRtt: 500,
+ * });
+ *
+ * // Test connectivity to peer
+ * const result = await tester.test(peerId, {
+ *   dataChannel: rtcDataChannel,
+ *   candidates: [...],
+ * });
+ *
+ * console.log('Connected:', result.connected);
+ * console.log('RTT:', result.rttMs);
+ *
+ * // Get recommendations
+ * const recommendation = tester.getRecommendation(candidates, localNat, remoteNat);
+ * ```
+ */
+export declare class ConnectivityTester {
+    private readonly config;
+    private eventHandlers;
+    private activeTests;
+    /**
+     * Create a new Connectivity Tester
+     *
+     * @param config - Tester configuration
+     */
+    constructor(config?: Partial<ConnectivityTesterConfig>);
+    /**
+     * Test connectivity to a peer
+     *
+     * @param peerId - Peer to test
+     * @param options - Test options
+     * @returns Promise resolving to test result
+     */
+    test(peerId: PeerId, options: {
+        dataChannel: RTCDataChannel;
+        candidates: ICECandidate[];
+    }): Promise<ConnectivityTestResult>;
+    /**
+     * Cancel an ongoing test
+     *
+     * @param peerId - Peer ID of test to cancel
+     */
+    cancelTest(peerId: PeerId): void;
+    /**
+     * Cancel all ongoing tests
+     */
+    cancelAllTests(): void;
+    /**
+     * Rank ICE candidates by quality
+     *
+     * @param candidates - Candidates to rank
+     * @param rttMeasurements - Optional RTT measurements per candidate
+     * @returns Ranked candidates
+     */
+    rankCandidates(candidates: ICECandidate[], rttMeasurements?: Map<string, number>): CandidateRanking[];
+    /**
+     * Get connectivity recommendation
+     *
+     * @param localCandidates - Local ICE candidates
+     * @param remoteCandidates - Remote ICE candidates
+     * @param localNat - Local NAT type
+     * @param remoteNat - Remote NAT type
+     * @param turnServers - Available TURN servers
+     * @returns Connectivity recommendation
+     */
+    getRecommendation(localCandidates: ICECandidate[], remoteCandidates: ICECandidate[], localNat: NATClassification, remoteNat: NATClassification, turnServers?: TURNConfig[]): ConnectivityRecommendation;
+    /**
+     * Test RTT to a specific endpoint
+     *
+     * @param dataChannel - Data channel to use
+     * @param pingCount - Number of pings
+     * @returns Promise resolving to average RTT
+     */
+    measureRtt(dataChannel: RTCDataChannel, pingCount?: number): Promise<number>;
+    /**
+     * Check if connectivity meets quality thresholds
+     *
+     * @param result - Test result to check
+     * @returns Whether connectivity is acceptable
+     */
+    isAcceptable(result: ConnectivityTestResult): boolean;
+    /**
+     * Register event handler
+     *
+     * @param type - Event type to handle
+     * @param handler - Event handler function
+     * @returns Unsubscribe function
+     */
+    on<T>(type: NATEventType, handler: NATEventHandler<T>): () => void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): ConnectivityTesterConfig;
+    private waitForChannelOpen;
+    private performPingTests;
+    private sendPing;
+    private measureBandwidth;
+    private calculateStats;
+    private determineConnectionPath;
+    private calculateCandidateRanking;
+    private calculateRttScore;
+    private calculateReliabilityScore;
+    private calculatePathScore;
+    private estimateRtt;
+    private delay;
+    private emitEvent;
+}
+export default ConnectivityTester;
+//# sourceMappingURL=ConnectivityTester.d.ts.map

package/dist/edge/p2p/nat/ConnectivityTester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectivityTester.d.ts","sourceRoot":"","sources":["../../../../src/edge/p2p/nat/ConnectivityTester.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,sBAAsB,EAEtB,wBAAwB,EACxB,gBAAgB,EAChB,0BAA0B,EAE1B,iBAAiB,EACjB,UAAU,EACV,YAAY,EAEZ,eAAe,EAGhB,MAAM,SAAS,CAAC;AA8BjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,aAAa,CAAsD;IAC3E,OAAO,CAAC,WAAW,CAA2C;IAE9D;;;;OAIG;gBACS,MAAM,GAAE,OAAO,CAAC,wBAAwB,CAAM;IAO1D;;;;;;OAMG;IACU,IAAI,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QACP,WAAW,EAAE,cAAc,CAAC;QAC5B,UAAU,EAAE,YAAY,EAAE,CAAC;KAC5B,GACA,OAAO,CAAC,sBAAsB,CAAC;IA0ElC;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACI,cAAc,IAAI,IAAI;IAO7B;;;;;;OAMG;IACI,cAAc,CACnB,UAAU,EAAE,YAAY,EAAE,EAC1B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,gBAAgB,EAAE;IAoBrB;;;;;;;;;OASG;IACI,iBAAiB,CACtB,eAAe,EAAE,YAAY,EAAE,EAC/B,gBAAgB,EAAE,YAAY,EAAE,EAChC,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,iBAAiB,EAC5B,WAAW,GAAE,UAAU,EAAO,GAC7B,0BAA0B;IAuD7B;;;;;;OAMG;IACU,UAAU,CACrB,WAAW,EAAE,cAAc,EAC3B,SAAS,GAAE,MAA8B,GACxC,OAAO,CAAC,MAAM,CAAC;IAWlB;;;;;OAKG;IACI,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO;IAQ5D;;;;;;OAMG;IACI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAQzE;;OAEG;IACI,SAAS,IAAI,wBAAwB;YAQ9B,kBAAkB;YA+BlB,gBAAgB;YAqBhB,QAAQ;YAiFR,gBAAgB;IAyE9B,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,yBAAyB;IAsBjC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,yBAAyB;IAsBjC,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,SAAS;CAiBlB;AAED,eAAe,kBAAkB,CAAC"}