@antseed/node 0.1.0

package/dist/discovery/dht-health.js

@@ -0,0 +1,101 @@
+export const DEFAULT_HEALTH_THRESHOLDS = {
+    minNodeCount: 5,
+    minLookupSuccessRate: 0.3,
+    maxAvgLookupLatencyMs: 15000,
+};
+export class DHTHealthMonitor {
+    thresholds;
+    getNodeCount;
+    _totalLookups = 0;
+    _successfulLookups = 0;
+    _failedLookups = 0;
+    _totalAnnounces = 0;
+    _successfulAnnounces = 0;
+    _failedAnnounces = 0;
+    latencySamples = [];
+    static MAX_LATENCY_SAMPLES = 100;
+    constructor(getNodeCount, thresholds = DEFAULT_HEALTH_THRESHOLDS) {
+        this.getNodeCount = getNodeCount;
+        this.thresholds = thresholds;
+    }
+    recordLookup(success, latencyMs) {
+        this._totalLookups++;
+        if (success) {
+            this._successfulLookups++;
+        }
+        else {
+            this._failedLookups++;
+        }
+        this.latencySamples.push(latencyMs);
+        if (this.latencySamples.length > DHTHealthMonitor.MAX_LATENCY_SAMPLES) {
+            this.latencySamples.shift();
+        }
+    }
+    recordAnnounce(success) {
+        this._totalAnnounces++;
+        if (success) {
+            this._successfulAnnounces++;
+        }
+        else {
+            this._failedAnnounces++;
+        }
+    }
+    getSnapshot() {
+        const nodeCount = this.getNodeCount();
+        const averageLookupLatencyMs = this.computeAverageLatency();
+        const healthy = this.evaluateHealth(nodeCount, averageLookupLatencyMs);
+        return {
+            nodeCount,
+            totalLookups: this._totalLookups,
+            successfulLookups: this._successfulLookups,
+            failedLookups: this._failedLookups,
+            totalAnnounces: this._totalAnnounces,
+            successfulAnnounces: this._successfulAnnounces,
+            failedAnnounces: this._failedAnnounces,
+            averageLookupLatencyMs,
+            isHealthy: healthy,
+        };
+    }
+    isHealthy() {
+        const nodeCount = this.getNodeCount();
+        const averageLookupLatencyMs = this.computeAverageLatency();
+        return this.evaluateHealth(nodeCount, averageLookupLatencyMs);
+    }
+    reset() {
+        this._totalLookups = 0;
+        this._successfulLookups = 0;
+        this._failedLookups = 0;
+        this._totalAnnounces = 0;
+        this._successfulAnnounces = 0;
+        this._failedAnnounces = 0;
+        this.latencySamples.length = 0;
+    }
+    computeAverageLatency() {
+        if (this.latencySamples.length === 0) {
+            return 0;
+        }
+        const sum = this.latencySamples.reduce((a, b) => a + b, 0);
+        return sum / this.latencySamples.length;
+    }
+    evaluateHealth(nodeCount, averageLookupLatencyMs) {
+        // Must have minimum node count
+        if (nodeCount < this.thresholds.minNodeCount) {
+            return false;
+        }
+        // Check lookup success rate (only if we have 5+ lookups)
+        if (this._totalLookups >= 5) {
+            const successRate = this._successfulLookups / this._totalLookups;
+            if (successRate < this.thresholds.minLookupSuccessRate) {
+                return false;
+            }
+        }
+        // Check average latency (only if we have 5+ samples)
+        if (this.latencySamples.length >= 5) {
+            if (averageLookupLatencyMs > this.thresholds.maxAvgLookupLatencyMs) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=dht-health.js.map

package/dist/discovery/dht-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dht-health.js","sourceRoot":"","sources":["../../src/discovery/dht-health.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,YAAY,EAAE,CAAC;IACf,oBAAoB,EAAE,GAAG;IACzB,qBAAqB,EAAE,KAAK;CAC7B,CAAC;AAEF,MAAM,OAAO,gBAAgB;IACV,UAAU,CAAmB;IAC7B,YAAY,CAAe;IACpC,aAAa,GAAG,CAAC,CAAC;IAClB,kBAAkB,GAAG,CAAC,CAAC;IACvB,cAAc,GAAG,CAAC,CAAC;IACnB,eAAe,GAAG,CAAC,CAAC;IACpB,oBAAoB,GAAG,CAAC,CAAC;IACzB,gBAAgB,GAAG,CAAC,CAAC;IACZ,cAAc,GAAa,EAAE,CAAC;IACvC,MAAM,CAAU,mBAAmB,GAAG,GAAG,CAAC;IAElD,YACE,YAA0B,EAC1B,aAA+B,yBAAyB;QAExD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,YAAY,CAAC,OAAgB,EAAE,SAAiB;QAC9C,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,CAAC;YACtE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,cAAc,CAAC,OAAgB;QAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,WAAW;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,sBAAsB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;QAEvE,OAAO;YACL,SAAS;YACT,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;YAC1C,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,mBAAmB,EAAE,IAAI,CAAC,oBAAoB;YAC9C,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,sBAAsB;YACtB,SAAS,EAAE,OAAO;SACnB,CAAC;IACJ,CAAC;IAED,SAAS;QACP,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,sBAAsB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAChE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IAEO,qBAAqB;QAC3B,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,OAAO,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;IAC1C,CAAC;IAEO,cAAc,CACpB,SAAiB,EACjB,sBAA8B;QAE9B,+BAA+B;QAC/B,IAAI,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,yDAAyD;QACzD,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,aAAa,CAAC;YACjE,IAAI,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;gBACvD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,sBAAsB,GAAG,IAAI,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC;gBACnE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC"}

package/dist/discovery/dht-node.d.ts

@@ -0,0 +1,34 @@
+import { EventEmitter } from "node:events";
+import type { PeerId } from "../types/peer.js";
+export interface DHTNodeConfig {
+    peerId: PeerId;
+    port: number;
+    bootstrapNodes: Array<{
+        host: string;
+        port: number;
+    }>;
+    reannounceIntervalMs: number;
+    operationTimeoutMs: number;
+    /** Allow private/loopback IPs in lookup results. Default: false. Set true for local testing. */
+    allowPrivateIPs?: boolean;
+}
+export declare const DEFAULT_DHT_CONFIG: Omit<DHTNodeConfig, "peerId">;
+export declare function topicToInfoHash(topic: string): Buffer;
+export declare function providerTopic(providerName: string): string;
+export declare function capabilityTopic(capability: string, name?: string): string;
+export declare class DHTNode {
+    private readonly config;
+    private dht;
+    readonly events: EventEmitter;
+    constructor(config: DHTNodeConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    announce(infoHash: Buffer, port: number): Promise<void>;
+    lookup(infoHash: Buffer): Promise<Array<{
+        host: string;
+        port: number;
+    }>>;
+    getNodeCount(): number;
+    getPort(): number;
+}
+//# sourceMappingURL=dht-node.d.ts.map

package/dist/discovery/dht-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dht-node.d.ts","sourceRoot":"","sources":["../../src/discovery/dht-node.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gGAAgG;IAChG,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAK5D,CAAC;AAgBF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,GAAG,CAAoB;IAC/B,SAAgB,MAAM,EAAE,YAAY,CAAsB;gBAE9C,MAAM,EAAE,aAAa;IAI3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAsC9E,YAAY,IAAI,MAAM;IAOtB,OAAO,IAAI,MAAM;CAWlB"}

package/dist/discovery/dht-node.js

@@ -0,0 +1,168 @@
+import DHT from "bittorrent-dht";
+import { createHash } from "node:crypto";
+import { EventEmitter } from "node:events";
+import { OFFICIAL_BOOTSTRAP_NODES, toBootstrapConfig } from "./bootstrap.js";
+export const DEFAULT_DHT_CONFIG = {
+    port: 6881,
+    bootstrapNodes: toBootstrapConfig(OFFICIAL_BOOTSTRAP_NODES),
+    reannounceIntervalMs: 15 * 60 * 1000,
+    operationTimeoutMs: 10_000,
+};
+function isPublicIP(host) {
+    if (host === "localhost" || host === "::1")
+        return false;
+    const parts = host.split(".");
+    if (parts.length !== 4)
+        return false;
+    const [a, b] = parts.map(Number);
+    if (a === 127)
+        return false; // loopback
+    if (a === 10)
+        return false; // 10.0.0.0/8
+    if (a === 172 && b !== undefined && b >= 16 && b <= 31)
+        return false; // 172.16.0.0/12
+    if (a === 192 && b === 168)
+        return false; // 192.168.0.0/16
+    if (a === 169 && b === 254)
+        return false; // link-local
+    if (a === 0)
+        return false;
+    return true;
+}
+export function topicToInfoHash(topic) {
+    return createHash("sha1").update(topic).digest();
+}
+export function providerTopic(providerName) {
+    return "antseed:" + providerName.toLowerCase();
+}
+export function capabilityTopic(capability, name) {
+    const base = "antseed:" + capability.toLowerCase();
+    return name ? base + ":" + name.toLowerCase() : base;
+}
+export class DHTNode {
+    config;
+    dht = null;
+    events = new EventEmitter();
+    constructor(config) {
+        this.config = config;
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.dht = new DHT({
+                bootstrap: this.config.bootstrapNodes.map((n) => `${n.host}:${n.port}`),
+            });
+            const timeout = setTimeout(() => {
+                // Resolve even on timeout — the DHT may still work with partial bootstrap.
+                // This prevents hanging when public bootstrap nodes are unreachable.
+                cleanup();
+                this.events.emit("ready");
+                resolve();
+            }, this.config.operationTimeoutMs);
+            let settled = false;
+            const cleanup = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeout);
+            };
+            this.dht.listen(this.config.port, () => {
+                // Socket is bound; now wait for DHT bootstrap to complete.
+                // The 'ready' event fires when the routing table has been populated.
+                this.dht.on("ready", () => {
+                    cleanup();
+                    this.events.emit("ready");
+                    resolve();
+                });
+            });
+            this.dht.on("error", (err) => {
+                cleanup();
+                reject(err);
+            });
+        });
+    }
+    async stop() {
+        return new Promise((resolve) => {
+            if (!this.dht) {
+                resolve();
+                return;
+            }
+            this.dht.destroy(() => {
+                this.dht = null;
+                resolve();
+            });
+        });
+    }
+    async announce(infoHash, port) {
+        return new Promise((resolve, reject) => {
+            if (!this.dht) {
+                reject(new Error("DHT not started"));
+                return;
+            }
+            const timeout = setTimeout(() => {
+                reject(new Error("Announce timeout"));
+            }, this.config.operationTimeoutMs);
+            this.dht.announce(infoHash, port, (err) => {
+                clearTimeout(timeout);
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    async lookup(infoHash) {
+        return new Promise((resolve) => {
+            if (!this.dht) {
+                resolve([]);
+                return;
+            }
+            const peers = [];
+            let done = false;
+            const onPeer = (peer, hash) => {
+                if (hash.equals(infoHash)) {
+                    if (peer.port < 1 || peer.port > 65535)
+                        return;
+                    if (!this.config.allowPrivateIPs && !isPublicIP(peer.host))
+                        return;
+                    peers.push({ host: peer.host, port: peer.port });
+                }
+            };
+            const finish = () => {
+                if (done)
+                    return;
+                done = true;
+                clearTimeout(timeout);
+                this.dht?.off("peer", onPeer);
+                resolve(peers);
+            };
+            this.dht.on("peer", onPeer);
+            const timeout = setTimeout(() => {
+                finish();
+            }, this.config.operationTimeoutMs);
+            this.dht.lookup(infoHash, () => {
+                finish();
+            });
+        });
+    }
+    getNodeCount() {
+        if (!this.dht) {
+            return 0;
+        }
+        return this.dht.nodes.toArray().length;
+    }
+    getPort() {
+        if (!this.dht) {
+            return this.config.port;
+        }
+        try {
+            const addr = this.dht.address();
+            return addr?.port ?? this.config.port;
+        }
+        catch {
+            return this.config.port;
+        }
+    }
+}
+//# sourceMappingURL=dht-node.js.map

package/dist/discovery/dht-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dht-node.js","sourceRoot":"","sources":["../../src/discovery/dht-node.ts"],"names":[],"mappings":"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"}

package/dist/discovery/http-metadata-resolver.d.ts

@@ -0,0 +1,15 @@
+import type { PeerEndpoint, MetadataResolver } from './metadata-resolver.js';
+import type { PeerMetadata } from './peer-metadata.js';
+export interface HttpMetadataResolverConfig {
+    /** Timeout in ms for each metadata fetch. Default: 5000 */
+    timeoutMs?: number;
+    /** Port offset from the signaling port to the metadata HTTP port. Default: 0 (same port) */
+    metadataPortOffset?: number;
+}
+export declare class HttpMetadataResolver implements MetadataResolver {
+    private readonly timeoutMs;
+    private readonly metadataPortOffset;
+    constructor(config?: HttpMetadataResolverConfig);
+    resolve(peer: PeerEndpoint): Promise<PeerMetadata | null>;
+}
+//# sourceMappingURL=http-metadata-resolver.d.ts.map

package/dist/discovery/http-metadata-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-metadata-resolver.d.ts","sourceRoot":"","sources":["../../src/discovery/http-metadata-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;gBAEhC,MAAM,CAAC,EAAE,0BAA0B;IAKzC,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CA0BhE"}

package/dist/discovery/http-metadata-resolver.js

@@ -0,0 +1,33 @@
+import { debugWarn } from '../utils/debug.js';
+export class HttpMetadataResolver {
+    timeoutMs;
+    metadataPortOffset;
+    constructor(config) {
+        this.timeoutMs = config?.timeoutMs ?? 5000;
+        this.metadataPortOffset = config?.metadataPortOffset ?? 0;
+    }
+    async resolve(peer) {
+        const metadataPort = peer.port + this.metadataPortOffset;
+        const url = `http://${peer.host}:${metadataPort}/metadata`;
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+            const response = await fetch(url, { signal: controller.signal });
+            clearTimeout(timeout);
+            if (!response.ok) {
+                return null;
+            }
+            return (await response.json());
+        }
+        catch (err) {
+            const reason = err instanceof DOMException && err.name === 'AbortError'
+                ? 'timeout'
+                : err instanceof SyntaxError
+                    ? 'invalid JSON'
+                    : 'network error';
+            debugWarn(`[MetadataResolver] Failed to resolve ${url}: ${reason}`);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=http-metadata-resolver.js.map

package/dist/discovery/http-metadata-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-metadata-resolver.js","sourceRoot":"","sources":["../../src/discovery/http-metadata-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAS9C,MAAM,OAAO,oBAAoB;IACd,SAAS,CAAS;IAClB,kBAAkB,CAAS;IAE5C,YAAY,MAAmC;QAC7C,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC;QAC3C,IAAI,CAAC,kBAAkB,GAAG,MAAM,EAAE,kBAAkB,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAkB;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACzD,MAAM,GAAG,GAAG,UAAU,IAAI,CAAC,IAAI,IAAI,YAAY,WAAW,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAErE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,YAAY,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;gBACrE,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,YAAY,WAAW;oBAC1B,CAAC,CAAC,cAAc;oBAChB,CAAC,CAAC,eAAe,CAAC;YACtB,SAAS,CAAC,wCAAwC,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,16 @@
+export { DHTNode, DEFAULT_DHT_CONFIG, topicToInfoHash, providerTopic, type DHTNodeConfig } from './dht-node.js';
+export { PeerAnnouncer, type AnnouncerConfig } from './announcer.js';
+export { PeerLookup, DEFAULT_LOOKUP_CONFIG, type LookupConfig, type LookupResult } from './peer-lookup.js';
+export { scorePeer, rankPeers, selectBestPeer, selectDiversePeers, DEFAULT_SCORING_WEIGHTS, type ScoringWeights, type PeerCandidate, type ScoredPeer } from './peer-selector.js';
+export { OFFICIAL_BOOTSTRAP_NODES, parseBootstrapList, mergeBootstrapNodes, toBootstrapConfig, type BootstrapNode } from './bootstrap.js';
+export { encodeMetadata, encodeMetadataForSigning, decodeMetadata } from './metadata-codec.js';
+export { validateMetadata, MAX_METADATA_SIZE, MAX_PROVIDERS, type ValidationError } from './metadata-validator.js';
+export { METADATA_VERSION, type PeerMetadata, type ProviderAnnouncement } from './peer-metadata.js';
+export { type MetadataResolver, type PeerEndpoint } from './metadata-resolver.js';
+export { DefaultMetadataResolver } from './default-metadata-resolver.js';
+export { HttpMetadataResolver, type HttpMetadataResolverConfig } from './http-metadata-resolver.js';
+export { DHTHealthMonitor, DEFAULT_HEALTH_THRESHOLDS, type DHTHealthSnapshot, type HealthThresholds } from './dht-health.js';
+export { ProfileManager, type ProfileManagerConfig } from './profile-manager.js';
+export { ProfileSearchIndex, type ProfileSearchQuery, type ProfileSearchResult } from './profile-search.js';
+export { verifyReputation, type ReputationVerification } from './reputation-verifier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjL,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1I,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACnH,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7H,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1,15 @@
+export { DHTNode, DEFAULT_DHT_CONFIG, topicToInfoHash, providerTopic } from './dht-node.js';
+export { PeerAnnouncer } from './announcer.js';
+export { PeerLookup, DEFAULT_LOOKUP_CONFIG } from './peer-lookup.js';
+export { scorePeer, rankPeers, selectBestPeer, selectDiversePeers, DEFAULT_SCORING_WEIGHTS } from './peer-selector.js';
+export { OFFICIAL_BOOTSTRAP_NODES, parseBootstrapList, mergeBootstrapNodes, toBootstrapConfig } from './bootstrap.js';
+export { encodeMetadata, encodeMetadataForSigning, decodeMetadata } from './metadata-codec.js';
+export { validateMetadata, MAX_METADATA_SIZE, MAX_PROVIDERS } from './metadata-validator.js';
+export { METADATA_VERSION } from './peer-metadata.js';
+export { DefaultMetadataResolver } from './default-metadata-resolver.js';
+export { HttpMetadataResolver } from './http-metadata-resolver.js';
+export { DHTHealthMonitor, DEFAULT_HEALTH_THRESHOLDS } from './dht-health.js';
+export { ProfileManager } from './profile-manager.js';
+export { ProfileSearchIndex } from './profile-search.js';
+export { verifyReputation } from './reputation-verifier.js';
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAsB,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,aAAa,EAAwB,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAwC,MAAM,kBAAkB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,uBAAuB,EAA4D,MAAM,oBAAoB,CAAC;AACjL,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAsB,MAAM,gBAAgB,CAAC;AAC1I,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAwB,MAAM,yBAAyB,CAAC;AACnH,OAAO,EAAE,gBAAgB,EAAgD,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAmC,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAiD,MAAM,iBAAiB,CAAC;AAC7H,OAAO,EAAE,cAAc,EAA6B,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAqD,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAA+B,MAAM,0BAA0B,CAAC"}

package/dist/discovery/metadata-codec.d.ts

@@ -0,0 +1,22 @@
+import type { PeerMetadata } from "./peer-metadata.js";
+/**
+ * Encode metadata into binary format:
+ * [version:1][peerId:32][regionLen:1][region:N][timestamp:8 BigUint64][providerCount:1]
+ * for each provider:
+ *   [providerLen:1][provider:N][modelCount:1][models...]
+ *   [defaultInputPrice:4][defaultOutputPrice:4]
+ *   [modelPricingCount:1][modelPricingEntries...]
+ *   [maxConcurrency:2][currentLoad:2]
+ * modelPricingEntry: [modelLen:1][model:N][inputPrice:4][outputPrice:4]
+ * [signature:64]
+ */
+export declare function encodeMetadata(metadata: PeerMetadata): Uint8Array;
+/**
+ * Encode metadata without signature, for signing purposes.
+ */
+export declare function encodeMetadataForSigning(metadata: PeerMetadata): Uint8Array;
+/**
+ * Decode binary metadata back into PeerMetadata.
+ */
+export declare function decodeMetadata(data: Uint8Array): PeerMetadata;
+//# sourceMappingURL=metadata-codec.d.ts.map

package/dist/discovery/metadata-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-codec.d.ts","sourceRoot":"","sources":["../../src/discovery/metadata-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,CAQjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,CAE3E;AAkKD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAgQ7D"}