@steve02081504/fount-p2p 0.0.3 → 0.0.4

package/README.md

@@ -34,7 +34,7 @@ Subpath exports mirror source directories, e.g. `@steve02081504/fount-p2p/dag`,
 | L1 | `crypto/`, `wire/`, `schemas/` | Cryptography, wire protocol, canonical validation |
 | L2 | `node/` | Node runtime: `identity`, `entity_store`, `denylist`, `reputation_store` |
 | L3 | `discovery/`, `link/`, `transport/`, `rooms/` | Discovery, RTC links, rooms |
-| L4 | `trust_graph/`, `mailbox/`, `dag/`, `federation/`, `files/`, `entity/` | Federation, store-and-forward, DAG, EVFS |
+| L4 | `trust_graph/`, `mailbox/`, `dag/`, `federation/`, `files/` | Federation, store-and-forward, DAG, EVFS |
 | — | `registries/` | Pluggable registries (event type, part path, room provider, …) |
 
 Facade entry: `index.mjs` (`startNode`, `createGroupLinkSet`, `registerDiscoveryProvider`, …).

package/{entity → core}/logical_entity.mjs

@@ -1,6 +1,7 @@
-import { encodeEntityHash, parseEntityHash } from '../core/entity_id.mjs'
 import { sha256TextHex } from '../crypto/crypto.mjs'
 
+import { encodeEntityHash, parseEntityHash } from './entity_id.mjs'
+
 /** @type {string} 逻辑实体 sentinel nodeHash（非物理节点绑定） */
 export const LOGICAL_ENTITY_SENTINEL_NODE_HASH = '0'.repeat(64)
 

package/{entity/files → files}/acl.mjs

@@ -1,12 +1,12 @@
-import { isLogicalEntityHash } from '../logical_entity.mjs'
-import { isWritableLocalEntity } from '../replica.mjs'
+import { isLogicalEntityHash } from '../core/logical_entity.mjs'
+import { isWritableLocalEntity } from '../node/identity.mjs'
 
 import { checkManifestAcl, resolveManifestAclType } from './manifest_acl_registry.mjs'
 
 /**
  * @param {string} replicaUsername 请求 replica
  * @param {string} ownerEntityHash 文件 owner
- * @param {import('../../files/manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./manifest.mjs').FileManifest} manifest 清单
  * @returns {Promise<boolean>} 是否允许读
  */
 export async function canReadManifest(replicaUsername, ownerEntityHash, manifest) {

package/{entity/files → files}/evfs.mjs

@@ -1,21 +1,21 @@
 import { Buffer } from 'node:buffer'
 import { Readable } from 'node:stream'
 
-import { FEDERATION_CHUNK_MAX_BYTES } from '../../core/constants.mjs'
-import { buildFileManifestFromEnc } from '../../files/assemble.mjs'
-import { encryptReadableToParts } from '../../files/assemble_stream.mjs'
-import { fetchChunk } from '../../files/chunk_fetch.mjs'
-import { getChunk, hasChunk, putChunk } from '../../files/chunk_store.mjs'
-import { normalizeFileManifest, publicTransferKeyDescriptor } from '../../files/manifest.mjs'
-import { assembleManifestPlaintext } from '../../files/transfer_key.mjs'
-import { readDagManifestPlaintext, resolveTransferKeyDeps } from '../../files/transfer_key_registry.mjs'
-import { getEntityStore } from '../../node/instance.mjs'
+import { FEDERATION_CHUNK_MAX_BYTES } from '../core/constants.mjs'
+import { getEntityStore } from '../node/instance.mjs'
 
+import { buildFileManifestFromEnc, encryptPlaintextToParts, encryptPlaintextToMultiPartsAsync } from './assemble.mjs'
+import { encryptReadableToParts } from './assemble_stream.mjs'
+import { fetchChunk } from './chunk_fetch.mjs'
+import { getChunk, hasChunk, putChunk } from './chunk_store.mjs'
+import { normalizeFileManifest, publicTransferKeyDescriptor } from './manifest.mjs'
+import { assembleManifestPlaintext } from './transfer_key.mjs'
+import { readDagManifestPlaintext, resolveTransferKeyDeps } from './transfer_key_registry.mjs'
 
 /**
  * @param {string} ownerEntityHash 所有者
  * @param {string} logicalPath 路径
- * @returns {Promise<import('../../files/manifest.mjs').FileManifest | null>} 归一化 manifest
+ * @returns {Promise<import('./manifest.mjs').FileManifest | null>} 归一化 manifest
  */
 export async function loadFileManifest(ownerEntityHash, logicalPath) {
 	const manifest = await getEntityStore().readManifest(ownerEntityHash, logicalPath)
@@ -23,7 +23,7 @@ export async function loadFileManifest(ownerEntityHash, logicalPath) {
 }
 
 /**
- * @param {import('../../files/manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./manifest.mjs').FileManifest} manifest 清单
  * @returns {Promise<void>}
  */
 export async function saveFileManifest(manifest) {
@@ -31,7 +31,7 @@ export async function saveFileManifest(manifest) {
 }
 
 /**
- * @param {import('../../files/manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./manifest.mjs').FileManifest} manifest 清单
  * @param {Array<Buffer | Uint8Array>} partBytes 密文块
  * @returns {Promise<void>}
  */
@@ -42,7 +42,7 @@ export async function storeManifestParts(manifest, partBytes) {
 
 /**
  * @param {string} replicaUsername 副本用户名
- * @param {import('../../files/manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./manifest.mjs').FileManifest} manifest 清单
  * @param {{ username?: string, fetchChunk?: Function }} [opts] miss 拉取
  * @returns {Promise<Buffer | null>} 明文内容
  */
@@ -90,7 +90,7 @@ export async function readManifestPlaintext(replicaUsername, manifest, opts = {}
 
 /**
  * @param {string} replicaUsername 副本用户名
- * @param {import('../../files/manifest.mjs').FileManifest} manifest 清单
+ * @param {import('./manifest.mjs').FileManifest} manifest 清单
  * @param {{ username?: string, fetchChunk?: Function }} [opts] miss 拉取
  * @returns {Promise<import('node:stream').Readable | null>} 明文流
  */
@@ -107,13 +107,12 @@ export async function readManifestPlaintextStream(replicaUsername, manifest, opt
  * @param {Buffer | Uint8Array} params.plaintext 明文
  * @param {string} [params.name] 文件名
  * @param {string} [params.mimeType] MIME
- * @param {import('../../files/manifest.mjs').CeMode} [params.ceMode] 模式
- * @param {import('../../files/manifest.mjs').TransferKeyDescriptor} [params.transferKeyDescriptor] 传递密钥
+ * @param {import('./manifest.mjs').CeMode} [params.ceMode] 模式
+ * @param {import('./manifest.mjs').TransferKeyDescriptor} [params.transferKeyDescriptor] 传递密钥
  * @param {object} [params.meta] meta
- * @returns {Promise<import('../../files/manifest.mjs').FileManifest>} 写入后的 manifest
+ * @returns {Promise<import('./manifest.mjs').FileManifest>} 写入后的 manifest
  */
 export async function putFileManifest(params) {
-	const { encryptPlaintextToParts, encryptPlaintextToMultiPartsAsync } = await import('../../files/assemble.mjs')
 	const {
 		ownerEntityHash,
 		logicalPath,
@@ -152,10 +151,10 @@ export async function putFileManifest(params) {
  * @param {number} params.plainSize 明文字节数
  * @param {string} [params.name] 文件名
  * @param {string} [params.mimeType] MIME
- * @param {import('../../files/manifest.mjs').CeMode} [params.ceMode] 模式
- * @param {import('../../files/manifest.mjs').TransferKeyDescriptor} [params.transferKeyDescriptor] 传递密钥
+ * @param {import('./manifest.mjs').CeMode} [params.ceMode] 模式
+ * @param {import('./manifest.mjs').TransferKeyDescriptor} [params.transferKeyDescriptor] 传递密钥
  * @param {object} [params.meta] meta
- * @returns {Promise<import('../../files/manifest.mjs').FileManifest>} 写入后的 manifest
+ * @returns {Promise<import('./manifest.mjs').FileManifest>} 写入后的 manifest
  */
 export async function putFileManifestFromStream(params) {
 	const {
@@ -197,7 +196,7 @@ export async function putFileManifestFromStream(params) {
  * @returns {Promise<Buffer | null>} 明文或 null
  */
 export async function readPublicFile(replicaUsername, entityHash, logicalPath, opts = {}) {
-	const { fetchPublicManifest } = await import('../../files/manifest_fetch.mjs')
+	const { fetchPublicManifest } = await import('./manifest_fetch.mjs')
 	const manifest = await fetchPublicManifest({
 		username: opts.username || replicaUsername,
 		ownerEntityHash: entityHash,

package/{entity/files → files}/evfs_ref.mjs

@@ -1,9 +1,7 @@
-import { isEntityHash128 } from '../../core/entity_id.mjs'
-import { assertSafeEvfsLogicalPath } from '../../core/evfs_logical_path.mjs'
+import { isEntityHash128 } from '../core/entity_id.mjs'
+import { assertSafeEvfsLogicalPath } from '../core/evfs_logical_path.mjs'
 
-/**
- *
- */
+/** @type {string} evfs URI scheme */
 export const EVFS_SCHEME = 'evfs:'
 
 /**

package/{entity/files → files}/manifest_acl_registry.mjs

@@ -5,14 +5,14 @@
 /** @type {Map<string, { ownerId: string, handler: (context: ManifestAclContext, logicalPath?: string) => Promise<boolean> }>} */
 const handlersByType = new Map()
 
-/** @type {Map<string, { ownerId: string, match: (manifest: import('../../files/manifest.mjs').FileManifest | null | undefined, ownerEntityHash: string) => string | null }>} */
+/** @type {Map<string, { ownerId: string, match: (manifest: import('./manifest.mjs').FileManifest | null | undefined, ownerEntityHash: string) => string | null }>} */
 const matchersByOwner = new Map()
 
 /**
  * @typedef {{
  *   replicaUsername: string,
  *   ownerEntityHash: string,
- *   manifest: import('../../files/manifest.mjs').FileManifest,
+ *   manifest: import('./manifest.mjs').FileManifest,
  * }} ManifestAclContext
  */
 
@@ -46,7 +46,7 @@ export function unregisterManifestAcl(type, ownerId) {
 
 /**
  * @param {string} ownerId 注册方
- * @param {(manifest: import('../../files/manifest.mjs').FileManifest | null | undefined, ownerEntityHash: string) => string | null} match ACL 类型匹配
+ * @param {(manifest: import('./manifest.mjs').FileManifest | null | undefined, ownerEntityHash: string) => string | null} match ACL 类型匹配
  * @returns {void}
  */
 export function registerManifestAclMatcher(ownerId, match) {
@@ -68,7 +68,7 @@ export function clearManifestAclRegistry() {
 }
 
 /**
- * @param {import('../../files/manifest.mjs').FileManifest | null | undefined} manifest manifest
+ * @param {import('./manifest.mjs').FileManifest | null | undefined} manifest manifest
  * @param {string} ownerEntityHash 所有者
  * @returns {string | null} ACL 类型
  */

package/files/manifest_fetch.mjs

@@ -1,16 +1,16 @@
 import { randomUUID } from 'node:crypto'
 
-import { loadFileManifest, saveFileManifest } from '../entity/files/evfs.mjs'
-import { isWritableLocalEntity } from '../entity/replica.mjs'
 import {
 	manifestFetchExpectedKey,
 	MAX_PENDING_MANIFEST_FETCHES,
 	pendingManifestFetches,
 	registerManifestFetchWait,
 } from '../federation/manifest_fetch_pending.mjs'
+import { isWritableLocalEntity } from '../node/identity.mjs'
 import { getEntityStore } from '../node/instance.mjs'
 
 import { resolveNodeHash } from './chunk_provider_registry.mjs'
+import { loadFileManifest, saveFileManifest } from './evfs.mjs'
 import { fanoutFedFetch } from './fetch_fanout.mjs'
 import { normalizeFileManifest } from './manifest.mjs'
 import { shouldPreferIncomingPublicManifest } from './public_manifest.mjs'

package/files/public_manifest.mjs

@@ -6,6 +6,7 @@ import { assertSafeEvfsLogicalPath } from '../core/evfs_logical_path.mjs'
 import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
 import { sign, verify } from '../crypto/crypto.mjs'
 
+import { putFileManifest, saveFileManifest } from './evfs.mjs'
 import { normalizeFileManifest, publicTransferKeyDescriptor } from './manifest.mjs'
 
 /** 实体公开 manifest 签名域 */
@@ -137,7 +138,6 @@ export async function publishPublicFile(params) {
 		entityPubKeyHex,
 		publishedAt = Date.now(),
 	} = params
-	const { putFileManifest, saveFileManifest } = await import('../entity/files/evfs.mjs')
 	const base = await putFileManifest({
 		ownerEntityHash,
 		logicalPath,

package/node/identity.mjs

@@ -1,8 +1,9 @@
+import { Buffer } from 'node:buffer'
 import { randomBytes } from 'node:crypto'
 
-import { entityHashFromRecoveryPubKeyHex } from '../core/entity_id.mjs'
+import { entityHashFromRecoveryPubKeyHex, parseEntityHash } from '../core/entity_id.mjs'
 import { isHex64 } from '../core/hexIds.mjs'
-import { nodeHashFromSeed } from '../entity/node_hash.mjs'
+import { keyPairFromSeed, pubKeyHash } from '../crypto/crypto.mjs'
 import { normalizeMailboxSettings } from '../mailbox/settings.mjs'
 
 import { emitNodeChange } from './instance.mjs'
@@ -11,6 +12,18 @@ import { readNodeJsonSync, writeNodeJsonSync } from './storage.mjs'
 const NODE_SEED_HEX_RE = /^[\da-f]{64}$/iu
 const NODE_JSON = 'node'
 
+/**
+ * 由持久化 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)
+}
+
 /**
  * @returns {object} 节点配置磁盘对象
  */
@@ -97,3 +110,21 @@ export function entityHashFromKeys(nodeHash, recoveryPubKeyHex) {
 	if (!isHex64(nodeHash) || !isHex64(pub)) return null
 	return entityHashFromRecoveryPubKeyHex(nodeHash, pub)
 }
+
+/**
+ * @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/node/personal_block.mjs

@@ -5,8 +5,8 @@
  */
 import { parseEntityHash } from '../core/entity_id.mjs'
 import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
-import { isWritableLocalEntity } from '../entity/replica.mjs'
 
+import { isWritableLocalEntity } from './identity.mjs'
 import { isNodeInitialized, getEntityStore } from './instance.mjs'
 
 /** @typedef {'subject' | 'entity'} PersonalListScope */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@steve02081504/fount-p2p",
-	"version": "0.0.3",
+	"version": "0.0.4",
 	"description": "fount federation P2P layer — link, trust graph, mailbox, DAG, EVFS.",
 	"keywords": [
 		"network",
@@ -45,8 +45,6 @@
 		"./rooms/*": "./rooms/*.mjs",
 		"./overlay": "./overlay/index.mjs",
 		"./overlay/*": "./overlay/*.mjs",
-		"./entity/*": "./entity/*.mjs",
-		"./entity/files/*": "./entity/files/*.mjs",
 		"./trust_graph/*": "./trust_graph/*.mjs",
 		"./mailbox/*": "./mailbox/*.mjs",
 		"./dag": "./dag/index.mjs",

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