feat(web): connect quick share flow

Signed-off-by: JustMe <mr.toing@outlook.com>

web/src/core-bridge/api.ts

@@ -0,0 +1,32 @@
+import type { ParsedChannelLink } from '@/lib/channelLink';
+import type { ArchiveEntry, ChannelInfo, ConnectionState, CreateOptions, WorkspaceEvent } from './types';
+
+/**
+ * 常驻频道的后端边界。真实实现接 @webdrop/core 与 api.md,现在由 mock.ts 提供假实现。
+ * 便捷分享有自己的边界,见 shareApi.ts。
+ */
+export interface WorkspaceApi {
+  /** 新建频道:本地生成 id 与密钥、算 PoW、POST channels(api.md) */
+  createChannel(opts: CreateOptions): Promise<ChannelInfo>;
+  /** 通过链接加入:先 GET 频道信息预览,再 POST seats */
+  joinChannel(link: ParsedChannelLink): Promise<ChannelInfo>;
+  /** 仅假实现提供:载入演示用的频道 */
+  loadDemo?(): ChannelInfo[];
+
+  /** 订阅某个频道的事件流(对应追加日志的推送),返回取消订阅函数 */
+  connect(channelId: string, onEvent: (e: WorkspaceEvent) => void): () => void;
+  sendText(text: string): Promise<void>;
+  sendFiles(files: File[]): Promise<void>;
+  /** 修改 = 追加一个替代旧条目的新版本,后写者胜 */
+  editText(id: string, text: string): Promise<void>;
+  resolveConflict(id: string, choice: 'mine' | 'theirs'): Promise<void>;
+  remove(id: string): Promise<void>;
+  setSnapshot(text: string): Promise<void>;
+  /** 取文件内容(GATED 条目会计一次下载,见 api.md);带 versionId 取旧版本 */
+  getBlob(id: string, versionId?: string): Promise<Blob>;
+  listArchive(id: string): Promise<ArchiveEntry[]>;
+  /** 标记「别的设备的修改」已看过(本地状态) */
+  markSeen(id: string): Promise<void>;
+  /** 仅假实现提供,用于演示连接状态 */
+  simulateConnection?(state: ConnectionState): void;
+}