zcw-shared 2.23.6 → 2.24.0

package/types/cloud-disk.d.ts

@@ -0,0 +1,82 @@
+export type CloudDiskNodeKind = 'folder' | 'file'
+
+/** 列表视图语义（部分 tab 由客户端筛选实现） */
+export type CloudDiskListTab = 'all' | 'recent' | 'shared' | 'trash'
+
+export type CloudDiskNode = {
+  id: string
+  name: string
+  kind: CloudDiskNodeKind
+  parent_id: string | null
+  owner_id: string
+  size?: number | null
+  mime_type?: string | null
+  updated_at: string
+  created_at?: string
+  path_breadcrumb?: string | null
+  is_starred?: boolean
+  is_shared?: boolean
+  is_private?: boolean
+  deleted_at?: string | null
+  url?: string | null
+  thumbnail_url?: string | null
+}
+
+export type CloudDiskListResult = { items: CloudDiskNode[]; total: number }
+
+/** 后端 cloud_disk_files 行（GET /cloud-disk/files 解包后） */
+export type CloudDiskFileDto = {
+  id: string
+  user_id: string
+  name: string
+  type: 'file' | 'folder'
+  parent_id?: string | null
+  path?: string
+  mime_type?: string | null
+  size?: number | null
+  is_starred?: boolean
+  is_shared?: boolean
+  is_private?: boolean
+  created_at?: string
+  updated_at: string
+  deleted_at?: string | null
+  url?: string | null
+  thumbnail_url?: string | null
+}
+
+export type CloudDiskFileCategory =
+  | 'image'
+  | 'doc'
+  | 'video'
+  | 'audio'
+  | 'other'
+
+export type CloudDiskUploadPhase =
+  | 'preparing'
+  | 'uploading'
+  | 'confirming'
+  | 'done'
+  | 'failed'
+
+export type CloudDiskUploadTask = {
+  id: string
+  name: string
+  progress: number
+  phase: CloudDiskUploadPhase
+  error?: string
+}
+
+export type CloudDiskPrivateFolderEntry = { id: string; path: string }
+
+export type CloudDiskMediaAttachmentKind = 'image' | 'video' | 'file'
+
+export type CloudDiskPrivateFolderGuard = {
+  privateEntries: readonly CloudDiskPrivateFolderEntry[]
+  parentMap: ReadonlyMap<string, string | null | undefined>
+  unlockedFolderIds: ReadonlySet<string>
+}
+
+export type CloudDiskNodeDragPayload = {
+  id: string
+  name: string
+}

package/types/download.d.ts

@@ -0,0 +1,54 @@
+/** 下载任务进度（Electron 经 IPC 推送；浏览器通常无中间进度） */
+export interface DownloadProgress {
+  downloadId: string
+  url: string
+  state: 'progressing' | 'completed' | 'cancelled' | 'interrupted'
+  receivedBytes: number
+  totalBytes: number | null
+  /** 0–100；总量未知时为 null */
+  percent: number | null
+  filePath?: string
+  error?: string
+}
+
+export type DownloadBrowserMode = 'window' | 'anchor'
+
+export interface DownloadOptions {
+  url: string
+  /** 建议文件名（不含路径） */
+  filename?: string
+  /**
+   * 落盘目录（绝对路径，仅 Electron）。
+   * 与 `filename` 组合；未给 `filename` 时从 URL 推断。
+   */
+  directory?: string
+  /** 完整落盘路径（绝对路径，仅 Electron）；优先于 directory + filename */
+  savePath?: string
+  /** Electron：无 directory/savePath 时是否弹出另存为，默认 true */
+  showSaveDialog?: boolean
+  /** 浏览器：http(s) 默认 `window` 新标签；blob/data 自动走 `anchor` */
+  browserMode?: DownloadBrowserMode
+  /** 复用任务 id（Electron 进度事件关联） */
+  downloadId?: string
+  onProgress?: (progress: DownloadProgress) => void
+  /** Electron 下载超时（毫秒），默认 180000 */
+  timeoutMs?: number
+}
+
+export type DownloadResult =
+  | {
+      ok: true
+      downloadId: string
+      filePath?: string
+    }
+  | {
+      ok: false
+      downloadId: string
+      error: string
+      cancelled?: boolean
+    }
+
+export type DownloadByUrlHandler = (
+  url: string,
+  suggestedFileName?: string,
+) => void

package/types/im-account-kind.d.ts

@@ -0,0 +1,2 @@
+/** 与 users.account_kind 一致 */
+export type ImAccountKind = 'person' | 'ai_agent'

package/types/im-api.d.ts

@@ -66,6 +66,8 @@ export interface ImApiMessage {
   extra_data?: Record<string, any>
   created_at?: string
   updated_at?: string
+  /** 软删除时刻（ISO）；存在时列表接口不应返回该条（服务端过滤） */
+  deleted_at?: string | null
 }
 
 /** 会话对象（接口返回；成员 id 列表 + 可选最后一条消息） */
@@ -114,6 +116,7 @@ export interface ImDbMessageRow {
   extra_data?: Record<string, any>
   created_at?: string
   updated_at?: string
+  deleted_at?: string | null
 }
 
 export interface ImDbConversationRow {

package/types/im-chat.d.ts

@@ -193,3 +193,17 @@ export interface ChatConversation {
   /** 消息免打扰：列表不展示未读红点（仅客户端） */
   muted?: boolean
 }
+
+export type ChatConversationHistoryTab = 'records' | 'file' | 'image' | 'link'
+
+export interface ChatConversationHistoryFilters {
+  senderIds: string[]
+  timeStartMs: number | null
+  timeEndMs: number | null
+  mentionUserIds: string[]
+}
+
+export interface ChatConversationHistoryMessagePreview {
+  primary: string
+  thumbnailUrl?: string
+}

package/types/im-code-project.d.ts

@@ -0,0 +1,32 @@
+/** IM 代码工作区项目（GET/POST /im/code-projects，HTTP JSON 驼峰） */
+export interface ImProjectMachineBinding {
+  machineId: string
+  machineLabel: string | null
+  localRootPath: string
+  /** 该 machineId 是否有活跃桌面 Socket（HTTP 初值 + Socket 推送更新） */
+  online: boolean
+  /** 是否为当前请求头 X-Machine-Id 对应电脑 */
+  isViewerMachine: boolean
+}
+
+export interface ImProject {
+  id: string
+  ownerId: string
+  /** 拥有者展示名（会话绑定查询时由服务端解析） */
+  ownerName?: string
+  /** 项目负责人 user id（可选；须为会话内 AI 智能体） */
+  leadUserId?: string | null
+  /** 项目负责人展示名 */
+  leadName?: string
+  conversationId: string
+  name: string
+  rootFolderName: string
+  /** 当前请求携带的 X-Machine-Id（未传则为 null） */
+  viewerMachineId: string | null
+  /** 各桌面端绑定（拥有者可见路径；成员为空数组） */
+  machineBindings: ImProjectMachineBinding[]
+  /** 预留皮肤/主题 id（后端字段 doorSkin） */
+  doorSkin?: string | null
+  createdAt: string
+  updatedAt: string
+}

package/types/im-composer.d.ts

@@ -0,0 +1,23 @@
+export type ImComposerToolbarAction =
+  | { type: 'emit' }
+  | { type: 'open-file-picker'; accept: string; multiple?: boolean }
+
+export type ImComposerToolbarItemSpec = {
+  key: string
+  label: string
+  icon: string
+  disabled?: boolean
+  action?: ImComposerToolbarAction
+  buttonClass?: string
+}
+
+export type ImComposerMobileMoreItemSpec = {
+  key: string
+  label: string
+  icon: string
+}
+
+export type ImComposerToolbarOptions = {
+  /** 双人会话时显示语音/视频通话入口 */
+  showVoiceCall?: boolean
+}

package/types/im-contact.d.ts

@@ -0,0 +1,22 @@
+import type { ImAccountKind } from './im-account-kind'
+
+/** GET /im/contacts 联系人行（HTTP JSON snake_case） */
+export interface ImContact {
+  id: string
+  owner_id: string
+  /** 已注册用户 id */
+  peer_user_id: string
+  /** 对方手机号（冗余，来自 users.phone） */
+  peer_phone?: string | null
+  /** 本人备注名 */
+  display_name?: string | null
+  /** 对方 users 表展示名（GET /im/contacts 由服务端填充） */
+  peer_display_name?: string | null
+  /** 对方 users.account_kind（GET /im/contacts 由服务端填充） */
+  peer_account_kind?: ImAccountKind | null
+  /** 对方头像 URL（GET /im/contacts 由服务端填充） */
+  peer_avatar?: string | null
+  pinned?: boolean
+  created_at?: string
+  updated_at?: string
+}

package/types/im-snake-chat.d.ts

@@ -0,0 +1,33 @@
+/**
+ * IM 移动端 / 简易列表用的 snake_case 消息视图（与 `ImApiMessage` 字段名一致，无 sender 对象）。
+ * uniapp `CwChatList` 与 HTTP 轮询页共用。
+ */
+export type ImSnakeChatMessageType =
+  | 'text'
+  | 'markdown'
+  | 'image'
+  | 'file'
+  | 'audio'
+  | 'video'
+  | 'system'
+
+export type ImSnakeChatMessageStatus =
+  | 'sending'
+  | 'sent'
+  | 'delivered'
+  | 'read'
+  | 'failed'
+
+export interface ImSnakeChatMessage {
+  id: number | string
+  sender_id: string
+  conversation_id: string
+  content: string
+  type?: ImSnakeChatMessageType
+  status?: ImSnakeChatMessageStatus
+  avatar?: string
+  senderName?: string
+  timestamp?: number | string
+  extra_data?: Record<string, unknown>
+  created_at?: string
+}

package/types/llm-openai-wire.d.ts

@@ -0,0 +1 @@
+export type OpenAiWireMessage = Record<string, unknown>

package/types/observability.d.ts

@@ -0,0 +1,39 @@
+export type ObservabilityLevel = 'debug' | 'info' | 'warning' | 'error'
+
+export type ObservabilityCategory =
+  | 'app'
+  | 'vue'
+  | 'api'
+  | 'im_socket'
+  | 'unhandled'
+
+export interface ObservabilityBreadcrumb {
+  ts: number
+  category: ObservabilityCategory
+  message: string
+  data?: Record<string, unknown>
+}
+
+export interface ObservabilityRuntimeContext {
+  appVersion: string
+  mode: string
+  isDev: boolean
+  isQiankun: boolean
+  isElectron: boolean
+  isNativeShell: boolean
+  userAgent?: string
+  href?: string
+  userId?: string | null
+}
+
+export interface ApiFailureReport {
+  path: string
+  method: string
+  statusCode?: number
+  message: string
+}
+
+export interface ImSocketEventReport {
+  event: string
+  detail?: Record<string, unknown>
+}

package/types/oss-signed-upload.d.ts

@@ -0,0 +1,68 @@
+/** POST /oss/signed-upload-url 请求体 */
+export interface OssSignedUploadUrlRequest {
+  bucket: string
+  path: string
+  upsert?: boolean
+}
+
+/** POST /oss/signed-upload-url 返回体（解包后） */
+export interface OssSignedUploadUrlPayload {
+  signedUrl: string
+  token: string
+  path: string
+  bucket: string
+  publicUrl: string
+  putHints?: {
+    method: 'PUT'
+    bodyMustBeRawFileBytes: boolean
+    doNotUseFormData: boolean
+    setContentTypeHeader: boolean
+  }
+}
+
+/** POST /oss/cos-sts-credential 请求体 */
+export interface OssCosStsCredentialRequest {
+  bucket: string
+  path: string
+}
+
+/** POST /oss/cos-sts-credential 返回体 */
+export interface OssCosStsCredentialPayload {
+  region: string
+  bucket: string
+  key: string
+  tmpSecretId: string
+  tmpSecretKey: string
+  sessionToken: string
+  startTime: number
+  expiredTime: number
+  publicUrl: string
+}
+
+export interface OssSignedPutUploadResult {
+  publicUrl: string
+  path: string
+  bucket: string
+}
+
+export type OssBrowserUploadProgress = (loaded: number, total: number) => void
+
+export interface OssBrowserUploadOptions {
+  bucket: string
+  path: string
+  contentType?: string
+  cacheControl?: string
+  onProgress?: OssBrowserUploadProgress
+}
+
+export interface OssBrowserUploadResult {
+  publicUrl: string
+  bucket: string
+  path: string
+}
+
+export interface PutSupabaseSignedUploadOptions {
+  upsert?: boolean
+  cacheControl?: string
+  onUploadProgress?: (loaded: number, total: number) => void
+}