@pkcprotocol/pkc-js 0.0.106 → 0.0.108

package/dist/bundled/chunks/{util-DUR-gvDQ.js → util-B-wz3mKY.js}

@@ -1,4 +1,4 @@
-import { rt as pubsubTopicToDhtKeyCid, wr as PKCError } from "./schema-B4n6Xctr.js";
+import { Ar as PKCError, z as pubsubTopicToDhtKeyCid } from "./util-C6zDjhpr.js";
 import { ipnsSelector } from "ipns/selector";
 import { ipnsValidator } from "ipns/validator";
 import { unmarshalIPNSRecord } from "ipns";
@@ -341,6 +341,12 @@ async function* fetchBlockWithStalledSessionFailover(args) {
 		fallbackController.abort(loserAbortReason);
 	}
 }
+const REACHABILITY_DOCS_URL = "https://github.com/pkcprotocol/pkc-js/blob/master/docs/reachability.md";
+function summarizeProviderReachability({ providers, subscribersTried }) {
+	if (subscribersTried > 0 || providers.length === 0) return void 0;
+	if (providers.some((provider) => provider.verdict === "dialed")) return void 0;
+	return providers.every((provider) => provider.verdict === "relay-only") ? "relay-only-providers" : "no-dialable-provider-addrs";
+}
 async function directFetchIpnsRecordFromProviders({ helia, pubsubTopic, routingKey, maxPeers, validate, options, log }) {
 	if (options?.signal?.aborted) throw new PKCError("ERR_IPNS_DIRECT_FETCH_ABORTED", {
 		pubsubTopic,
@@ -353,6 +359,11 @@ async function directFetchIpnsRecordFromProviders({ helia, pubsubTopic, routingK
 	const resultController = new AbortController();
 	let winner;
 	const peerToError = {};
+	const providerReachability = /* @__PURE__ */ new Map();
+	const markProviderDialed = (peerId) => {
+		const entry = providerReachability.get(peerId.toString());
+		if (entry) entry.verdict = "dialed";
+	};
 	const recordErr = (peerId, e) => {
 		const err = e;
 		peerToError[peerId.toString()] = {
@@ -404,6 +415,7 @@ async function directFetchIpnsRecordFromProviders({ helia, pubsubTopic, routingK
 				if (winner || resultController.signal.aborted || options?.signal?.aborted) return "done";
 				const directAddrs = ((await helia.libp2p.peerStore.get(peerId).catch(() => void 0))?.addresses ?? []).map(({ multiaddr }) => multiaddr).filter((addr) => !multiaddrIsCircuitRelay(addr));
 				if (directAddrs.length === 0 || !await helia.libp2p.isDialable(directAddrs)) return "not-ready";
+				markProviderDialed(peerId);
 				try {
 					const dialSignal = options?.signal ? AbortSignal.any([options.signal, resultController.signal]) : resultController.signal;
 					const dialTargets = directAddrs.map((addr) => {
@@ -427,20 +439,32 @@ async function directFetchIpnsRecordFromProviders({ helia, pubsubTopic, routingK
 				if (resultController.signal.aborted) break;
 				const announcedAddrs = peer.multiaddrs ?? [];
 				if (announcedAddrs.length > 0 && announcedAddrs.every(multiaddrIsCircuitRelay)) {
+					providerReachability.set(peer.id.toString(), {
+						peerId: peer.id.toString(),
+						verdict: "relay-only",
+						announcedAddrs: announcedAddrs.map(String)
+					});
 					await helia.libp2p.peerStore.merge(peer.id, { multiaddrs: announcedAddrs }).catch(() => void 0);
 					log.trace("Skipping dial to circuit-only provider", peer.id.toString(), "for topic", pubsubTopic);
 					retryScheduler.markRetryable(peer.id);
 					continue;
 				}
 				const hasDialableAddr = announcedAddrs.length > 0 && await helia.libp2p.isDialable(announcedAddrs);
+				providerReachability.set(peer.id.toString(), {
+					peerId: peer.id.toString(),
+					verdict: hasDialableAddr ? "dialed" : "no-dialable-addrs",
+					announcedAddrs: announcedAddrs.map(String)
+				});
 				dialFetchTasks.push((async () => {
 					try {
 						if (peer.multiaddrs?.length) await helia.libp2p.peerStore.merge(peer.id, { multiaddrs: peer.multiaddrs });
 						const dialSignal = options?.signal ? AbortSignal.any([options.signal, resultController.signal]) : resultController.signal;
 						await helia.libp2p.dial(peer.id, { signal: dialSignal });
+						markProviderDialed(peer.id);
 						await tryFetchFromPeer(peer.id, "provider");
 					} catch (e) {
 						if (isDialRetryableAfterAddrMerge(e)) retryScheduler.markRetryable(peer.id);
+						else markProviderDialed(peer.id);
 						recordErr(peer.id, e);
 					}
 				})());
@@ -466,6 +490,12 @@ async function directFetchIpnsRecordFromProviders({ helia, pubsubTopic, routingK
 		peerToError,
 		...getHeliaDebugContext(helia)
 	});
+	return {
+		providers: [...providerReachability.values()],
+		subscribersTried: subscriberTasks.length,
+		peerToError,
+		durationMs: Date.now() - start
+	};
 }
 async function cacheIpnsRecordInPubsubLocalStore({ localStore, routingKey, marshalledRecord }) {
 	if (await localStore.has(routingKey)) {
@@ -500,4 +530,4 @@ async function readFreshCachedIpnsRecordFromPubsubLocalStore({ localStore, routi
 	return record;
 }
 //#endregion
-export { fetchBlockWithStalledSessionFailover as a, selectBitswapSessionSeedPeers as c, directFetchIpnsRecordFromProviders as i, cacheIpnsRecordInPubsubLocalStore as n, getHeliaDebugContext as o, connectToPubsubPeers as r, readFreshCachedIpnsRecordFromPubsubLocalStore as s, BITSWAP_SESSION_STALLED_GET_FAILOVER_MS as t };
+export { directFetchIpnsRecordFromProviders as a, readFreshCachedIpnsRecordFromPubsubLocalStore as c, connectToPubsubPeers as i, selectBitswapSessionSeedPeers as l, REACHABILITY_DOCS_URL as n, fetchBlockWithStalledSessionFailover as o, cacheIpnsRecordInPubsubLocalStore as r, getHeliaDebugContext as s, BITSWAP_SESSION_STALLED_GET_FAILOVER_MS as t, summarizeProviderReachability as u };