WeKnora/frontend/src/components/sessionSidebarBuckets.ts

196 lines
5.0 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

// OpenAI-style sidebar: channel folders (IM / embed) + flat/date-grouped chats,
// each bucket paginates independently via the API `source` param.
import type { SessionForGrouping } from './sessionGrouping'
export const SIDEBAR_BUCKET_PAGE_SIZE = 30
export type SidebarBucketKind = 'web' | 'im' | 'embed' | 'api'
export interface SidebarSessionBucket {
key: string
apiSource: string
label: string
kind: SidebarBucketKind
platform?: string
page: number
total: number
items: SessionForGrouping[]
loaded: boolean
loading: boolean
/** 已通过轻量 count 探测(page_size=1),用于隐藏无会话的渠道文件夹 */
countKnown: boolean
}
export interface BucketDefinition {
key: string
apiSource: string
label: string
kind: SidebarBucketKind
platform?: string
}
export function createEmptyBucket(def: BucketDefinition): SidebarSessionBucket {
return {
...def,
page: 0,
total: 0,
items: [],
loaded: false,
loading: false,
countKnown: false,
}
}
export function bucketHasMore(bucket: SidebarSessionBucket): boolean {
return bucket.items.length < bucket.total
}
export function bucketVisible(bucket: SidebarSessionBucket): boolean {
if (!isChannelBucket(bucket)) return true
if (!bucket.countKnown) return false
return bucket.total > 0
}
export function applyBucketCountProbe(
bucket: SidebarSessionBucket,
total: number,
): SidebarSessionBucket {
return { ...bucket, total, countKnown: true }
}
export function isChannelBucket(bucket: SidebarSessionBucket): boolean {
return bucket.kind === 'im' || bucket.kind === 'embed' || bucket.kind === 'api'
}
export function isChannelBucketKey(key: string): boolean {
return key.startsWith('im:') || key.startsWith('embed:') || key === API_SESSION_BUCKET_KEY
}
// API_SESSION_BUCKET_KEY is the admin-only bucket that lists every API-key
// session in the tenant. IM and embed folders are also admin-only; they are
// probed for a count first and only surfaced when they have sessions.
export const API_SESSION_BUCKET_KEY = 'api'
export function buildBucketDefinitions(
imPlatforms: string[],
embedChannels: Record<string, string>,
labels: {
web: string
imPlatform: (platform: string) => string
embedChannel: (name: string) => string
api: string
},
options: { includeAdminChannelBuckets?: boolean } = {},
): BucketDefinition[] {
const includeChannels = options.includeAdminChannelBuckets ?? false
const imDefs = includeChannels
? imPlatforms.map((platform) => ({
key: `im:${platform}`,
apiSource: platform,
label: labels.imPlatform(platform),
kind: 'im' as const,
platform,
}))
: []
const embedDefs = includeChannels
? Object.entries(embedChannels).map(([id, name]) => ({
key: `embed:${id}`,
apiSource: `embed:${id}`,
label: labels.embedChannel(name || id.slice(0, 8)),
kind: 'embed' as const,
}))
: []
const apiDefs: BucketDefinition[] = includeChannels
? [
{
key: API_SESSION_BUCKET_KEY,
apiSource: API_SESSION_BUCKET_KEY,
label: labels.api,
kind: 'api' as const,
},
]
: []
return [
...imDefs,
...embedDefs,
...apiDefs,
{
key: 'web',
apiSource: 'web',
label: labels.web,
kind: 'web',
},
]
}
export function mergeBucketPage(
bucket: SidebarSessionBucket,
rows: SessionForGrouping[],
total: number,
page: number,
): SidebarSessionBucket {
const seen = new Set(bucket.items.map((s) => s.id))
const merged = [...bucket.items]
for (const row of rows) {
if (seen.has(row.id)) continue
seen.add(row.id)
merged.push(row)
}
return {
...bucket,
page,
total,
items: merged,
loaded: true,
loading: false,
}
}
export function flattenBucketItems(
buckets: Record<string, SidebarSessionBucket>,
order: string[],
): SessionForGrouping[] {
const out: SessionForGrouping[] = []
const seen = new Set<string>()
for (const key of order) {
const bucket = buckets[key]
if (!bucket) continue
for (const item of bucket.items) {
if (seen.has(item.id)) continue
seen.add(item.id)
out.push(item)
}
}
return out
}
export function prependSessionToWebBucket(
bucket: SidebarSessionBucket,
session: SessionForGrouping,
): SidebarSessionBucket {
if (bucket.items.some((row) => row.id === session.id)) return bucket
return {
...bucket,
items: [session, ...bucket.items],
total: bucket.total + 1,
loaded: true,
}
}
export function removeSessionFromBuckets(
buckets: Record<string, SidebarSessionBucket>,
sessionId: string,
): Record<string, SidebarSessionBucket> {
const next: Record<string, SidebarSessionBucket> = {}
for (const [key, bucket] of Object.entries(buckets)) {
const items = bucket.items.filter((s) => s.id !== sessionId)
next[key] = {
...bucket,
items,
total: Math.max(0, bucket.total - (items.length < bucket.items.length ? 1 : 0)),
}
}
return next
}