import type { Message } from "@langchain/langgraph-sdk"; import { apiFetch } from "@/core/api"; import { getBackendBaseURL } from "@/core/config"; import { OptType, writeYLog } from "@/core/log/y-log"; /** * Share modes: * - `import` — recipient (a logged-in user) copies the conversation into * their own account and can keep chatting in the copy. * - `view` — a public, read-only static page anyone can open without * logging in; viewers cannot send new messages. */ export type ThreadShareMode = "import" | "view"; export interface ThreadShare { share_code: string; owner_user_id: string; thread_id: string; revoked: boolean; mode: ThreadShareMode; created_at: string | null; } /** Read-only conversation snapshot returned by the public view-share endpoint. */ export interface PublicShareSnapshot { share_code: string; title: string; mode: string; messages: Message[]; artifacts: string[]; created_at: string | null; } export interface SharePreview { share_code: string; shared_by: string; title: string; } export interface ImportResult { imported: number; skipped: number; } const baseUrl = () => `${getBackendBaseURL()}/api/thread-shares`; async function parseError(response: Response, fallback: string): Promise { const data = (await response.json().catch(() => ({}))) as { detail?: unknown }; const detail = data.detail; const message = typeof detail === "string" && detail ? detail : `${fallback} (HTTP ${response.status})`; return new Error(message); } /** Create (or reuse) a share code for one conversation in the given mode. */ export async function createShare( threadId: string, mode: ThreadShareMode = "import", ): Promise { const response = await apiFetch(baseUrl(), { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ thread_id: threadId, mode }), }); if (!response.ok) throw await parseError(response, "创建分享失败"); const result = (await response.json()) as ThreadShare; writeYLog({ optType: OptType.create, optDetail: "CM助手-全量-会话分享-创建分享", url: baseUrl(), reqParam: { thread_id: threadId, mode }, returnParam: { share_code: result.share_code, mode: result.mode }, }); return result; } /** List the current user's own share links. */ export async function listShares(): Promise { const response = await apiFetch(baseUrl()); if (!response.ok) throw await parseError(response, "加载分享列表失败"); const json = (await response.json()) as { shares: ThreadShare[] }; writeYLog({ optType: OptType.search, optDetail: "CM助手-全量-会话分享-查询分享列表", url: baseUrl(), returnParam: { count: json.shares.length }, }); return json.shares; } /** Revoke a share link so it can no longer be previewed or imported. */ export async function revokeShare(shareCode: string): Promise { const url = `${baseUrl()}/${encodeURIComponent(shareCode)}`; const response = await apiFetch(url, { method: "DELETE" }); if (!response.ok) throw await parseError(response, "撤销分享失败"); writeYLog({ optType: OptType.delete, optDetail: "CM助手-全量-会话分享-撤销分享", url, reqParam: { shareCode }, }); } /** Preview a share link before importing it. */ export async function previewShare(shareCode: string): Promise { const url = `${baseUrl()}/${encodeURIComponent(shareCode)}/preview`; const response = await apiFetch(url); if (!response.ok) throw await parseError(response, "无法读取该分享"); const result = (await response.json()) as SharePreview; writeYLog({ optType: OptType.view, optDetail: "CM助手-全量-会话分享-预览分享", url, reqParam: { shareCode }, }); return result; } /** Import every conversation behind a share link into the current account. */ export async function importShare(shareCode: string): Promise { const url = `${baseUrl()}/${encodeURIComponent(shareCode)}/import`; const response = await apiFetch(url, { method: "POST" }); if (!response.ok) throw await parseError(response, "导入失败"); const result = (await response.json()) as ImportResult; writeYLog({ optType: OptType.import, optDetail: "CM助手-全量-会话分享-导入分享", url, reqParam: { shareCode }, returnParam: result, }); return result; } /** * Fetch the public read-only snapshot of a `view`-mode share. * * Uses a plain `fetch` (no auth header) — the `/api/public/` endpoint is * intentionally world-readable so anyone with the link can open it. */ export async function getPublicShareSnapshot( shareCode: string, ): Promise { const response = await fetch( `${getBackendBaseURL()}/api/public/shares/${encodeURIComponent(shareCode)}`, ); if (!response.ok) throw await parseError(response, "无法打开该分享"); return response.json() as Promise; } /** Build the shareable public URL for a `view`-mode share code. */ export function buildPublicShareUrl(shareCode: string): string { // The app uses HashRouter, so the public viewer lives at `#/share/`. return `${window.location.origin}${window.location.pathname}#/share/${shareCode}`; } /** * Extract a share code from arbitrary pasted text — accepts either a raw code * or a URL/link that contains one. Share codes are 6-12 chars from the * unambiguous alphabet (no 0/1/O/I/L). */ export function extractShareCode(input: string): string { const trimmed = input.trim(); const matches = trimmed.toUpperCase().match(/[A-HJ-NP-Z2-9]{6,12}/g); return matches && matches.length > 0 ? matches[matches.length - 1] : trimmed; }