@steve02081504/fount-p2p 0.0.4 → 0.0.5

package/node/personal_block.mjs

@@ -104,41 +104,6 @@ export async function loadPersonalBlockEntries(viewerEntityHash) {
 	return normalizePersonalListEntries(data?.blocked || [])
 }
 
-/**
- * @param {string} viewerEntityHash 观看者实体
- * @param {object} subject 待检主体
- * @returns {Promise<boolean>} 是否被隐藏
- */
-export async function isHiddenBy(viewerEntityHash, subject) {
-	return matchesPersonalListEntries(await loadPersonalHideEntries(viewerEntityHash), subject)
-}
-
-/**
- * @param {string} viewerEntityHash 观看者实体
- * @param {object} subject 待检主体
- * @returns {Promise<boolean>} 是否被拉黑
- */
-export async function isBlockedBy(viewerEntityHash, subject) {
-	return matchesPersonalListEntries(await loadPersonalBlockEntries(viewerEntityHash), subject)
-}
-
-/**
- * @param {string} viewerEntityHash 观看者实体
- * @param {object} subject 待检主体
- * @returns {Promise<boolean>} 是否应过滤
- */
-export async function isFilteredByPersonalLists(viewerEntityHash, subject) {
-	if (!viewerEntityHash) return false
-	const [blocked, hidden, muted] = await Promise.all([
-		loadPersonalBlockEntries(viewerEntityHash),
-		loadPersonalHideEntries(viewerEntityHash),
-		loadPersonalMuteEntries(viewerEntityHash),
-	])
-	return matchesPersonalListEntries(blocked, subject)
-		|| matchesPersonalListEntries(hidden, subject)
-		|| matchesPersonalListEntries(muted, subject)
-}
-
 /**
  * @param {string} viewerEntityHash 本地可写实体
  * @param {string} targetEntityHash 目标

package/node/reputation_store.mjs

@@ -7,7 +7,6 @@ import {
 	bumpChunkStorageReputationPure,
 	bumpReputationOnRelayPure,
 	ensureReputationShape,
-	isQuarantinedPure,
 	observeBehaviorSamplePure,
 	penalizeArchiveServeMismatchPure,
 	penalizeChunkStorageFailurePure,
@@ -145,14 +144,6 @@ export async function observePeerBehavior(peerNodeHash, sample) {
 	return anomaly
 }
 
-/**
- * @param {string} peerNodeHash 对端
- * @returns {boolean} 是否处于本地隔离
- */
-export function isPeerQuarantined(peerNodeHash) {
-	return isQuarantinedPure(loadReputation(), peerNodeHash)
-}
-
 /**
  * @param {string} storagePeerKey 责任方
  * @returns {void}

package/node/retention_policy.mjs

@@ -3,21 +3,6 @@ import {
 	authzFoldOrderIds,
 	descendantClosureFromTip,
 } from '../governance/branch.mjs'
-import { getPermissionAnchorTypes } from '../registries/event_type.mjs'
-
-/**
- * @param {string[]} order 拓扑序 id 列表
- * @param {Map<string, object>} byId id → 事件
- * @returns {number} 最早须保留的事件下标
- */
-export function permissionAnchorStartIndex(order, byId) {
-	let anchor = order.length
-	for (let index = order.length - 1; index >= 0; index--) {
-		const ev = byId.get(order[index])
-		if (ev && getPermissionAnchorTypes().has(ev.type)) anchor = index
-	}
-	return anchor
-}
 
 /**
  * 在共识分支上计算须保留的事件 id（连通子图，不用拓扑下标切片）。

package/package.json

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

package/registries/event_type.mjs

@@ -56,18 +56,6 @@ export function getGovernanceAuthzTypes() {
 	return typesWithFlag('governance')
 }
 
-/** 联邦入站/中继前须物化 ACL 门控的类型。 */
-/** @returns {Set<string>} ACL 门控事件 type 集合 */
-export function getFederationAclGatedEventTypes() {
-	return typesWithFlag('aclGated')
-}
-
-/** §6.2 频道 GC 沉寂计时排除的类型。 */
-/** @returns {Set<string>} GC 排除事件 type 集合 */
-export function getChannelGcExcludedEventTypes() {
-	return typesWithFlag('gcExclude')
-}
-
 /** 裁剪时不得早于最早一条权限锚点事件（§7.1）。 */
 /** @returns {Set<string>} 权限锚点事件 type 集合 */
 export function getPermissionAnchorTypes() {

package/registries/inbound.mjs

@@ -41,22 +41,6 @@ export function registerDeliveryInboundHandler(type, handler) {
 	deliveryHandlers.set(String(type || '').trim(), handler)
 }
 
-/**
- * @param {string} type 入站类型
- * @returns {void}
- */
-export function unregisterRpcInboundHandler(type) {
-	rpcHandlers.delete(String(type || '').trim())
-}
-
-/**
- * @param {string} type 入站类型
- * @returns {void}
- */
-export function unregisterDeliveryInboundHandler(type) {
-	deliveryHandlers.delete(String(type || '').trim())
-}
-
 /**
  * @param {InboundContext} ctx 入站上下文
  * @param {object} message 已校验的线载荷（含 type）
@@ -82,9 +66,3 @@ export async function dispatchDeliveryInbound(ctx, message) {
 	if (!handler) return
 	await handler(ctx, message)
 }
-
-/** @returns {void} 测试用 */
-export function clearInboundHandlers() {
-	rpcHandlers.clear()
-	deliveryHandlers.clear()
-}

package/reputation/engine.mjs

@@ -445,14 +445,3 @@ export function isQuarantinedPure(data, peerNodeHash, now = Date.now()) {
 	const until = Number(data.byNodeHash?.[id]?.quarantinedUntil ?? 0)
 	return Number.isFinite(until) && until > now
 }
-
-/**
- * @param {ReputationFile} data 信誉表
- * @param {string} peerNodeHash 对端
- * @param {number} [now] 当前时间
- * @param {typeof reputationTunables} [tunables] tunables
- * @returns {boolean} 是否检测到异常并触发隔离
- */
-export function detectAnomalyPure(data, peerNodeHash, now = Date.now(), tunables = reputationTunables) {
-	return isQuarantinedPure(data, peerNodeHash, now)
-}

package/schemas/part_query.mjs

@@ -0,0 +1,156 @@
+import { Buffer } from 'node:buffer'
+
+import { canonicalStringify } from '../core/canonical_json.mjs'
+import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { isPlainObject } from '../wire/ingress.mjs'
+import { normalizePartpath } from '../wire/part_invoke.mjs'
+import partQueryTunables from '../wire/part_query.tunables.json' with { type: 'json' }
+
+/**
+ * @typedef {{
+ *   requestId: string
+ *   originNodeHash: string
+ *   partpath: string
+ *   kind: string
+ *   query: unknown
+ *   ttl: number
+ *   budget: { maxHits: number }
+ * }} PartQueryReq
+ */
+
+/**
+ * @typedef {{
+ *   requestId: string
+ *   fromNodeHash: string
+ *   rows: unknown[]
+ * }} PartQueryRes
+ */
+
+/**
+ * @param {unknown} value 任意 JSON
+ * @returns {number} UTF-8 序列化字节数；不可序列化时 Infinity
+ */
+export function measureJsonBytes(value) {
+	try {
+		return Buffer.byteLength(JSON.stringify(value), 'utf8')
+	}
+	catch {
+		return Number.POSITIVE_INFINITY
+	}
+}
+
+/**
+ * @param {unknown} budget 请求预算
+ * @param {number} [maxHits=partQueryTunables.maxHits] 上限
+ * @returns {{ maxHits: number }} 钳制后的预算
+ */
+export function clampPartQueryBudget(budget, maxHits = partQueryTunables.maxHits) {
+	const cap = Math.max(1, Math.floor(Number(maxHits) || partQueryTunables.maxHits))
+	const raw = isPlainObject(budget) ? Number(budget.maxHits) : NaN
+	const hits = Number.isFinite(raw) ? Math.floor(raw) : cap
+	return { maxHits: Math.max(1, Math.min(cap, hits)) }
+}
+
+/**
+ * @param {unknown} ttl 跳数预算
+ * @param {number} [maxTtl=partQueryTunables.maxTtl] 上限
+ * @returns {number | null} 钳制后的 ttl；非法为 null
+ */
+export function clampPartQueryTtl(ttl, maxTtl = partQueryTunables.maxTtl) {
+	const cap = Math.max(1, Math.floor(Number(maxTtl) || partQueryTunables.maxTtl))
+	const n = Math.floor(Number(ttl))
+	if (!Number.isFinite(n) || n < 1) return null
+	return Math.min(cap, n)
+}
+
+/**
+ * @param {unknown} rows 行数组
+ * @param {number} maxHits 条数上限
+ * @param {number} [maxRowsBytes=partQueryTunables.maxRowsBytes] 总尺寸上限
+ * @returns {unknown[] | null} 通过校验的 rows；失败 null
+ */
+export function clampPartQueryRows(rows, maxHits, maxRowsBytes = partQueryTunables.maxRowsBytes) {
+	if (!Array.isArray(rows)) return null
+	const limited = rows.slice(0, Math.max(0, Math.floor(Number(maxHits) || 0)))
+	if (measureJsonBytes(limited) > maxRowsBytes) return null
+	return limited
+}
+
+/** requestId 上限（randomUUID 36 字符；防超长键灌爆 dedupe/pending 表） */
+const REQUEST_ID_MAX_LENGTH = 128
+
+/**
+ * @param {unknown} value 原始 requestId
+ * @returns {string | null} 修剪后的 requestId；非法 null
+ */
+function normalizeRequestId(value) {
+	const requestId = String(value || '').trim()
+	if (!requestId || requestId.length > REQUEST_ID_MAX_LENGTH) return null
+	return requestId
+}
+
+/**
+ * @param {unknown} value 入站 req
+ * @param {typeof partQueryTunables} [tunables] 可调参数
+ * @returns {PartQueryReq | null} 校验通过的 req
+ */
+export function parsePartQueryReq(value, tunables = partQueryTunables) {
+	if (!isPlainObject(value)) return null
+	const requestId = normalizeRequestId(value.requestId)
+	if (!requestId) return null
+	const originNodeHash = normalizeHex64(value.originNodeHash)
+	if (!isHex64(originNodeHash)) return null
+	const partpath = normalizePartpath(value.partpath)
+	if (!partpath) return null
+	const kind = String(value.kind || '').trim()
+	if (!kind) return null
+	if (!Object.prototype.hasOwnProperty.call(value, 'query')) return null
+	if (measureJsonBytes(value.query) > (tunables.maxQueryBytes ?? 2048)) return null
+	const ttl = clampPartQueryTtl(value.ttl, tunables.maxTtl)
+	if (ttl == null) return null
+	const budget = clampPartQueryBudget(value.budget, tunables.maxHits)
+	return {
+		requestId,
+		originNodeHash,
+		partpath,
+		kind,
+		query: value.query,
+		ttl,
+		budget,
+	}
+}
+
+/**
+ * @param {unknown} value 入站 res
+ * @param {typeof partQueryTunables} [tunables] 可调参数
+ * @returns {PartQueryRes | null} 校验通过的 res
+ */
+export function parsePartQueryRes(value, tunables = partQueryTunables) {
+	if (!isPlainObject(value)) return null
+	const requestId = normalizeRequestId(value.requestId)
+	if (!requestId) return null
+	const fromNodeHash = normalizeHex64(value.fromNodeHash)
+	if (!isHex64(fromNodeHash)) return null
+	const rows = clampPartQueryRows(value.rows, tunables.maxHits, tunables.maxRowsBytes)
+	if (!rows) return null
+	return { requestId, fromNodeHash, rows }
+}
+
+/**
+ * @param {unknown} partpath part 路径
+ * @param {unknown} kind 查询标签
+ * @param {unknown} query 不透明查询
+ * @returns {string | null} 规范化三元组的缓存材料；非法 null
+ */
+export function normalizePartQueryCacheMaterial(partpath, kind, query) {
+	const path = normalizePartpath(partpath)
+	const k = String(kind || '').trim()
+	if (!path || !k) return null
+	if (measureJsonBytes(query) > partQueryTunables.maxQueryBytes) return null
+	try {
+		return canonicalStringify({ partpath: path, kind: k, query })
+	}
+	catch {
+		return null
+	}
+}

package/transport/ice_servers.mjs

@@ -47,14 +47,6 @@ export function resolveIceServers(groupSettings) {
 	return out.length ? out : [...DEFAULT_ICE_SERVERS]
 }
 
-/**
- * @param {unknown} groupSettings 物化群设置
- * @returns {{ iceServers: ReturnType<typeof resolveIceServers> }} Trystero rtcConfig 片段
- */
-export function resolveIceServersForTrystero(groupSettings) {
-	return { iceServers: resolveIceServers(groupSettings) }
-}
-
 /**
  * 校验并规范化待写入 DAG 的 iceServers 数组。
  * @param {unknown} raw 请求体字段

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/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'
@@ -105,6 +106,7 @@ async function ensureNodeScopeRuntime(ctx) {
 	const wire = createNodeScopeWire()
 	nodeScopeWire = wire
 	attachPartWire({ replicaUsername: ctx.replicaUsername }, wire)
+	attachPartQueryWire({ replicaUsername: ctx.replicaUsername }, wire)
 	attachMailboxWire({ replicaUsername: ctx.replicaUsername }, wire)
 	attachUserRoomChunkHandlers(ctx.replicaUsername || '', wire)
 	for (const hook of nodeScopeWireHooks)
@@ -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

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/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)
-}