@steve02081504/fount-p2p 0.0.3 → 0.0.5

package/wire/part_query_cache.mjs

@@ -0,0 +1,94 @@
+import { sha256Hex } from '../crypto/crypto.mjs'
+import { normalizePartQueryCacheMaterial } from '../schemas/part_query.mjs'
+import { createLruMap } from '../utils/lru.mjs'
+
+import partQueryTunables from './part_query.tunables.json' with { type: 'json' }
+
+/**
+ * @typedef {{ rows: unknown[], storedAt: number }} PartQueryCacheEntry
+ */
+
+/**
+ * @param {string} partpath part 路径
+ * @param {string} kind 查询标签
+ * @param {unknown} query 不透明查询
+ * @returns {string | null} sha256 hex 缓存键
+ */
+export function partQueryCacheKey(partpath, kind, query) {
+	const material = normalizePartQueryCacheMaterial(partpath, kind, query)
+	if (!material) return null
+	return sha256Hex(material)
+}
+
+/**
+ * LRU + TTL 中继缓存（未验证线索；发起端仍需验签复核）。
+ */
+export function createPartQueryCache(options = {}) {
+	const maxKeys = Math.max(1, Math.floor(Number(options.maxKeys) || partQueryTunables.cacheMaxKeys))
+	const ttlMs = Math.max(1, Math.floor(Number(options.ttlMs) || partQueryTunables.cacheTtlMs))
+	const maxHits = Math.max(1, Math.floor(Number(options.maxHits) || partQueryTunables.maxHits))
+	/** @type {ReturnType<typeof createLruMap<string, PartQueryCacheEntry>>} */
+	const map = createLruMap(maxKeys)
+
+	/**
+	 * @param {number} [now=Date.now()] 当前时间
+	 * @returns {void}
+	 */
+	const sweep = (now = Date.now()) => {
+		for (const [key, entry] of map)
+			if (now - entry.storedAt >= ttlMs) map.delete(key)
+	}
+
+	return {
+		/**
+		 * @param {string} partpath part 路径
+		 * @param {string} kind 查询标签
+		 * @param {unknown} query 查询体
+		 * @param {number} [now=Date.now()] 当前时间
+		 * @returns {unknown[] | null} 未过期 rows
+		 */
+		get(partpath, kind, query, now = Date.now()) {
+			const key = partQueryCacheKey(partpath, kind, query)
+			if (!key) return null
+			const entry = map.get(key)
+			if (!entry) return null
+			if (now - entry.storedAt >= ttlMs) {
+				map.delete(key)
+				return null
+			}
+			map.touch(key, entry)
+			return entry.rows.slice()
+		},
+
+		/**
+		 * @param {string} partpath part 路径
+		 * @param {string} kind 查询标签
+		 * @param {unknown} query 查询体
+		 * @param {unknown[]} rows 聚合 rows
+		 * @param {number} [now=Date.now()] 当前时间
+		 * @returns {void}
+		 */
+		set(partpath, kind, query, rows, now = Date.now()) {
+			const key = partQueryCacheKey(partpath, kind, query)
+			if (!key || !Array.isArray(rows)) return
+			sweep(now)
+			map.touch(key, {
+				rows: rows.slice(0, maxHits),
+				storedAt: now,
+			})
+		},
+
+		/** @returns {void} */
+		clear() {
+			map.clear()
+		},
+
+		/** @returns {number} 当前条目数 */
+		get size() {
+			return map.size
+		},
+	}
+}
+
+/** 进程内默认中继缓存 */
+export const partQueryCache = createPartQueryCache()

package/entity/files/replica_host_cache.mjs

@@ -1,46 +0,0 @@
-import { getEntityStore } from '../../node/instance.mjs'
-
-/** @type {Map<string, { replica: string | null, at: number }>} */
-const replicaHostCache = new Map()
-
-const REPLICA_HOST_CACHE_MS = 60_000
-
-/**
- * @param {string | string[]} [entityHash] owner（单个或批量）
- * @returns {void}
- */
-export function invalidateReplicaHostCache(entityHash) {
-	if (Array.isArray(entityHash)) {
-		for (const eh of entityHash)
-			replicaHostCache.delete(String(eh).trim().toLowerCase())
-		return
-	}
-	if (entityHash) {
-		replicaHostCache.delete(String(entityHash).trim().toLowerCase())
-		return
-	}
-	replicaHostCache.clear()
-}
-
-/**
- * @param {string} ownerEntityHash 所有者
- * @returns {Promise<string | null>} 托管 manifest 的 replica
- */
-export async function findReplicaHostingEntityFiles(ownerEntityHash) {
-	const eh = String(ownerEntityHash).trim().toLowerCase()
-	const cached = replicaHostCache.get(eh)
-	if (cached && Date.now() - cached.at < REPLICA_HOST_CACHE_MS)
-		return cached.replica
-
-	const store = getEntityStore()
-	if (typeof store.findHostingUser === 'function') {
-		const replica = await store.findHostingUser(eh)
-		replicaHostCache.set(eh, { replica, at: Date.now() })
-		return replica
-	}
-
-	const files = await store.listEntityFiles(eh)
-	const replica = files.length ? '__node__' : null
-	replicaHostCache.set(eh, { replica, at: Date.now() })
-	return replica
-}

package/entity/hosting_registry.mjs

@@ -1,47 +0,0 @@
-/** @type {((username: string, entityHash: string) => string | null) | null} */
-let resolveAgentCharPartName = null
-
-/** @type {((username: string) => { entityHash: string, charPartName: string }[]) | null} */
-let listLocalAgents = null
-
-/**
- * Chat Load 时注册：解析本地 agent 的 chars 目录名。
- * @param {(username: string, entityHash: string) => string | null} resolver 解析函数
- * @returns {void}
- */
-export function registerAgentCharResolver(resolver) {
-	resolveAgentCharPartName = resolver
-}
-
-/**
- * Chat Load 时注册：枚举 replica 下本地 agent 实体。
- * @param {(username: string) => { entityHash: string, charPartName: string }[]} provider 枚举函数
- * @returns {void}
- */
-export function registerListLocalAgentsProvider(provider) {
-	listLocalAgents = provider
-}
-
-/** @returns {void} */
-export function unregisterAgentCharResolver() {
-	resolveAgentCharPartName = null
-}
-
-/** @returns {void} */
-export function unregisterListLocalAgentsProvider() {
-	listLocalAgents = null
-}
-
-/**
- * @returns {((username: string, entityHash: string) => string | null) | null} 已注册解析器
- */
-export function getAgentCharResolver() {
-	return resolveAgentCharPartName
-}
-
-/**
- * @returns {((username: string) => { entityHash: string, charPartName: string }[]) | null} 已注册枚举器
- */
-export function getListLocalAgentsProvider() {
-	return listLocalAgents
-}

package/entity/logical_entity_id_registry.mjs

@@ -1,40 +0,0 @@
-/** @type {Map<string, (username: string, entityHash: string) => Promise<string | null>>} */
-const resolversByOwner = new Map()
-
-/**
- * @param {string} ownerId 注册方
- * @param {(username: string, entityHash: string) => Promise<string | null>} resolver logical entity id 反查
- * @returns {void}
- */
-export function registerLogicalEntityIdResolver(ownerId, resolver) {
-	resolversByOwner.set(String(ownerId), resolver)
-}
-
-/**
- * @param {string} ownerId 注册方
- * @returns {void}
- */
-export function unregisterLogicalEntityIdResolver(ownerId) {
-	resolversByOwner.delete(String(ownerId))
-}
-
-/** @returns {void} */
-export function clearLogicalEntityIdRegistry() {
-	resolversByOwner.clear()
-}
-
-/**
- * @param {string} username 副本用户名
- * @param {string} entityHash 128 位十六进制 logical entity
- * @returns {Promise<string | null>} 逻辑实体 id
- */
-export async function resolveLogicalEntityId(username, entityHash) {
-	for (const resolver of resolversByOwner.values())
-		try {
-			const id = await resolver(username, entityHash)
-			if (id) return id
-		}
-		catch { /* next */ }
-
-	return null
-}

package/entity/node_hash.mjs

@@ -1,15 +0,0 @@
-import { Buffer } from 'node:buffer'
-
-import { keyPairFromSeed, pubKeyHash } from '../crypto/crypto.mjs'
-
-/**
- * 由持久化 nodeSeed 派生 nodeHash（64 hex）。
- * @param {string} seedHex 32 字节 hex
- * @returns {string} 节点哈希
- */
-export function nodeHashFromSeed(seedHex) {
-	const seed = Buffer.from(String(seedHex).trim(), 'hex')
-	if (seed.length !== 32) throw new Error('invalid node seed')
-	const { publicKey } = keyPairFromSeed(seed)
-	return pubKeyHash(publicKey)
-}

package/entity/replica.mjs

@@ -1,20 +0,0 @@
-import { parseEntityHash } from '../core/entity_id.mjs'
-import { entityHashFromKeys, getNodeHash } from '../node/identity.mjs'
-
-/**
- * @param {string} recoveryPubKeyHex 64 位十六进制 recovery 公钥
- * @returns {string | null} 本节点 entityHash
- */
-export function resolveLocalEntityHashFromRecoveryPubKeyHex(recoveryPubKeyHex) {
-	return entityHashFromKeys(getNodeHash(), recoveryPubKeyHex)
-}
-
-/**
- * @param {string} entityHash 目标 entityHash
- * @returns {boolean} 是否为本节点可写实体
- */
-export function isWritableLocalEntity(entityHash) {
-	const parsed = parseEntityHash(entityHash)
-	if (!parsed) return false
-	return parsed.nodeHash === getNodeHash()
-}

package/entity/session_snapshot_registry.mjs

@@ -1,38 +0,0 @@
-/** @type {Map<string, (replicaUsername: string, groupId: string) => Promise<object | null>>} */
-const providersByOwner = new Map()
-
-/**
- * @param {string} ownerId 注册方
- * @param {(replicaUsername: string, groupId: string) => Promise<object | null>} provider 物化会话
- * @returns {void}
- */
-export function registerMaterializedSessionProvider(ownerId, provider) {
-	providersByOwner.set(String(ownerId), provider)
-}
-
-/**
- * @param {string} ownerId 注册方
- * @returns {void}
- */
-export function unregisterMaterializedSessionProvider(ownerId) {
-	providersByOwner.delete(String(ownerId))
-}
-
-/**
- * @param {string} replicaUsername 副本用户名
- * @param {string} groupId 群 ID
- * @param {string} [ownerId] 注册方 id；省略时遍历所有 provider
- * @returns {Promise<object | null>} 物化会话
- */
-export async function getMaterializedSession(replicaUsername, groupId, ownerId) {
-	if (ownerId != null) {
-		const provider = providersByOwner.get(String(ownerId))
-		if (!provider) return null
-		return provider(replicaUsername, groupId)
-	}
-	for (const provider of providersByOwner.values()) {
-		const session = await provider(replicaUsername, groupId)
-		if (session) return session
-	}
-	return null
-}

package/registries/p2p_viewer.mjs

@@ -1,35 +0,0 @@
-/** @type {Map<string, (replicaUsername: string, groupId: string) => Promise<string>>} */
-const groupMemberEntityByOwner = new Map()
-
-/**
- * @param {string} ownerId 注册方
- * @param {(replicaUsername: string, groupId: string) => Promise<string>} resolver 群成员 entityHash
- * @returns {void}
- */
-export function registerGroupMemberEntityResolver(ownerId, resolver) {
-	groupMemberEntityByOwner.set(String(ownerId), resolver)
-}
-
-/**
- * @param {string} ownerId 注册方
- * @returns {void}
- */
-export function unregisterGroupMemberEntityResolver(ownerId) {
-	groupMemberEntityByOwner.delete(String(ownerId))
-}
-
-/**
- * @param {string} replicaUsername 副本用户名
- * @param {string} groupId 群 ID
- * @returns {Promise<string | null>} entityHash；无注册方时 null
- */
-export async function resolveGroupMemberEntityHash(replicaUsername, groupId) {
-	for (const resolver of groupMemberEntityByOwner.values())
-		try {
-			const eh = await resolver(replicaUsername, groupId)
-			if (eh) return eh
-		}
-		catch { /* next */ }
-
-	return null
-}