koishi-plugin-media-luna 0.0.1

package/client/api.ts

@@ -0,0 +1,256 @@
+import { send } from '@koishijs/client'
+import type {
+  ChannelConfig,
+  PresetData,
+  TaskData,
+  TaskStats,
+  ConnectorDefinition,
+  ConfigField,
+  GenerationResult,
+  ClientFileData,
+  MiddlewareInfo,
+  CardFieldsResponse,
+  PaginatedResponse,
+  ApiResponse
+} from './types'
+
+// 通用调用封装
+async function call<T>(event: keyof any, params?: any): Promise<T> {
+  // @ts-ignore
+  const result = await send(event, params) as ApiResponse<T>
+  if (!result.success) {
+    throw new Error(result.error || '请求失败')
+  }
+  // @ts-ignore
+  return result.data
+}
+
+// 渠道 API
+export const channelApi = {
+  list: () => call<ChannelConfig[]>('media-luna/channels/list'),
+  get: (id: number) => call<ChannelConfig>('media-luna/channels/get', { id }),
+  create: (data: Omit<ChannelConfig, 'id'>) => call<ChannelConfig>('media-luna/channels/create', data),
+  update: (id: number, data: Partial<ChannelConfig>) => call<ChannelConfig>('media-luna/channels/update', { id, data }),
+  delete: (id: number) => call<void>('media-luna/channels/delete', { id }),
+  toggle: (id: number, enabled: boolean) => call<void>('media-luna/channels/toggle', { id, enabled }),
+  tags: () => call<string[]>('media-luna/channels/tags'),
+  getByTags: (tags: string[], matchAll?: boolean) => call<ChannelConfig[]>('media-luna/channels/by-tags', { tags, matchAll })
+}
+
+// 预设 API
+export const presetApi = {
+  list: (enabledOnly?: boolean) => call<PresetData[]>('media-luna/presets/list', { enabledOnly }),
+  get: (id: number) => call<PresetData>('media-luna/presets/get', { id }),
+  create: (data: Omit<PresetData, 'id'>) => call<PresetData>('media-luna/presets/create', data),
+  update: (id: number, data: Partial<PresetData>) => call<PresetData>('media-luna/presets/update', { id, data }),
+  delete: (id: number) => call<void>('media-luna/presets/delete', { id }),
+  toggle: (id: number, enabled: boolean) => call<void>('media-luna/presets/toggle', { id, enabled }),
+  copy: (id: number) => call<PresetData>('media-luna/presets/copy', { id }),
+  matching: (channelId: number) => call<PresetData[]>('media-luna/presets/matching', { channelId }),
+  tags: () => call<string[]>('media-luna/presets/tags'),
+  getByTags: (tags: string[], matchAll?: boolean) => call<PresetData[]>('media-luna/presets/by-tags', { tags, matchAll })
+}
+
+// 任务 API
+export const taskApi = {
+  list: (params?: { userId?: number, channelId?: number, status?: string, limit?: number, offset?: number }) =>
+    call<PaginatedResponse<TaskData>>('media-luna/tasks/list', params),
+  get: (id: number) => call<TaskData>('media-luna/tasks/get', { id }),
+  delete: (id: number) => call<void>('media-luna/tasks/delete', { id }),
+  stats: (channelId?: number) => call<TaskStats>('media-luna/tasks/stats', { channelId }),
+  cleanup: (days?: number) => call<{ deleted: number, beforeDate: string }>('media-luna/tasks/cleanup', { days }),
+  recent: (userId: number, limit?: number) => call<TaskData[]>('media-luna/tasks/recent', { userId, limit }),
+  /** 获取当前用户的任务列表 */
+  my: (params?: { channelId?: number, status?: string, limit?: number, offset?: number }) =>
+    call<PaginatedResponse<TaskData>>('media-luna/tasks/my', params)
+}
+
+// 画廊类型
+export interface GalleryItem {
+  id: number
+  prompt: string
+  images: string[]
+  createdAt: Date
+  channelId: number
+}
+
+export interface GalleryResponse {
+  items: GalleryItem[]
+  total: number
+  hasMore: boolean
+}
+
+export interface RecentImage {
+  taskId: number
+  url: string
+  prompt: string
+  createdAt: Date
+}
+
+// 画廊 API
+export const galleryApi = {
+  /** 获取当前用户的生成画廊 */
+  my: (params?: { limit?: number, offset?: number, channelId?: number }) =>
+    call<GalleryResponse>('media-luna/gallery/my', params),
+  /** 获取当前用户最近生成的图片 */
+  recentImages: (limit?: number) =>
+    call<RecentImage[]>('media-luna/gallery/recent-images', { limit }),
+  /** 获取指定用户的画廊（管理员） */
+  user: (params: { uid: number, limit?: number, offset?: number, channelId?: number }) =>
+    call<GalleryResponse>('media-luna/gallery/user', params)
+}
+
+// 认证 API
+export const authApi = {
+  /** 获取当前登录用户信息 */
+  me: () => call<{ loggedIn: boolean, source?: string, uid?: number, name?: string, authority?: number }>('media-luna/auth/me')
+}
+
+// 中间件 API
+export const middlewareApi = {
+  list: () => call<MiddlewareInfo[]>('media-luna/middlewares/list'),
+  get: (name: string) => call<MiddlewareInfo>('media-luna/middlewares/get', { name }),
+  update: (name: string, data: { enabled?: boolean, config?: any }) => call<void>('media-luna/middlewares/update', { name, data }),
+  reset: (name: string) => call<void>('media-luna/middlewares/reset', { name }),
+  executionOrder: () => call<any[]>('media-luna/middlewares/execution-order'),
+  /** 获取中间件注册的卡片展示字段 */
+  cardFields: () => call<CardFieldsResponse>('media-luna/middlewares/card-fields')
+}
+
+// 连接器 API
+export const connectorApi = {
+  list: () => call<ConnectorDefinition[]>('media-luna/connectors/list'),
+  get: (id: string) => call<ConnectorDefinition>('media-luna/connectors/get', { id }),
+  fields: (id: string) => call<ConfigField[]>('media-luna/connectors/fields', { id }),
+  schema: () => call<any[]>('media-luna/connectors/schema')
+}
+
+// 生成 API
+export const generateApi = {
+  generate: (params: { channelId: number, prompt: string, files?: ClientFileData[], parameters?: any, userId?: number }) =>
+    call<GenerationResult>('media-luna/generate', params),
+  preview: (params: { channelId: number, prompt: string, parameters?: any }) =>
+    call<{ channelName: string, connectorId: string, finalPrompt: string, parameters: any }>('media-luna/generate/preview', params)
+}
+
+// 缓存类型
+export interface CacheFileInfo {
+  id: string
+  url?: string  // 可访问的 URL
+  filename: string
+  mime: string
+  size: number
+  createdAt?: Date
+  accessedAt?: Date
+}
+
+export interface CacheStats {
+  totalFiles: number
+  totalSizeMB: number
+  maxSizeMB: number
+  oldestAccess: Date | null
+  newestAccess: Date | null
+}
+
+// 缓存 API
+export const cacheApi = {
+  /** 上传文件到缓存 */
+  upload: (data: string, mime: string, filename?: string) =>
+    call<CacheFileInfo>('media-luna/cache/upload', { data, mime, filename }),
+  /** 从 URL 下载并缓存 */
+  cacheUrl: (url: string) =>
+    call<CacheFileInfo>('media-luna/cache/cache-url', { url }),
+  /** 获取缓存文件信息 */
+  get: (id: string) =>
+    call<CacheFileInfo>('media-luna/cache/get', { id }),
+  /** 读取缓存文件内容（返回 data URL） */
+  read: (id: string) =>
+    call<string>('media-luna/cache/read', { id }),
+  /** 删除缓存文件 */
+  delete: (id: string) =>
+    call<void>('media-luna/cache/delete', { id }),
+  /** 获取缓存统计信息 */
+  stats: () =>
+    call<CacheStats>('media-luna/cache/stats'),
+  /** 清空所有缓存 */
+  clear: () =>
+    call<void>('media-luna/cache/clear')
+}
+
+// 设置面板类型
+export interface SettingsPanelInfo {
+  id: string
+  name: string
+  icon: string
+  description?: string
+  order: number
+  type: 'builtin' | 'custom'
+  component?: string
+  configFields?: ConfigField[]
+  configKey?: string
+  config?: Record<string, any>
+}
+
+// 设置面板 API
+export const settingsApi = {
+  /** 获取所有设置面板 */
+  panels: () =>
+    call<SettingsPanelInfo[]>('media-luna/settings/panels'),
+  /** 获取单个设置面板 */
+  get: (id: string) =>
+    call<SettingsPanelInfo>('media-luna/settings/get', { id }),
+  /** 更新设置面板配置（仅 custom 类型） */
+  update: (id: string, config: Record<string, any>) =>
+    call<void>('media-luna/settings/update', { id, config }),
+  /** 手动触发远程预设同步（通过 preset 插件 API） */
+  syncRemotePresets: () =>
+    call<{ added: number, updated: number, removed: number }>('media-luna/presets/sync')
+}
+
+// 插件信息类型
+export interface PluginInfo {
+  id: string
+  name: string
+  description?: string
+  version?: string
+  enabled: boolean
+  configFields: ConfigField[]
+  config: Record<string, any>
+  actions: Array<{
+    name: string
+    label: string
+    type?: string
+    icon?: string
+    apiEvent: string
+  }>
+  middlewares: Array<{
+    name: string
+    displayName: string
+    phase: string
+    enabled: boolean
+  }>
+  connector?: {
+    id: string
+    name: string
+    supportedTypes: string[]
+  }
+}
+
+// 插件 API
+export const pluginApi = {
+  /** 获取所有已加载插件 */
+  list: () =>
+    call<PluginInfo[]>('media-luna/plugins/list'),
+  /** 获取单个插件信息 */
+  get: (id: string) =>
+    call<PluginInfo>('media-luna/plugins/get', { id }),
+  /** 更新插件配置 */
+  updateConfig: (pluginId: string, config: Record<string, any>) =>
+    call<void>('media-luna/plugins/update-config', { pluginId, config }),
+  /** 启用插件 */
+  enable: (id: string) =>
+    call<void>('media-luna/plugins/enable', { id }),
+  /** 禁用插件 */
+  disable: (id: string) =>
+    call<void>('media-luna/plugins/disable', { id })
+}