@steve02081504/fount-p2p 0.0.1 → 0.0.3

package/files/public_manifest.mjs

@@ -0,0 +1,153 @@
+import { Buffer } from 'node:buffer'
+
+import { canonicalStringify } from '../core/canonical_json.mjs'
+import { hashFromPubKeyHex, parseEntityHash } from '../core/entity_id.mjs'
+import { assertSafeEvfsLogicalPath } from '../core/evfs_logical_path.mjs'
+import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
+import { sign, verify } from '../crypto/crypto.mjs'
+
+import { normalizeFileManifest, publicTransferKeyDescriptor } from './manifest.mjs'
+
+/** 实体公开 manifest 签名域 */
+export const ENTITY_PUBLIC_MANIFEST_DOMAIN = 'fount-entity-public-manifest'
+
+/**
+ * @param {object} fields 待签名字段
+ * @returns {Buffer} 签名消息字节
+ */
+export function publicManifestSignBytes(fields) {
+	return Buffer.from(canonicalStringify([
+		ENTITY_PUBLIC_MANIFEST_DOMAIN,
+		String(fields.ownerEntityHash || '').trim().toLowerCase(),
+		assertSafeEvfsLogicalPath(fields.logicalPath),
+		Number(fields.publishedAt) || 0,
+		String(fields.contentHash || '').trim().toLowerCase(),
+		Number(fields.size) || 0,
+		String(fields.mimeType || ''),
+		String(fields.name || ''),
+		String(fields.ceMode || ''),
+		fields.parts || [],
+	]), 'utf8')
+}
+
+/**
+ * @param {import('./manifest.mjs').FileManifest} manifest 清单
+ * @param {number} publishedAt 发布时间
+ * @param {Uint8Array | Buffer} entitySecretKey recovery 私钥种子
+ * @param {string} entityPubKeyHex recovery 公钥 hex
+ * @returns {Promise<import('./manifest.mjs').FileManifest>} 带 publicSig 的清单
+ */
+export async function attachPublicManifestSig(manifest, publishedAt, entitySecretKey, entityPubKeyHex) {
+	const pubKeyHex = normalizeHex64(entityPubKeyHex)
+	const message = publicManifestSignBytes({
+		ownerEntityHash: manifest.ownerEntityHash,
+		logicalPath: manifest.logicalPath,
+		publishedAt,
+		contentHash: manifest.contentHash,
+		size: manifest.size,
+		mimeType: manifest.mimeType,
+		name: manifest.name,
+		ceMode: manifest.ceMode,
+		parts: manifest.parts,
+	})
+	const sigHex = Buffer.from(await sign(message, entitySecretKey)).toString('hex')
+	return {
+		...manifest,
+		meta: {
+			...manifest.meta || {},
+			publicSig: { publishedAt, pubKeyHex, sigHex },
+		},
+	}
+}
+
+/**
+ * @param {unknown} input 原始 manifest
+ * @returns {Promise<import('./manifest.mjs').FileManifest | null>} 验签通过的清单；非法为 null
+ */
+export async function verifySignedPublicManifest(input) {
+	const manifest = normalizeFileManifest(input)
+	if (!manifest) return null
+	if (manifest.transferKeyDescriptor.type !== 'public') return null
+
+	const publicSig = input?.meta?.publicSig
+	if (!publicSig || typeof publicSig !== 'object') return null
+	const publishedAt = Number(publicSig.publishedAt) || 0
+	const pubKeyHex = normalizeHex64(publicSig.pubKeyHex)
+	const sigHex = String(publicSig.sigHex || '').trim().toLowerCase()
+	if (!isHex64(pubKeyHex) || !/^[\da-f]{128}$/u.test(sigHex) || publishedAt <= 0) return null
+
+	const parsed = parseEntityHash(manifest.ownerEntityHash)
+	if (!parsed) return null
+	if (hashFromPubKeyHex(pubKeyHex) !== parsed.subjectHash) return null
+
+	const message = publicManifestSignBytes({
+		ownerEntityHash: manifest.ownerEntityHash,
+		logicalPath: manifest.logicalPath,
+		publishedAt,
+		contentHash: manifest.contentHash,
+		size: manifest.size,
+		mimeType: manifest.mimeType,
+		name: manifest.name,
+		ceMode: manifest.ceMode,
+		parts: manifest.parts,
+	})
+	const ok = await verify(Buffer.from(sigHex, 'hex'), message, Buffer.from(pubKeyHex, 'hex'))
+	if (!ok) return null
+
+	// 签名只覆盖内容字段：入站 meta 一律丢弃，仅保留 publicSig，
+	// 防止中继注入 dagParts/groupId 等本地扩展改写读取路径。
+	return {
+		...manifest,
+		meta: { publicSig: { publishedAt, pubKeyHex, sigHex } },
+	}
+}
+
+/**
+ * @param {object | null | undefined} localManifest 本地已有清单
+ * @param {import('./manifest.mjs').FileManifest} incoming 入站已验签清单
+ * @returns {boolean} 是否应以 incoming 覆盖本地缓存
+ */
+export function shouldPreferIncomingPublicManifest(localManifest, incoming) {
+	const incomingAt = Number(incoming?.meta?.publicSig?.publishedAt) || 0
+	if (incomingAt <= 0) return false
+	const localAt = Number(localManifest?.meta?.publicSig?.publishedAt) || 0
+	return incomingAt > localAt
+}
+
+/**
+ * @param {object} params 参数
+ * @param {string} params.ownerEntityHash owner
+ * @param {string} params.logicalPath 路径
+ * @param {Buffer | Uint8Array} params.plaintext 明文
+ * @param {string} [params.name] 文件名
+ * @param {string} [params.mimeType] MIME
+ * @param {Uint8Array | Buffer} params.entitySecretKey recovery 私钥种子
+ * @param {string} params.entityPubKeyHex recovery 公钥 hex
+ * @param {number} [params.publishedAt] 发布时间（默认 Date.now）
+ * @returns {Promise<import('./manifest.mjs').FileManifest>} 已签名并落盘的公开清单
+ */
+export async function publishPublicFile(params) {
+	const {
+		ownerEntityHash,
+		logicalPath,
+		plaintext,
+		name,
+		mimeType,
+		entitySecretKey,
+		entityPubKeyHex,
+		publishedAt = Date.now(),
+	} = params
+	const { putFileManifest, saveFileManifest } = await import('../entity/files/evfs.mjs')
+	const base = await putFileManifest({
+		ownerEntityHash,
+		logicalPath,
+		plaintext,
+		name,
+		mimeType,
+		ceMode: 'convergent',
+		transferKeyDescriptor: publicTransferKeyDescriptor(),
+	})
+	const signed = await attachPublicManifestSig(base, publishedAt, entitySecretKey, entityPubKeyHex)
+	await saveFileManifest(signed)
+	return signed
+}

package/files/transfer_key.mjs

@@ -24,8 +24,7 @@ export async function resolveContentKey(descriptor, manifest, deps = {}) {
 		return null
 
 	if (type === 'file-master-key-wrap') {
-		const groupId = descriptor.groupId
-		const fileId = descriptor.fileId
+		const { groupId, fileId } = descriptor
 		if (!groupId || !fileId || !descriptor.wrappedKey || !deps.getGroupFileMasterKey) return null
 		const groupKey = await deps.getGroupFileMasterKey(String(groupId), descriptor.keyGeneration)
 		if (!groupKey) return null
@@ -33,8 +32,7 @@ export async function resolveContentKey(descriptor, manifest, deps = {}) {
 	}
 
 	if (type === 'vault-wrap') {
-		const entityHash = descriptor.entityHash
-		const fileId = descriptor.fileId
+		const { entityHash, fileId } = descriptor
 		if (!entityHash || !fileId || !descriptor.wrappedKey || !deps.getVaultMasterKey) return null
 		const vaultKey = await deps.getVaultMasterKey(String(entityHash))
 		if (!vaultKey) return null

package/governance/join_pow.mjs

@@ -101,7 +101,7 @@ export function verifyJoinPow(powSolution, opts) {
 	if (!powSolution || typeof powSolution !== 'object') return { ok: false, achievedBits: 0 }
 
 	const anchorRef = String(powSolution.anchorRef ?? '').trim()
-	const nonce = powSolution.nonce
+	const { nonce } = powSolution
 	const epoch = Number(powSolution.epoch)
 	const joinerNodeHash = String(powSolution.joinerNodeHash ?? opts.senderNodeHash ?? '').trim().toLowerCase()
 	const senderNodeHash = String(opts.senderNodeHash ?? '').trim().toLowerCase()

package/link/channel_mux.mjs

@@ -43,6 +43,8 @@ const DEFAULT_ACTION_PRIORITIES = Object.freeze({
 	fed_chunk_get: 5,
 	fed_chunk_data: 5,
 	fed_chunk_ack: 5,
+	fed_manifest_get: 5,
+	fed_manifest_data: 5,
 	fed_partition_bridge: 5,
 	fed_volatile: 10,
 })
@@ -131,7 +133,7 @@ export function onBufferedAmountLow(channel, cb) {
  * @returns {{ enqueue: (action: string, bytes: Uint8Array, preferredChannel?: 'control' | 'bulk') => void, flush: (channelName?: 'control' | 'bulk') => void, pending: () => { control: number, bulk: number }, clear: () => void }} 发送队列 API
  */
 export function createChannelSendQueues(opts) {
-	const getChannel = opts.getChannel
+	const { getChannel } = opts
 	const highWatermarkBytes = Math.max(CHANNEL_LOW_THRESHOLD_BYTES, Number(opts.highWatermarkBytes) || CHANNEL_HIGH_WATERMARK_BYTES)
 	/** @type {{ control: Array<{ priority: number, seq: number, bytes: Uint8Array }>, bulk: Array<{ priority: number, seq: number, bytes: Uint8Array }> }} */
 	const queues = { control: [], bulk: [] }

package/link/link.mjs

@@ -326,7 +326,7 @@ export async function createLink(opts) {
 	 * @returns {boolean} 应重新入队则 true
 	 */
 	function shouldRetryQueuedIce(error) {
-		return /without ICE transport/i.test(String(error?.message ?? error ?? ''))
+		return /without ice transport/i.test(String(error?.message ?? error ?? ''))
 	}
 
 	/**

package/link/sdp_fingerprint.mjs

@@ -20,6 +20,6 @@ export function normalizeDtlsFingerprint(value) {
  * @returns {string | null} 规范化 fingerprint，未找到时返回 null
  */
 export function extractDtlsFingerprint(sdp) {
-	const line = String(sdp || '').match(/^a=fingerprint:sha-256\s+([0-9A-Fa-f:]+)$/mu)?.[1]
+	const line = String(sdp || '').match(/^a=fingerprint:sha-256\s+([\d:A-Fa-f]+)$/mu)?.[1]
 	return normalizeDtlsFingerprint(line)
 }

package/mailbox/store.mjs

@@ -162,7 +162,7 @@ export async function storeMailboxRecord(record) {
 	const toPubKeyHash = normalizeHex64(record.toPubKeyHash)
 	if (!isHex64(toPubKeyHash)) return false
 	const hop = normalizeMailboxHop(record.hop)
-	const tier = record.tier
+	const { tier } = record
 	if (!['trusted', 'normal', 'quarantine'].includes(tier)) return false
 	const app = String(record.app || '').trim()
 	if (!app) return false

package/node/denylist.mjs

@@ -69,7 +69,7 @@ export function invalidateDenylistIndex() {
 function getDenylistIndex() {
 	if (cachedIndex) return cachedIndex
 	const raw = readNodeJsonSync(DATA_NAME)
-	const blocked = normalizeDenylist(raw).blocked
+	const { blocked } = normalizeDenylist(raw)
 	cachedIndex = buildDenylistIndex(blocked)
 	return cachedIndex
 }
@@ -111,7 +111,7 @@ export function loadDenylist() {
  * @returns {void}
  */
 export function saveDenylist(list) {
-	const blocked = normalizeDenylist(list).blocked
+	const { blocked } = normalizeDenylist(list)
 	writeNodeJsonSync(DATA_NAME, { blocked })
 	cachedIndex = buildDenylistIndex(blocked)
 }

package/node/identity.mjs

@@ -1,6 +1,6 @@
 import { randomBytes } from 'node:crypto'
 
-import { userEntityHashFromRecoveryPubKeyHex } from '../core/entity_id.mjs'
+import { entityHashFromRecoveryPubKeyHex } from '../core/entity_id.mjs'
 import { isHex64 } from '../core/hexIds.mjs'
 import { nodeHashFromSeed } from '../entity/node_hash.mjs'
 import { normalizeMailboxSettings } from '../mailbox/settings.mjs'
@@ -8,7 +8,7 @@ import { normalizeMailboxSettings } from '../mailbox/settings.mjs'
 import { emitNodeChange } from './instance.mjs'
 import { readNodeJsonSync, writeNodeJsonSync } from './storage.mjs'
 
-const NODE_SEED_HEX_RE = /^[0-9a-f]{64}$/iu
+const NODE_SEED_HEX_RE = /^[\da-f]{64}$/iu
 const NODE_JSON = 'node'
 
 /**
@@ -90,10 +90,10 @@ export function ensureNodeDefaults() {
 /**
  * @param {string} nodeHash 64 位十六进制
  * @param {string} recoveryPubKeyHex 64 位十六进制 recovery 公钥（稳定身份锚）
- * @returns {string | null} 操作者 entityHash
+ * @returns {string | null} entityHash（非法 hex 时 null）
  */
-export function operatorEntityHashFromKeys(nodeHash, recoveryPubKeyHex) {
+export function entityHashFromKeys(nodeHash, recoveryPubKeyHex) {
 	const pub = String(recoveryPubKeyHex || '').trim().toLowerCase().replace(/^0x/iu, '')
 	if (!isHex64(nodeHash) || !isHex64(pub)) return null
-	return userEntityHashFromRecoveryPubKeyHex(nodeHash, pub)
+	return entityHashFromRecoveryPubKeyHex(nodeHash, pub)
 }

package/node/personal_block.mjs

@@ -1,5 +1,5 @@
 /**
- * 按实体的个人列表（Chat 与 Social 共享）。
+ * 按实体的个人列表。
  * **block**：对外联邦公开拉黑（timeline block 事件 + personal_block 索引）；
  * **hide**：纯本地隐藏（personal_hide.json，永不联邦）。
  */

package/overlay/index.mjs

@@ -25,7 +25,7 @@ function routeSignBytes(reqId, path) {
 export function createOverlayRouter(registry, ttl = 3) {
 	const selfNodeHash = registry.localIdentity.nodeHash
 	const selfPubKey = registry.localIdentity.nodePubKey
-	const secretKey = registry.localIdentity.secretKey
+	const { secretKey } = registry.localIdentity
 	const seenReqs = createLruMap(4096)
 	/** @type {Map<string, { resolve: (path: string[]) => void, reject: (err: Error) => void, timer: number }>} */
 	const pendingRoutes = new Map()

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@steve02081504/fount-p2p",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"description": "fount federation P2P layer — link, trust graph, mailbox, DAG, EVFS.",
 	"keywords": [
 		"network",
@@ -19,6 +19,7 @@
 	},
 	"scripts": {
 		"test": "node --test --test-concurrency=1 --test-force-exit test/pure/*.test.mjs test/integration/*.test.mjs",
+		"test:fount": "deno test -A --config deno.json test/fount/",
 		"test:live": "node --test --test-concurrency=1 --test-force-exit test/live/*.test.mjs",
 		"test:sim": "node --test --test-concurrency=1 --test-force-exit sim/test/*.test.mjs"
 	},

package/transport/rtc_connection_budget.mjs

@@ -159,6 +159,8 @@ const NON_CRITICAL_FED_ACTIONS = new Set([
 	'fed_chunk_get',
 	'fed_chunk_data',
 	'fed_chunk_ack',
+	'fed_manifest_get',
+	'fed_manifest_data',
 	'part_invoke',
 	'discovery_announce',
 	'discovery_query',

package/transport/stale_peer_log.mjs

@@ -3,9 +3,7 @@
  *
  * 无回退行为——仅在发生处记录异常「身份映射滞后于活跃连接」
  * （群/房间 + peerId + nodeHash），以便追踪 onPeerLeave 遗漏。
- * 计数通过 catchup stats 暴露给测试；磁盘记录可在 debug_logs/ 下 grep。
  */
-import { debugLog } from '../utils/debug_log.mjs'
 
 /** @type {Map<string, number>} scopeId → 累计修剪次数 */
 const pruneCounts = new Map()
@@ -31,7 +29,6 @@ export function recordStalePeerPrune(scope, staleEntries, meta = {}) {
 		lines.push(JSON.stringify(record))
 	}
 	while (recent.length > RECENT_CAP) recent.shift()
-	void debugLog('federation_stale_peer', `${lines.join('\n')}\n`).catch(() => { /* best-effort observability */ })
 }
 
 /**

package/wire/part_invoke.mjs

@@ -76,6 +76,6 @@ export function normalizePartpath(value) {
  */
 export function isPartInvoke(value) {
 	if (!isPlainObject(value)) return false
-	const kind = value.kind
+	const { kind } = value
 	return typeof kind === 'string' && kind.length > 0
 }

package/wire/rate_bucket.mjs

@@ -18,7 +18,7 @@ const buckets = createLruMap(BUCKET_MAP_MAX)
 export function consumeWireRateBucket(bucketKey, limits) {
 	const byteCount = Math.max(0, Number(limits.byteCount) || 0)
 	const maxBytes = Number(limits.maxBytesPerWindow) || 0
-	const maxCount = limits.maxCount
+	const { maxCount } = limits
 	const now = Date.now()
 	let bucket = buckets.get(bucketKey)
 	if (!bucket) {

package/entity/files/url.mjs

@@ -1,19 +0,0 @@
-/**
- * EVFS 文件 URL 辅助。
- * @param {string} entityHash 128 位十六进制
- * @param {string} logicalPath EVFS 逻辑路径
- * @returns {string} HTTP 地址
- */
-export function entityFileUrl(entityHash, logicalPath) {
-	const path = String(logicalPath || '').trim().replace(/^\/+/, '')
-	return `/api/p2p/entities/${encodeURIComponent(entityHash)}/files/${path.split('/').map(encodeURIComponent).join('/')}`
-}
-
-/**
- * profile 头像 EVFS 路径 URL。
- * @param {string} entityHash 128 位十六进制
- * @returns {string} profile 头像 HTTP 地址
- */
-export function profileAvatarFileUrl(entityHash) {
-	return entityFileUrl(entityHash, 'profile/avatar')
-}

package/entity/localized_core.mjs

@@ -1,141 +0,0 @@
-import { isEntityHash128 } from '../core/entity_id.mjs'
-
-import { profileAvatarFileUrl } from './files/url.mjs'
-
-/**
- * @param {unknown} linkItem 链接项
- * @returns {object | null} 规范化链接项或 null
- */
-function normalizeLink(linkItem) {
-	const url = String(linkItem?.url || '').trim()
-	if (!url) return null
-	return {
-		icon: String(linkItem.icon || '').trim(),
-		name: String(linkItem.name || '').trim(),
-		url,
-	}
-}
-
-/**
- * @param {unknown} localizedInput 原始 localized 字段
- * @returns {Record<string, object>} locale → 切片
- */
-export function normalizeLocalizedMap(localizedInput) {
-	if (!localizedInput) return {}
-	/** @type {Record<string, object>} */
-	const out = {}
-	for (const [key, value] of Object.entries(localizedInput)) {
-		const localeKey = String(key || '').trim()
-		if (!localeKey || !value) continue
-		const tags = Array.isArray(value.tags)
-			? value.tags.map(t => String(t).trim()).filter(Boolean)
-			: undefined
-		const links = Array.isArray(value.links)
-			? value.links.map(normalizeLink).filter(Boolean)
-			: undefined
-		/** @type {Record<string, unknown>} */
-		const slice = {}
-		if (value.name != null) slice.name = String(value.name).trim()
-		if (value.avatar) slice.avatar = String(value.avatar).trim()
-		if (value.description != null) slice.description = String(value.description)
-		if (value.description_markdown != null) slice.description_markdown = String(value.description_markdown)
-		if (value.version) slice.version = String(value.version).trim()
-		if (value.author) slice.author = String(value.author).trim()
-		if (value.home_page) slice.home_page = String(value.home_page).trim()
-		if (value.issue_page) slice.issue_page = String(value.issue_page).trim()
-		if (tags?.length) slice.tags = tags
-		if (links?.length) slice.links = links
-		if (Object.keys(slice).length) out[localeKey] = slice
-	}
-	return out
-}
-
-/**
- * @param {Record<string, object>} localized 多语言切片
- * @param {string[]} locales 区域设置优先级
- * @returns {object | null} 匹配的语言切片
- */
-function pickLocalizedSlice(localized, locales) {
-	const keys = Object.keys(localized || {})
-	if (!keys.length) return null
-	for (const locale of locales || []) {
-		if (localized[locale]) return localized[locale]
-		const prefix = String(locale).split('-')[0]
-		const hit = keys.find(k => k === prefix || k.startsWith(`${prefix}-`))
-		if (hit) return localized[hit]
-	}
-	return localized[keys[0]]
-}
-
-/**
- * @param {string} displayName 展示名
- * @param {{ subjectHash?: string }} profile 资料对象
- * @returns {boolean} 是否为占位展示名
- */
-export function isPlaceholderDisplayName(displayName, profile) {
-	const name = String(displayName || '').trim()
-	if (!name) return true
-	const subjectHash = String(profile?.subjectHash || '').trim().toLowerCase()
-	if (!subjectHash || subjectHash.length < 12) return false
-	const placeholder = `${subjectHash.slice(0, 8)}…${subjectHash.slice(-4)}`
-	return name === placeholder
-}
-
-/**
- * @param {object} stored 磁盘上的 profile 对象
- * @param {string[]} locales 查看者区域设置
- * @param {object} infoDefaults part 默认
- * @returns {object} 合并后的展示字段
- */
-export function resolveProfilePresentation(stored, locales, infoDefaults) {
-	const localized = normalizeLocalizedMap(stored?.localized)
-	const slice = pickLocalizedSlice(localized, locales) || {}
-
-	let name = slice.name?.trim() || infoDefaults.name
-	if (name && isPlaceholderDisplayName(name, stored))
-		name = infoDefaults.name
-
-	const description = slice.description != null
-		? String(slice.description)
-		: infoDefaults.description
-	const description_markdown = slice.description_markdown != null
-		? String(slice.description_markdown)
-		: slice.description != null ? String(slice.description) : infoDefaults.description_markdown
-
-	const tags = slice.tags?.length ? slice.tags : infoDefaults.tags
-	const links = slice.links?.length ? slice.links : infoDefaults.links
-
-	let avatar = slice.avatar?.trim() || infoDefaults.avatar
-	if (avatar && !avatar.startsWith('http') && isEntityHash128(stored?.entityHash))
-		avatar = profileAvatarFileUrl(stored.entityHash)
-	else if (!avatar && isEntityHash128(stored?.entityHash) && stored?.localized)
-		avatar = profileAvatarFileUrl(stored.entityHash)
-
-	return {
-		name: name || infoDefaults.name,
-		avatar: avatar || '',
-		description: description || '',
-		description_markdown: description_markdown || '',
-		version: slice.version?.trim() || infoDefaults.version || '',
-		author: slice.author?.trim() || infoDefaults.author || '',
-		home_page: slice.home_page?.trim() || infoDefaults.home_page || '',
-		issue_page: slice.issue_page?.trim() || infoDefaults.issue_page || '',
-		tags: [...tags],
-		links: [...links],
-	}
-}
-
-/**
- * @param {Record<string, object>} localized 多语言表
- * @param {string} avatarUrl 头像 URL
- * @returns {Record<string, object>} 带头像 URL 的多语言表
- */
-export function applyAvatarToAllLocales(localized, avatarUrl) {
-	const keys = Object.keys(localized)
-	if (!keys.length) return { '': { avatar: avatarUrl } }
-	/** @type {Record<string, object>} */
-	const out = {}
-	for (const key of keys)
-		out[key] = { ...localized[key], avatar: avatarUrl }
-	return out
-}

package/entity/presentation_registry.mjs

@@ -1,44 +0,0 @@
-/** @typedef {{ query?: { locales?: string | string[] } }} ExpressLikeRequest */
-
-/** @type {((replicaUsername: string, entityHash: string, locales: string[]) => Promise<object>) | null} */
-let infoDefaultsProvider = null
-
-/** @type {((req: ExpressLikeRequest, replicaUsername: string) => string[]) | null} */
-let localesFromRequestProvider = null
-
-/**
- * @param {(replicaUsername: string, entityHash: string, locales: string[]) => Promise<object>} provider 资料默认值解析器
- * @returns {void}
- */
-export function registerEntityPresentationProvider(provider) {
-	infoDefaultsProvider = provider
-}
-
-/**
- * @param {(req: ExpressLikeRequest, replicaUsername: string) => string[]} provider 请求区域设置解析器
- * @returns {void}
- */
-export function registerLocalesFromRequestProvider(provider) {
-	localesFromRequestProvider = provider
-}
-
-/**
- * @param {string} replicaUsername 查看者 replica
- * @param {string} entityHash 目标实体
- * @param {string[]} locales 区域设置优先级
- * @returns {Promise<object | null>} 展示默认值或 null
- */
-export async function resolveInfoDefaultsForEntity(replicaUsername, entityHash, locales) {
-	if (!infoDefaultsProvider) return null
-	return infoDefaultsProvider(replicaUsername, entityHash, locales)
-}
-
-/**
- * @param {ExpressLikeRequest} req HTTP 请求
- * @param {string} replicaUsername 查看者 replica
- * @returns {string[]} 区域设置列表
- */
-export function localesFromRequest(req, replicaUsername) {
-	if (localesFromRequestProvider) return localesFromRequestProvider(req, replicaUsername)
-	return ['zh-CN', 'en-UK']
-}