feat(web): add spaces, grouped channels and file chat

web/src/core-bridge/api.ts

@@ -1,27 +1,43 @@
 import type { ParsedChannelLink } from '@/lib/channelLink';
-import type { ArchiveEntry, ChannelInfo, ConnectionState, CreateOptions, WorkspaceEvent } from './types';
+import type { AccountInvitation } from './account';
+import type { ArchiveEntry, ChannelInfo, ChannelSettingsPatch, ConnectionState, CreateOptions, FileUploadOptions, WorkspaceEvent } from './types';
 
 /**
- * 常驻频道的后端边界。真实实现接 @webdrop/core 与 api.md,现在由 mock.ts 提供假实现。
+ * 常驻空间的后端边界。真实实现接 @webdrop/core 与 api.md,现在由 mock.ts 提供假实现。
  * 便捷分享有自己的边界,见 shareApi.ts。
  */
 export interface WorkspaceApi {
-  /** 新建频道:本地生成 id 与密钥、算 PoW、POST channels(api.md) */
+  /** 新建空间:本地生成 id 与密钥、算 PoW、POST channels(api.md) */
   createChannel(opts: CreateOptions, captchaToken?: string): Promise<ChannelInfo>;
-  /** 通过链接加入:先 GET 频道信息预览,再 POST seats */
-  joinChannel(link: ParsedChannelLink): Promise<ChannelInfo>;
+  /** 使用现有空间 settings 接口更新空间设置。 */
+  updateChannelSettings(patch: ChannelSettingsPatch): Promise<void>;
+  renameDevice(endpointHash: string, name: string): Promise<void>;
+  releaseDevice(endpointHash: string): Promise<void>;
+  /** 通过链接加入:先 GET 空间信息预览,再 POST seats */
+  joinChannel(link: ParsedChannelLink, password?: string): Promise<ChannelInfo>;
+  inviteUser(username: string): Promise<void>;
+  listInvitations(): Promise<AccountInvitation[]>;
+  revokeInvitation(username: string): Promise<void>;
   listSaved(): Promise<ChannelInfo[]>;
-  /** 仅从本机删除保存的链接和终端密钥,不会删服务端频道 */
+  /** 仅从本机删除保存的链接和终端密钥,不会删服务端空间 */
   forget(id: string): Promise<void>;
-  /** 仅假实现提供:载入演示用的频道 */
+  /** 仅假实现提供:载入演示用的空间 */
   loadDemo?(): ChannelInfo[];
 
-  /** 订阅某个频道的事件流(对应追加日志的推送),返回取消订阅函数 */
+  /** 订阅某个空间的事件流(对应追加日志的推送),返回取消订阅函数 */
   connect(channelId: string, onEvent: (e: WorkspaceEvent) => void): () => void;
-  sendText(text: string): Promise<void>;
-  sendFiles(files: File[]): Promise<void>;
+  sendText(text: string, threadId?: string): Promise<void>;
+  sendFiles(files: File[], options?: FileUploadOptions, threadId?: string, folderId?: string): Promise<void>;
+  createThread(name: string, groupId?: string): Promise<string>;
+  createGroup(name: string): Promise<string>;
+  renameGroup(id: string, name: string): Promise<void>;
+  groupThread(id: string, groupId?: string): Promise<void>;
+  renameThread(threadId: string, name: string): Promise<void>;
+  createFolder(threadId: string, name: string, parentId?: string): Promise<void>;
+  renameFolder(folderId: string, threadId: string, name: string): Promise<void>;
+  moveItems(itemIds: string[], threadId: string, folderId?: string): Promise<void>;
   /** 修改 = 追加一个替代旧条目的新版本,后写者胜 */
-  editText(id: string, text: string): Promise<void>;
+  editText(id: string, text: string, threadId?: string): Promise<void>;
   resolveConflict(id: string, choice: 'mine' | 'theirs'): Promise<void>;
   remove(id: string): Promise<void>;
   setSnapshot(text: string): Promise<void>;