SurfSense/surfsense_web/lib/chat/mention-doc-key.ts

type MentionKeyInput = {
	id: number;
	document_type?: string | null;
	connector_type?: string | null;
	kind?: "doc" | "folder" | "connector" | "thread";
};

/**
 * Build a stable dedup key for a mention chip.
 *
 * Each mention kind keys off its real identity fields:
 * docs by document type, folders by folder id, connectors by
 * connector type + account id, and threads by thread id.
 */
export function getMentionDocKey(doc: MentionKeyInput): string {
	const kind = doc.kind ?? "doc";
	if (kind === "folder") return `folder:${doc.id}`;
	if (kind === "thread") return `thread:${doc.id}`;
	if (kind === "connector") return `connector:${doc.connector_type ?? "UNKNOWN"}:${doc.id}`;
	return `doc:${doc.document_type ?? "UNKNOWN"}:${doc.id}`;
}