@steve02081504/fount-p2p 0.0.8 → 0.0.9

package/discovery/bt/index.mjs

@@ -252,14 +252,15 @@ export function createBluetoothDiscoveryProvider() {
 
 	/**
 	 * Central：按 peer hint 连接并对端 signal characteristic 写短包。
+	 * 无 hint 时返回 false（正常降级，不算错误）。
 	 * @param {string} topic 信令 topic
 	 * @param {string} to 目标 nodeHash
 	 * @param {Uint8Array} bytes 载荷
-	 * @returns {Promise<void>}
+	 * @returns {Promise<boolean>} 是否投递
 	 */
 	async function sendSignalViaGatt(topic, to, bytes) {
 		const hint = getBtPeerHint(to)
-		if (!hint) throw new Error('p2p: bt signal missing peer hint')
+		if (!hint) return false
 		const blob = Buffer.from(JSON.stringify({
 			topic: String(topic),
 			to: String(to),
@@ -324,20 +325,13 @@ export function createBluetoothDiscoveryProvider() {
 		finally {
 			try { await peripheral.disconnectAsync() } catch { /* ignore */ }
 		}
+		return true
 	}
 
 	return {
 		id: 'bt',
 		priority: 20,
 		caps: { canDiscover: true, canSignal: true, canRelay: false },
-		/**
-		 * 是否具备对该 peer 的 GATT 信令能力（需未过期 BT peer hint）。
-		 * @param {string} to 目标 nodeHash
-		 * @returns {boolean} 有 hint 则可尝试
-		 */
-		canSignalTo(to) {
-			return !!getBtPeerHint(to)
-		},
 		/**
 		 * 广播指定 topic 的 advert。
 		 * @param {string} topic advert 主题
@@ -364,14 +358,14 @@ export function createBluetoothDiscoveryProvider() {
 			return addListener(advertListeners, String(topic), onAdvert)
 		},
 		/**
-		 * 经 GATT 向近场 peer 发送信令。
+		 * 经 GATT 向近场 peer 发送信令；无 peer hint 时返回 false。
 		 * @param {string} topic 信令 topic
 		 * @param {string} to 目标 nodeHash
 		 * @param {Uint8Array} bytes 载荷
-		 * @returns {Promise<void>}
+		 * @returns {Promise<boolean>} 是否投递
 		 */
-		async sendSignal(topic, to, bytes) {
-			await sendSignalViaGatt(topic, to, bytes)
+		sendSignal(topic, to, bytes) {
+			return sendSignalViaGatt(topic, to, bytes)
 		},
 		/**
 		 * 监听经本机 peripheral signal characteristic 写入的信令。

package/discovery/index.mjs

@@ -1,4 +1,4 @@
-/** @typedef {{ id: string, priority: number, caps: { canDiscover?: boolean, canSignal?: boolean, canRelay?: boolean }, advertise?: (topic: string, bytes: Uint8Array) => (() => void) | Promise<() => void>, subscribe?: (topic: string, onAdvert: (bytes: Uint8Array, meta?: object) => void) => (() => void) | Promise<() => void>, canSignalTo?: (to: string) => boolean, sendSignal?: (topic: string, to: string, bytes: Uint8Array) => void | Promise<void>, onSignal?: (topic: string, onSignal: (bytes: Uint8Array, meta?: object) => void) => (() => void) | Promise<() => void> }} DiscoveryProvider */
+/** @typedef {{ id: string, priority: number, caps: { canDiscover?: boolean, canSignal?: boolean, canRelay?: boolean }, advertise?: (topic: string, bytes: Uint8Array) => (() => void) | Promise<() => void>, subscribe?: (topic: string, onAdvert: (bytes: Uint8Array, meta?: object) => void) => (() => void) | Promise<() => void>, sendSignal?: (topic: string, to: string, bytes: Uint8Array) => boolean | void | Promise<boolean | void>, onSignal?: (topic: string, onSignal: (bytes: Uint8Array, meta?: object) => void) => (() => void) | Promise<() => void> }} DiscoveryProvider */
 
 /** @type {Map<string, DiscoveryProvider>} */
 const providers = new Map()
@@ -33,6 +33,7 @@ export function listDiscoveryProviders() {
 
 /**
  * 通过所有可用 provider 广播 topic advert。
+ * 单路失败静默（正常降级）；其它 provider 仍可成功。
  * @param {string} topic advert 主题
  * @param {Uint8Array} bytes advert 载荷
  * @returns {Promise<() => void>} 统一取消函数
@@ -45,10 +46,7 @@ export async function advertiseTopic(topic, bytes) {
 		try {
 			cleanup = await provider.advertise(topic, bytes)
 		}
-		catch (error) {
-			console.warn(`p2p: discovery advertise failed for ${provider.id}`, error)
-			continue
-		}
+		catch { continue }
 		if (typeof cleanup === 'function') cleanups.push(cleanup)
 	}
 	return () => {
@@ -59,6 +57,7 @@ export async function advertiseTopic(topic, bytes) {
 
 /**
  * 通过所有可用 provider 订阅 topic advert。
+ * 单路失败静默（正常降级）。
  * @param {string} topic advert 主题
  * @param {(bytes: Uint8Array, meta?: object) => void} onAdvert advert 回调
  * @returns {Promise<() => void>} 统一取消函数
@@ -71,10 +70,7 @@ export async function subscribeTopic(topic, onAdvert) {
 		try {
 			cleanup = await provider.subscribe(topic, onAdvert)
 		}
-		catch (error) {
-			console.warn(`p2p: discovery subscribe failed for ${provider.id}`, error)
-			continue
-		}
+		catch { continue }
 		if (typeof cleanup === 'function') cleanups.push(cleanup)
 	}
 	return () => {
@@ -85,6 +81,8 @@ export async function subscribeTopic(topic, onAdvert) {
 
 /**
  * 通过 discovery provider 发送信令。
+ * provider 返回 `false` = 本路不可达（正常降级，不计成功）；其它返回值 / void = 已投递。
+ * 单路 throw 静默；全部未投递才 throw。
  * @param {string} topic 信令 topic
  * @param {string} to 目标节点标识
  * @param {Uint8Array} bytes 信令载荷
@@ -95,19 +93,19 @@ export async function sendSignal(topic, to, bytes) {
 	if (!capable.length) throw new Error('p2p: no discovery provider can signal')
 	let sent = false
 	let lastError = null
-	for (const provider of capable) if (provider?.canSignalTo?.(to)) try {
-		await Promise.resolve(provider.sendSignal(topic, to, bytes))
-		sent = true
+	for (const provider of capable) try {
+		if (await Promise.resolve(provider.sendSignal(topic, to, bytes)) !== false)
+			sent = true
 	}
 	catch (error) {
 		lastError = error
-		console.warn(`p2p: discovery signal failed for ${provider.id}`, error)
 	}
 	if (!sent) throw lastError || new Error('p2p: no discovery provider delivered signal')
 }
 
 /**
  * 通过所有可用 provider 监听信令。
+ * 单路失败静默（正常降级）。
  * @param {string} topic 信令 topic
  * @param {(bytes: Uint8Array, meta?: object) => void} onSignal 信令回调
  * @returns {Promise<() => void>} 统一取消函数
@@ -120,10 +118,7 @@ export async function listenSignals(topic, onSignal) {
 		try {
 			cleanup = await provider.onSignal(topic, onSignal)
 		}
-		catch (error) {
-			console.warn(`p2p: discovery signal listener failed for ${provider.id}`, error)
-			continue
-		}
+		catch { continue }
 		if (typeof cleanup === 'function') cleanups.push(cleanup)
 	}
 	return () => {

package/files/chunk_responder.mjs

@@ -94,14 +94,12 @@ export function attachTrustGraphFedChunkResponder(username, room, fedOut, guardG
 				 */
 				const send = () => {
 					try { sendChunkData(resp, pid) }
-					catch (error) {
-						console.warn('federation: trust-graph chunk response failed', error)
-					}
+					catch { /* peer gone — normal */ }
 				}
 				if (fedOut) fedOut.enqueue(6, send)
 				else send()
 			})
-		})().catch(error => console.warn('federation: trust-graph chunk handler failed', error))
+		})().catch(() => { /* peer/handler race — normal degrade */ })
 	})
 
 	getChunkData(data => {
@@ -120,14 +118,12 @@ export function attachTrustGraphFedChunkResponder(username, room, fedOut, guardG
 				 */
 				const send = () => {
 					try { sendManifestData(resp, pid) }
-					catch (error) {
-						console.warn('federation: trust-graph manifest response failed', error)
-					}
+					catch { /* peer gone — normal */ }
 				}
 				if (fedOut) fedOut.enqueue(6, send)
 				else send()
 			})
-		})().catch(error => console.warn('federation: trust-graph manifest handler failed', error))
+		})().catch(() => { /* peer/handler race — normal degrade */ })
 	})
 
 	getManifestData(data => {

package/link/rtc.mjs

@@ -8,7 +8,7 @@ import { wrapRtcPeerConnectionForMdns } from '../transport/rtc_mdns_filter.mjs'
  * libdatachannel 的原生线程在 pc.close() 后仍需时间回收；进程退出时若原生资源未同步销毁，
  * Windows 上会触发堆损坏（退出码 0xC0000374）。
  */
-const { cleanup = undefined } = await import('node-datachannel').catch(console.error)
+const { cleanup = undefined } = await import('node-datachannel').catch(() => ({}))
 process.on('exit', () => {
 	try { cleanup?.() } catch { /* already torn down */ }
 })

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@steve02081504/fount-p2p",
-	"version": "0.0.8",
+	"version": "0.0.9",
 	"description": "fount federation P2P layer — link, trust graph, mailbox, DAG, EVFS.",
 	"keywords": [
 		"network",

package/transport/link_registry.mjs

@@ -347,9 +347,7 @@ export function createLinkRegistry(options = {}) {
 				})
 				if (typeof stop === 'function') stopLinkListeners.push(stop)
 			}
-			catch (error) {
-				console.warn(`p2p: link provider listening failed for ${provider.id}`, error)
-			}
+			catch { /* provider listen unavailable — normal degrade */ }
 		
 		if (listDiscoveryProviders().length) {
 			stopSignalListener = await listenSignals(selfTopic, bytes => {
@@ -591,16 +589,12 @@ export function createLinkRegistry(options = {}) {
 						// soft-fail 返回 null（不 throw）；必须 continue 才能落到更低 level。
 						const link = await dialOfferAnswer(provider, normalized)
 						if (link) return link
-						console.warn(`p2p: link dial failed for ${provider.id}: soft-fail`)
 						continue
 					}
 					const link = await dialProvider(provider, normalized)
 					if (link) return link
-					console.warn(`p2p: link dial failed for ${provider.id}: soft-fail`)
-				}
-				catch (error) {
-					console.warn(`p2p: link dial failed for ${provider.id}: ${error?.message ?? error}`)
 				}
+				catch { /* dial failed — try next provider */ }
 			
 			return null
 		})().finally(() => inflights.delete(normalized))