@steve02081504/fount-p2p 0.0.4 → 0.0.6

package/transport/peer_identity_maps.mjs

@@ -34,61 +34,3 @@ export function pruneStaleRosterEntries(peerToNode, nodeToPeer, livePeerIds) {
 	}
 	return stale
 }
-
-/**
- * 创建 peer id 与 nodeHash 双向映射及 roster 查询辅助。
- * @param {object} [opts] 选项
- * @param {() => Iterable<string>} [opts.getLivePeerIds] 获取当前在线 peer id 的回调
- * @param {(stale: Array<{ peerId: string, remoteNodeHash?: string }>) => void} [opts.onStalePruned] stale 条目被清理时的回调
- * @returns {{ peerToNode: Map<string, string>, nodeToPeer: Map<string, string>, getRoster: () => Array<{ peerId: string, remoteNodeHash: string | undefined }>, getPeerIdByNodeHash: (nodeHash: string) => string | null, onPeerLeave: (peerId: string) => void }} 映射与查询接口
- */
-export function createPeerIdentityMaps(opts = {}) {
-	/** @type {Map<string, string>} */
-	const peerToNode = new Map()
-	/** @type {Map<string, string>} */
-	const nodeToPeer = new Map()
-	const getLivePeerIds = typeof opts.getLivePeerIds === 'function' ? opts.getLivePeerIds : null
-	const onStalePruned = typeof opts.onStalePruned === 'function' ? opts.onStalePruned : null
-
-	/**
-	 * 根据 live peer 集合清理 stale 映射。
-	 * @returns {void}
-	 */
-	const reconcile = () => {
-		if (!getLivePeerIds) return
-		const stale = pruneStaleRosterEntries(peerToNode, nodeToPeer, getLivePeerIds())
-		if (stale.length && onStalePruned) onStalePruned(stale)
-	}
-
-	return {
-		peerToNode,
-		nodeToPeer,
-		/**
-		 * 返回当前 roster（会先 reconcile stale 条目）。
-		 * @returns {Array<{ peerId: string, remoteNodeHash: string | undefined }>} roster 列表
-		 */
-		getRoster() {
-			reconcile()
-			return [...peerToNode.entries()].map(([peerId, remoteNodeHash]) => ({ peerId, remoteNodeHash }))
-		},
-		/**
-		 * 按 nodeHash 查找对应 peer id。
-		 * @param {string} targetNodeHash 目标节点 64 hex
-		 * @returns {string | null} 对端 id；无映射时为 null
-		 */
-		getPeerIdByNodeHash(targetNodeHash) {
-			reconcile()
-			return nodeToPeer.get(String(targetNodeHash).trim().toLowerCase()) || null
-		},
-		/**
-		 * peer 离线时从映射中移除。
-		 * @param {string} peerId 离线的 peer id
-		 * @returns {void}
-		 */
-		onPeerLeave(peerId) {
-			const remote = peerToNode.get(peerId)
-			if (remote) nodeToPeer.delete(remote)
-			peerToNode.delete(peerId)
-		},
-	}
-}

package/transport/peer_pool.mjs

@@ -141,7 +141,7 @@ export function selectExploreWithSourceQuota(exploreIds, exploreSources, k, maxP
  *   selfNodeHash: string,
  *   inRoomNodeHashes?: Set<string> | string[] 群内在线 node_id；有则优先，仅全不可达时用 explore 中非房内节点
  *   hintSources?: Map<string, string> explore 节点来源（用于配额）
- * }} opts 选取参数（roster、peers、rep、limits、selfNodeHash）
+ * }} options 选取参数（roster、peers、rep、limits、selfNodeHash）
  * @returns {string[]} 目标 Trystero peerId 列表（去重，长度 ≤ maxPeers）
  */
 export function selectPeerIdsFromPool({ roster, peers, rep, limits, selfNodeHash, inRoomNodeHashes, hintSources }) {
@@ -212,7 +212,7 @@ export function selectPeerIdsFromPool({ roster, peers, rep, limits, selfNodeHash
  *   peers: { trustedPeers: string[], explorePeers: string[], blockedPeers: string[], hintSources?: Map<string, string> },
  *   limits: ReturnType<typeof resolveFederationPoolLimits>,
  *   anchors?: Iterable<string>,
- * }} opts 选取参数（members、selfNodeHash、rep、peers、limits、anchors）
+ * }} options 选取参数（members、selfNodeHash、rep、peers、limits、anchors）
  * @returns {string[]} 应建链的 nodeHash 列表（去重）
  */
 export function selectLinkTargetsFromMembers({ members, selfNodeHash, rep, peers, limits, anchors = [] }) {
@@ -245,7 +245,7 @@ export function selectLinkTargetsFromMembers({ members, selfNodeHash, rep, peers
  *   rep: { byNodeHash?: Record<string, { score?: number }> },
  *   hints: string[],
  *   limits: ReturnType<typeof resolveFederationPoolLimits>,
- * }} opts 合并参数（peers、rep、hints、limits）
+ * }} options 合并参数（peers、rep、hints、limits）
  * @returns {{ trustedPeers: string[], explorePeers: string[] }} 更新后的 trusted/explore 列表
  */
 export function applyPexHints({ peers, rep, hints, limits }) {
@@ -275,7 +275,7 @@ export function applyPexHints({ peers, rep, hints, limits }) {
  *   rep: { byNodeHash?: Record<string, { score?: number }> },
  *   roster: Array<{ remoteNodeHash?: string }>,
  *   limits: ReturnType<typeof resolveFederationPoolLimits>,
- * }} opts roster 更新参数（peers、rep、roster、limits）
+ * }} options roster 更新参数（peers、rep、roster、limits）
  * @returns {{ trustedPeers: string[], explorePeers: string[] }} 更新后的 trusted/explore 列表
  */
 export function applyRosterToPeerPool({ peers, rep, roster, limits }) {

package/transport/remote_user_room.mjs

@@ -95,15 +95,3 @@ export async function ensureRemoteUserRoom(username, targetNodeHash) {
 	inflights.set(key, task)
 	return await task
 }
-
-/**
- * 释放目标节点的远端用户房间连接。
- * @param {string} targetNodeHash 目标节点 64 hex
- * @returns {void}
- */
-export function releaseRemoteUserRoom(targetNodeHash) {
-	const key = targetNodeHash.toLowerCase()
-	const slot = slots.get(key)
-	if (slot) void Promise.resolve(slot.leave()).catch(() => { })
-	slots.delete(key)
-}

package/transport/rtc_connection_budget.mjs

@@ -162,6 +162,8 @@ const NON_CRITICAL_FED_ACTIONS = new Set([
 	'fed_manifest_get',
 	'fed_manifest_data',
 	'part_invoke',
+	'part_query_req',
+	'part_query_res',
 	'discovery_announce',
 	'discovery_query',
 	'char_rpc',

package/transport/user_room.mjs

@@ -4,6 +4,7 @@ import { attachMailboxWire } from '../mailbox/wire.mjs'
 import { ensureNodeDefaults, getNodeHash } from '../node/identity.mjs'
 import { registerFederationRoomProvider } from '../registries/room_provider.mjs'
 import { attachPartWire } from '../wire/part_ingress.mjs'
+import { attachPartQueryWire } from '../wire/part_query.mjs'
 
 import { listLinks, sendToNodeLink, subscribeScope, getLinkRegistry } from './link_registry.mjs'
 import { USER_ROOM_SCOPE } from './room_scopes.mjs'
@@ -90,12 +91,12 @@ function activeLinkRoster() {
 
 /**
  * 初始化 node scope 订阅与 wire 派发（幂等）。
- * @param {{ replicaUsername?: string }} ctx 入站上下文
+ * @param {{ replicaUsername?: string }} wireContext 入站上下文
  * @returns {Promise<void>}
  */
-async function ensureNodeScopeRuntime(ctx) {
+async function ensureNodeScopeRuntime(wireContext) {
 	if (nodeScopeCleanup) return
-	nodeScopeReplicaUsername = String(ctx.replicaUsername || nodeScopeReplicaUsername || '')
+	nodeScopeReplicaUsername = String(wireContext.replicaUsername || nodeScopeReplicaUsername || '')
 	nodeScopeCleanup = subscribeScope('node', (senderNodeHash, envelope) => {
 		const handlers = nodeActionHandlers.get(String(envelope?.action || ''))
 		if (!handlers?.size) return
@@ -104,11 +105,12 @@ async function ensureNodeScopeRuntime(ctx) {
 	})
 	const wire = createNodeScopeWire()
 	nodeScopeWire = wire
-	attachPartWire({ replicaUsername: ctx.replicaUsername }, wire)
-	attachMailboxWire({ replicaUsername: ctx.replicaUsername }, wire)
-	attachUserRoomChunkHandlers(ctx.replicaUsername || '', wire)
+	attachPartWire({ replicaUsername: wireContext.replicaUsername }, wire)
+	attachPartQueryWire({ replicaUsername: wireContext.replicaUsername }, wire)
+	attachMailboxWire({ replicaUsername: wireContext.replicaUsername }, wire)
+	attachUserRoomChunkHandlers(wireContext.replicaUsername || '', wire)
 	for (const hook of nodeScopeWireHooks)
-		try { hook(ctx.replicaUsername || '', wire) } catch { /* ignore */ }
+		try { hook(wireContext.replicaUsername || '', wire) } catch { /* ignore */ }
 }
 
 /**
@@ -160,10 +162,10 @@ export function resolveUserRoomCredentials() {
 }
 
 /**
- * @param {{ replicaUsername?: string }} [ctx] 入站上下文（part/mailbox 派发用）
+ * @param {{ replicaUsername?: string }} [wireContext] 入站上下文（part/mailbox 派发用）
  * @returns {Promise<UserRoomSlot | null>} 用户级联邦房间槽
  */
-export async function ensureUserRoom(ctx = {}) {
+export async function ensureUserRoom(wireContext = {}) {
 	if (userRoomSlot) return userRoomSlot
 	if (userRoomInflight) return await userRoomInflight
 
@@ -171,7 +173,7 @@ export async function ensureUserRoom(ctx = {}) {
 		ensureNodeDefaults()
 		try {
 			await getLinkRegistry().ensureRuntime()
-			await ensureNodeScopeRuntime(ctx)
+			await ensureNodeScopeRuntime(wireContext)
 			const creds = resolveUserRoomCredentials()
 			/** @type {UserRoomSlot} */
 			userRoomSlot = {
@@ -217,17 +219,6 @@ export async function ensureUserRoom(ctx = {}) {
 	return await userRoomInflight
 }
 
-/**
- * @returns {void}
- */
-export function invalidateUserRoom() {
-	userRoomSlot = null
-	userRoomInflight = null
-	nodeScopeWire = null
-	nodeScopeReplicaUsername = ''
-	nodeScopeCleanup = null
-}
-
 /**
  * @param {string} username 副本用户名
  * @param {string} actionName 节点 scope action
@@ -247,9 +238,7 @@ export async function deliverToUserRoomPeers(username, actionName, payload, exce
 		.filter(({ peerId }) => peerId && peerId !== exceptPeerId)]
 	for (let swapIndex = peers.length - 1; swapIndex > 0; swapIndex--) {
 		const pickIndex = Math.floor(Math.random() * (swapIndex + 1))
-		const tmp = peers[swapIndex]
-		peers[swapIndex] = peers[pickIndex]
-		peers[pickIndex] = tmp
+		;[peers[swapIndex], peers[pickIndex]] = [peers[pickIndex], peers[swapIndex]]
 	}
 	for (const { peerId } of peers)
 		try {

package/trust_graph/cache.mjs

@@ -4,13 +4,6 @@ let revision = 0
 
 const DEFAULT_TTL_MS = 30_000
 
-/**
- * @returns {number} 当前 revision
- */
-export function getTrustGraphRevision() {
-	return revision
-}
-
 /**
  * @returns {void}
  */
@@ -36,9 +29,3 @@ export async function getCachedTrustGraph(username, build, ttlMs = DEFAULT_TTL_M
 	cacheByUsername.set(key, { graph, builtAt: now, revision })
 	return graph
 }
-
-/** @returns {void} 测试用 */
-export function clearTrustGraphCache() {
-	cacheByUsername.clear()
-	revision = 0
-}

package/trust_graph/engine.mjs

@@ -17,30 +17,6 @@ import trustGraphTunables from './tunables.json' with { type: 'json' }
  * }} TrustGraphInputs
  */
 
-/**
- * @returns {typeof trustGraphTunables} 默认 tunables
- */
-export function defaultTrustGraphTunables() {
-	return trustGraphTunables
-}
-
-/**
- * @param {Map<string, TrustNode>} byNode 累积图
- * @param {string} scopeId scope 标识
- * @param {string} nodeHash 64 位十六进制
- * @param {number} score 信誉分
- */
-export function mergeTrustNode(byNode, scopeId, nodeHash, score) {
-	const previous = byNode.get(nodeHash)
-	if (previous) {
-		const seenCount = previous.scopeIds.length
-		previous.score = (previous.score * seenCount + score) / (seenCount + 1)
-		if (!previous.scopeIds.includes(scopeId)) previous.scopeIds.push(scopeId)
-		return
-	}
-	byNode.set(nodeHash, { nodeHash, score, scopeIds: [scopeId] })
-}
-
 /**
  * @param {TrustGraphInputs} inputs 图输入
  * @param {typeof trustGraphTunables} [tunables] tunables

package/utils/async_mutex.mjs

@@ -58,12 +58,3 @@ export async function withAsyncMutex(key, fn) {
 		}
 	})
 }
-
-/**
- * @param {string} keyPrefix 前缀
- * @returns {(key: string, fn: () => Promise<T>) => Promise<T>} 带前缀的 mutex 函数
- * @template T
- */
-export function asyncMutexForPrefix(keyPrefix) {
-	return (key, fn) => withAsyncMutex(`${keyPrefix}:${key}`, fn)
-}

package/wire/group_part.mjs

@@ -29,14 +29,14 @@ function wrapWireOn(wire, groupId) {
 
 /**
  * 群联邦房间挂载 part_wire（要求线载荷带 `groupId`）。
- * @param {{ replicaUsername?: string }} ctx 入站上下文
+ * @param {{ replicaUsername?: string }} wireContext 入站上下文
  * @param {string} groupId 群 ID
  * @param {import('./part_ingress.mjs').PartWireAdapter} wire Trystero 适配器
  * @param {{ allowPartInvoke?: (payload: object) => boolean }} [options] 入站过滤
  * @returns {void}
  */
-export function attachGroupPartWire(ctx, groupId, wire, options = {}) {
-	attachPartWire(ctx, {
+export function attachGroupPartWire(wireContext, groupId, wire, options = {}) {
+	attachPartWire(wireContext, {
 		send: wire.send.bind(wire),
 		on: wrapWireOn(wire, groupId),
 	}, options)

package/wire/part_fanout.mjs

@@ -50,22 +50,3 @@ export async function collectPartInvokeResponses(username, partpath, invoke, tim
 
 	return waitForResponses
 }
-
-/**
- * 单向 part_invoke fanout（mailbox put 等）。
- * @param {string} username 用户
- * @param {string} partpath part 路径
- * @param {import('./part_invoke.mjs').PartInvoke} invoke 调用体
- * @param {number} limit fanout 上限
- * @param {string} [nodeHash] 来源节点
- * @param {string} [groupId] 群上下文
- * @returns {Promise<number>} 发送次数
- */
-export async function fanoutPartInvoke(username, partpath, invoke, limit, nodeHash, groupId) {
-	return requireTrustGraphProvider(DEFAULT_TRUST_GRAPH_OWNER).fanoutToTopNodes(username, 'part_invoke', buildPartInvokePayload({
-		partpath,
-		invoke,
-		nodeHash,
-		groupId,
-	}), limit)
-}

package/wire/part_ingress.mjs

@@ -45,16 +45,16 @@ function parsePartTimelinePut(data, partpath) {
 }
 
 /**
- * @param {PartWireContext} ctx 入站上下文
+ * @param {PartWireContext} wireContext 入站上下文
  * @param {object} payload part_invoke 请求
  * @returns {Promise<PartInvokeResponse | null>} RPC 处理器返回值
  */
-async function dispatchPartInvoke(ctx, payload) {
+async function dispatchPartInvoke(wireContext, payload) {
 	const partpath = normalizePartpath(payload?.partpath)
 	const invoke = payload?.invoke
 	if (!partpath || !isPlainObject(invoke)) return null
 	return dispatchRpcInbound({
-		replicaUsername: ctx.replicaUsername,
+		replicaUsername: wireContext.replicaUsername,
 		requesterNodeHash: payload.nodeHash ? String(payload.nodeHash).trim() : null,
 		groupId: payload.groupId ? String(payload.groupId).trim() : undefined,
 		peerId: payload.peerId,
@@ -70,12 +70,12 @@ async function dispatchPartInvoke(ctx, payload) {
 
 /**
  * 挂载 part_timeline_put / part_invoke / part_invoke_response。
- * @param {PartWireContext} ctx 入站上下文
+ * @param {PartWireContext} wireContext 入站上下文
  * @param {PartWireAdapter} wire Trystero 适配器
  * @param {{ allowPartInvoke?: (payload: object) => boolean }} [options] 入站过滤
  * @returns {void}
  */
-export function attachPartWire(ctx, wire, options = {}) {
+export function attachPartWire(wireContext, wire, options = {}) {
 	wire.on('part_timeline_put', data => {
 		if (!isPlainObject(data)) return
 		const partpath = normalizePartpath(data.partpath)
@@ -83,7 +83,7 @@ export function attachPartWire(ctx, wire, options = {}) {
 		const message = parsePartTimelinePut(data, partpath)
 		if (!message) return
 		void dispatchDeliveryInbound({
-			replicaUsername: ctx.replicaUsername,
+			replicaUsername: wireContext.replicaUsername,
 			requesterNodeHash: data.nodeHash ? String(data.nodeHash).trim() : null,
 		}, message)
 	})
@@ -93,9 +93,9 @@ export function attachPartWire(ctx, wire, options = {}) {
 		if (options.allowPartInvoke?.(data) === false) return
 		const payload = { ...data, peerId }
 		if (payload.requestId)
-			void handleIncomingPartInvokeRequest(ctx, payload, wire, peerId)
+			void handleIncomingPartInvokeRequest(wireContext, payload, wire, peerId)
 		else
-			void handleIncomingPartInvokeFireAndForget(ctx, payload, wire, peerId)
+			void handleIncomingPartInvokeFireAndForget(wireContext, payload, wire, peerId)
 	})
 
 	wire.on('part_invoke_response', (data, peerId) => {
@@ -105,17 +105,17 @@ export function attachPartWire(ctx, wire, options = {}) {
 }
 
 /**
- * @param {PartWireContext} ctx 入站上下文
+ * @param {PartWireContext} wireContext 入站上下文
  * @param {object} payload part_invoke 请求（含 requestId）
  * @param {PartWireAdapter} wire 发送适配器
  * @param {string} peerId 对端
  * @returns {Promise<void>}
  */
-export async function handleIncomingPartInvokeRequest(ctx, payload, wire, peerId) {
+export async function handleIncomingPartInvokeRequest(wireContext, payload, wire, peerId) {
 	const partpath = normalizePartpath(payload?.partpath)
 	if (!partpath || !payload.requestId) return
 
-	const response = await dispatchPartInvoke(ctx, { ...payload, peerId })
+	const response = await dispatchPartInvoke(wireContext, { ...payload, peerId })
 	if (response == null || !isPartInvokeResponse(response)) return
 
 	try {
@@ -129,17 +129,17 @@ export async function handleIncomingPartInvokeRequest(ctx, payload, wire, peerId
 }
 
 /**
- * @param {PartWireContext} ctx 入站上下文
+ * @param {PartWireContext} wireContext 入站上下文
  * @param {object} payload part_invoke 请求（无 requestId）
  * @param {PartWireAdapter} wire 发送适配器
  * @param {string} peerId 对端
  * @returns {Promise<void>}
  */
-export async function handleIncomingPartInvokeFireAndForget(ctx, payload, wire, peerId) {
+export async function handleIncomingPartInvokeFireAndForget(wireContext, payload, wire, peerId) {
 	const partpath = normalizePartpath(payload?.partpath)
 	if (!partpath) return
 
-	const response = await dispatchPartInvoke(ctx, { ...payload, peerId })
+	const response = await dispatchPartInvoke(wireContext, { ...payload, peerId })
 	const followUp = unwrapPartInvokeResult(response)
 	if (!isPartInvoke(followUp)) return
 	try {