zcw-shared 2.25.0 → 2.27.0

package/types/cloud-disk.d.ts

@@ -1,56 +1,59 @@
-export type CloudDiskNodeKind = 'folder' | 'file'
+import type { ApiSchema } from './api-contract'
 
-/** 列表视图语义（部分 tab 由客户端筛选实现） */
-export type CloudDiskListTab = 'all' | 'recent' | 'shared' | 'trash'
+/** API 契约：GET /cloud-disk/files 单条 */
+export type CloudDiskFile = ApiSchema['CloudDiskFile']
 
-export type CloudDiskNode = {
+export type CloudDiskNodeKind = 'file' | 'folder'
+
+export type CloudDiskFileCategory = 'image' | 'doc' | 'video' | 'audio' | 'other'
+
+export type CloudDiskMediaAttachmentKind = 'image' | 'video' | 'file'
+
+/** 客户端列表/网格视图节点（由 {@link CloudDiskFile} 映射） */
+export interface CloudDiskNode {
   id: string
   name: string
   kind: CloudDiskNodeKind
   parent_id: string | null
-  owner_id: string
-  size?: number | null
-  mime_type?: string | null
-  updated_at: string
+  owner_id?: string
+  size?: number
+  mime_type?: string
+  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
+  url?: string
+  thumbnail_url?: string
 }
 
-export type CloudDiskListResult = { items: CloudDiskNode[]; total: number }
+export type CloudDiskListTab = 'recent' | 'shared' | 'trash'
 
-/** 后端 cloud_disk_files 行（GET /cloud-disk/files 解包后） */
-export type CloudDiskFileDto = {
+export interface CloudDiskListResult {
+  items: CloudDiskNode[]
+  total: number
+}
+
+export interface CloudDiskPrivateFolderEntry {
+  id: string
+  path: string
+}
+
+export interface CloudDiskPrivateFolderGuard {
+  privateEntries: readonly CloudDiskPrivateFolderEntry[]
+  parentMap: ReadonlyMap<string, string | null | undefined>
+  unlockedFolderIds: ReadonlySet<string>
+}
+
+export interface CloudDiskNodeDragPayload {
   id: string
-  user_id: string
   name: string
-  type: 'file' | 'folder'
+  kind?: CloudDiskNodeKind
   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'
@@ -58,25 +61,10 @@ export type CloudDiskUploadPhase =
   | 'done'
   | 'failed'
 
-export type CloudDiskUploadTask = {
+export interface CloudDiskUploadTask {
   id: string
   name: string
-  progress: number
   phase: CloudDiskUploadPhase
+  progress: number
   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/community.d.ts

@@ -0,0 +1,7 @@
+import type { ApiSchema } from './api-contract'
+
+export type CommunityPost = ApiSchema['CommunityPost']
+
+export type CreateCommunityPostPayload = ApiSchema['CreateCommunityPostRequest']
+
+export type UpdateCommunityPostPayload = ApiSchema['UpdateCommunityPostRequest']

package/types/component-material.d.ts

@@ -0,0 +1,40 @@
+import type { Component } from 'vue'
+
+/** 组件物料属性字段类型（设计器属性面板） */
+export type ComponentPropFieldType =
+  | 'string'
+  | 'number'
+  | 'boolean'
+  | { type: 'select'; options: string[] }
+
+/** 组件物料元信息（由 types.ts Props + 模板 slots + vue-ui materialMeta 推导） */
+export interface ComponentMaterialMeta {
+  props: Record<string, ComponentPropFieldType>
+  slots?: string[]
+  acceptsChildren?: boolean
+  /** vue-ui materialMeta.type：component 叶子 / container 容器 */
+  materialType?: 'component' | 'container'
+  /** 拖入画布时的初始 prop（覆盖类型推导的空字符串/0/false） */
+  defaultProps?: Record<string, unknown>
+  /** 叶子组件默认插槽文案（如按钮文字；不写入 schema，仅辅助首次展示） */
+  defaultSlotContent?: Partial<Record<string, string>>
+  /** 来自 vue-ui materialMeta.preview：设计器画布尺寸与需挂接的 slot */
+  preview?: {
+    minWidth?: number
+    minHeight?: number
+    slots?: string[]
+  }
+}
+
+/** 组件物料条目（运行时含 Vue 组件引用） */
+export interface ComponentMaterialItem {
+  id: string
+  displayName: string
+  component: Component
+  meta: ComponentMaterialMeta
+}
+
+export interface ComponentMaterialCategory {
+  category: string
+  children: ComponentMaterialItem[]
+}

package/types/im-ai-agent.d.ts

@@ -1,6 +1,6 @@
 import type { ImAccountKind } from './im-account-kind'
 
-/** `/ai/agents` 列表行（映射 Agent 选项所需字段） */
+/** `admin/ai/agents` 列表行（映射 Agent 选项所需字段） */
 export type ImAiAgentCatalogRow = {
   id?: string | null
   user_id?: string | null

package/types/im-api.d.ts

@@ -3,14 +3,13 @@
  *
  * - **终端 UI 展示**见 `zcw-shared/types/im-chat`（`ChatMessage` / `ChatConversation`，camelCase、含 sender 对象等），
  *   与本文件的 `ImApiMessage` 在设计上不同：前者是列表/气泡视图模型，后者是接口契约。
+ * - 核心 HTTP 形状以 `ApiSchema['ImApiMessage']` / `ImApiConversation` 为契约来源，此处放宽 `id` 与 `extra_data` 以兼容多存储驱动。
  */
 
+import type { ApiSchema } from './api-contract'
+
 /** 出站投递状态（与送达已读 status 分离）；库内成功落库行一般为 success */
-export type ImOutboundStatus =
-  | 'queued'
-  | 'sending'
-  | 'failed'
-  | 'success'
+export type ImOutboundStatus = NonNullable<ApiSchema['ImApiMessage']['outbound_status']>
 
 /** ImProxy 落库：用户停止或模型/流异常时的助手消息标记 */
 export interface ImApiAiReplyExtra {
@@ -63,13 +62,16 @@ export interface ImApiMessage {
    * 智能体中断回复：`extra_data.ai_reply` 见 {@link ImApiAiReplyExtra}。
    * 智能体回复用量：`extra_data.llm_context` 见 `types/im-llm-context.d.ts` 的 {@link ImLlmContextExtra}。
    */
-  extra_data?: Record<string, any>
+  extra_data?: any
   created_at?: string
   updated_at?: string
   /** 软删除时刻（ISO）；存在时列表接口不应返回该条（服务端过滤） */
   deleted_at?: string | null
 }
 
+/** TypeSpec 契约形状（`id` 为 string；`extra_data` 为 unknown） */
+export type ImApiMessageContract = ApiSchema['ImApiMessage']
+
 /** 会话对象（接口返回；成员 id 列表 + 可选最后一条消息） */
 export interface ImApiConversation {
   id: string
@@ -88,6 +90,8 @@ export interface ImApiConversation {
   updated_at?: string
 }
 
+export type ImApiConversationContract = ApiSchema['ImApiConversation']
+
 /** `registerMediaOutbound` 响应：附件 id、已落库消息、OSS 直传目标 */
 export interface ImRegisterMediaOutboundResult {
   attachmentId: string
@@ -113,7 +117,7 @@ export interface ImDbMessageRow {
   client_message_id?: string | null
   send_retry_count?: number | null
   outbound_status?: string | null
-  extra_data?: Record<string, any>
+  extra_data?: any
   created_at?: string
   updated_at?: string
   deleted_at?: string | null
@@ -157,7 +161,7 @@ export type ImMessage = ImApiMessage
 /** 与 `ImApiConversation` 相同 */
 export type ImConversation = ImApiConversation
 
-/** 与 `ImApiConversation` 相同（历史泛名，建议新代码用 ImApiConversation） */
+/** @deprecated 请使用 {@link ImConversation} */
 export type Conversation = ImApiConversation
 
 export type RegisterMediaOutboundResult = ImRegisterMediaOutboundResult

package/types/im-call.d.ts

@@ -1,3 +1,5 @@
+import type { ApiOpData } from './api-contract'
+
 /** IM 实时通话媒体类型（WebRTC，非文件消息） */
 export type ImCallMedia = 'audio' | 'video'
 
@@ -39,6 +41,5 @@ export interface ImCallSignalEventPayload extends ImCallSignalPayload {
   fromUserId: string
 }
 
-export interface ImCallIceServersResponse {
-  iceServers: RTCIceServer[]
-}
+/** GET /im/call/ice-servers → `ApiEnvelope.data` */
+export type ImCallIceServersData = ApiOpData<'ImCore_callIceServers'>

package/types/lowcode.d.ts

@@ -0,0 +1,26 @@
+import type { ApiSchema } from './api-contract'
+
+/** 可序列化节点（不含 Vue Component 引用） */
+export interface LowcodeNodeSnapshot {
+  id: string
+  typeId: string
+  props: Record<string, unknown>
+  children?: LowcodeNodeSnapshot[]
+}
+
+/** 低代码页面 schema（存库 / 运行时） */
+export type LowcodePageSchema = Omit<ApiSchema['LowcodePageSchema'], 'root'> & {
+  version: '1.0'
+  root: LowcodeNodeSnapshot[]
+}
+
+export type LowcodeApp = ApiSchema['LowcodeApp']
+export type LowcodePage = ApiSchema['LowcodePage']
+export type LowcodePageDetail = ApiSchema['LowcodePageDetail']
+export type LowcodeRuntimePage = ApiSchema['LowcodeRuntimePage']
+export type LowcodeRuntimePageMeta = ApiSchema['LowcodeRuntimePageSummary']
+
+export const EMPTY_LOWCODE_PAGE_SCHEMA: LowcodePageSchema = {
+  version: '1.0',
+  root: [],
+}

package/types/music.d.ts

@@ -1,33 +1,7 @@
-export interface MusicTrack {
-  id: number
-  title: string
-  artist: string
-  cover_url?: string
-  audio_url?: string
-  duration?: number
-  lyrics?: string
-  tags?: string[]
-  like_count?: number
-  comment_count?: number
-  share_count?: number
-  play_count?: number
-  created_at?: string
-  updated_at?: string
-}
+import type { ApiSchema } from './api-contract'
 
-export interface MusicListResponse {
-  data: MusicTrack[]
-  total: number
-  limit: number
-  offset: number
-}
+export type MusicTrack = ApiSchema['MusicTrack']
 
-export interface MusicDetailResponse {
-  data: MusicTrack
-}
+export type CreateMusicPayload = ApiSchema['CreateMusicTrackRequest']
 
-export interface CreateMusicPayload
-  extends Omit<MusicTrack, 'id' | 'created_at' | 'updated_at'> {}
-
-export interface UpdateMusicPayload
-  extends Partial<Omit<MusicTrack, 'id' | 'created_at' | 'updated_at'>> {}
+export type UpdateMusicPayload = ApiSchema['UpdateMusicTrackRequest']

package/types/notification.d.ts

@@ -1,37 +1,7 @@
-export type NotificationType =
-  | 'system'
-  | 'comment'
-  | 'reply'
-  | 'like'
-  | 'follow'
-  | 'post'
-  | 'order'
-  | 'payment'
+import type { ApiSchema } from './api-contract'
 
-export interface Notification {
-  id: number
-  user_id?: string
-  type?: NotificationType
-  title?: string
-  content?: string
-  status?: string
-  related_id?: string
-  related_type?: string
-  extra_data?: Record<string, unknown>
-  created_at?: string
-  updated_at?: string
-}
+export type NotificationType = ApiSchema['NotificationSummary']['type']
 
-export interface NotificationListResponse {
-  data: Notification[]
-}
+export type Notification = ApiSchema['NotificationSummary']
 
-export interface CreateNotificationPayload {
-  user_id: string
-  type: NotificationType
-  title: string
-  content?: string
-  related_id?: string
-  related_type?: string
-  extra_data?: Record<string, unknown>
-}
+export type CreateNotificationPayload = ApiSchema['CreateNotificationRequest']