mira-app-core 1.0.24 → 2.0.0

package/CLAUDE.md

@@ -0,0 +1,33 @@
+# mira-app-core
+
+核心库，提供事件管理 (EventManager)、库列表管理、共享类型 (User, Session, WebSocketMessage)。内含 SQLite 存储实现 (`storage/sqlite/`) 和 TypeScript SDK (`shared/sdk/`)。纯库模块，不独立启动。被 mira-app-server、mira-client、mira-scripts-core 依赖。
+
+## 约定
+
+- TypeScript strict mode，目标 ES2020+
+- 三个子导出路径：`.`、`./storage/sqlite`、`./shared/sdk`
+- EventManager 支持优先级排序，处理器返回 `false` 中断传播链
+
+## 文件索引
+
+| 文件 | 说明 |
+|------|------|
+| [claude/overview.md](claude/overview.md) | 模块总览、入口、构建命令 |
+| [claude/public-interfaces.md](claude/public-interfaces.md) | 核心导出、存储接口、SDK 接口 |
+| [claude/file-map.md](claude/file-map.md) | 全部源文件清单 (28 个 .ts 文件) |
+| [claude/changelog.md](claude/changelog.md) | 变更记录 |
+
+## 关键文件
+
+| 文件 | 说明 |
+|------|------|
+| `src/index.ts` | 模块入口 |
+| `src/event-manager.ts` | 事件管理器 |
+| `src/storage/sqlite/` | SQLite 存储层 |
+| `src/shared/sdk/` | TypeScript SDK |
+
+## 扫描状态
+
+- **版本**: 1.0.24
+- **扫描时间**: 2026-06-09T11:59:31+08:00
+- **测试**: 无独立测试

package/claude/changelog.md

@@ -0,0 +1,7 @@
+# 变更记录
+
+| 日期 | 操作 | 说明 |
+|------|------|------|
+| 2026-06-09 | 结构重构 | 确认 storage/sqlite 和 shared/sdk 已合并到 core 内部；重构文档为索引+详情分离 |
+| 2026-05-25 | 增量更新 | 确认接口签名不变，补充 EventArgs 优先级机制细节 |
+| 2026-05-20 | 初始化 | 首次生成模块文档 |

package/claude/file-map.md

@@ -0,0 +1,34 @@
+# 文件清单
+
+| 文件 | 说明 |
+|------|------|
+| `src/index.ts` | 模块入口，导出核心类型和 API |
+| `src/event-manager.ts` | EventManager + EventArgs + EventSubscription |
+| `src/LibraryList.ts` | 库列表 JSON 文件读写 |
+| **存储层** | |
+| `src/storage/sqlite/index.ts` | 存储层入口导出 |
+| `src/storage/sqlite/ILibraryServerData.ts` | 存储接口定义 |
+| `src/storage/sqlite/LibraryServerDataSQLite.ts` | SQLite 实现（主文件） |
+| `src/storage/sqlite/mixins/FileOperations.ts` | 文件操作 mixin |
+| `src/storage/sqlite/mixins/FileImport.ts` | 文件导入 mixin |
+| `src/storage/sqlite/mixins/FolderOperations.ts` | 文件夹操作 mixin |
+| `src/storage/sqlite/mixins/TagOperations.ts` | 标签操作 mixin |
+| `src/storage/sqlite/mixins/Statistics.ts` | 统计数据 mixin |
+| `src/storage/sqlite/mixins/types.ts` | mixin 类型定义 |
+| **SDK 层** | |
+| `src/shared/sdk/index.ts` | SDK 入口导出 |
+| `src/shared/sdk/types.ts` | SDK 类型定义 |
+| `src/shared/sdk/client/MiraClient.ts` | SDK 主客户端 |
+| `src/shared/sdk/client/HttpClient.ts` | HTTP 客户端 |
+| `src/shared/sdk/client/WebSocketClient.ts` | WebSocket 客户端 |
+| `src/shared/sdk/utils/EventEmitter.ts` | 事件发射器 |
+| `src/shared/sdk/modules/AuthModule.ts` | 认证模块 |
+| `src/shared/sdk/modules/UserModule.ts` | 用户模块 |
+| `src/shared/sdk/modules/LibraryModule.ts` | 素材库模块 |
+| `src/shared/sdk/modules/PluginModule.ts` | 插件模块 |
+| `src/shared/sdk/modules/FileModule.ts` | 文件模块 |
+| `src/shared/sdk/modules/DatabaseModule.ts` | 数据库模块 |
+| `src/shared/sdk/modules/DeviceModule.ts` | 设备模块 |
+| `src/shared/sdk/modules/SystemModule.ts` | 系统模块 |
+| `src/shared/sdk/modules/TagModule.ts` | 标签模块 |
+| `src/shared/sdk/modules/FolderModule.ts` | 文件夹模块 |

package/claude/overview.md

@@ -0,0 +1,37 @@
+# mira-app-core 总览
+
+## 模块职责
+
+Mira 核心库，提供不自动执行的共享基础能力。被 `mira-app-server`、`mira-client`、`mira-scripts-core` 等模块依赖。
+
+核心职责：
+1. **事件管理器 (EventManager)**: 基于 Node.js EventEmitter 的事件系统，支持优先级排序
+2. **库列表管理**: 读写 `librarys.json` 配置文件
+3. **共享类型**: `User`、`Session`、`WebSocketMessage` 等跨模块类型
+4. **SQLite 存储** (`src/storage/sqlite/`): 文件/文件夹/标签 CRUD、事务管理、统计数据
+5. **TypeScript SDK** (`src/shared/sdk/`): 链式调用 API 客户端，10 个 API 模块 + WebSocket + HTTP 双通道
+
+## 入口与启动
+
+- **入口文件**: `src/index.ts` -- 导出 EventManager、getLibraries、saveLibraries、User、Session、WebSocketMessage
+- **存储入口**: `src/storage/sqlite/index.ts` -- 导出 ILibraryServerData、LibraryServerDataSQLite
+- **SDK 入口**: `src/shared/sdk/index.ts` -- 导出 MiraClient、WebSocketClient、10 个 Module
+- **构建产物**: `dist/index.js` + `dist/index.d.ts`
+- **本模块是纯库，不独立启动**
+
+## 构建命令
+
+```bash
+pnpm run build          # tsc + vite build (SDK ESM)
+pnpm run rebuild        # 同 build
+pnpm run dev            # ts-node 开发模式
+```
+
+## 关键依赖
+
+| 依赖 | 用途 |
+|------|------|
+| axios | HTTP 请求 (SDK) |
+| queue | 队列管理 |
+| sqlite3 | SQLite 驱动 (存储层) |
+| ws | WebSocket 客户端 (SDK) |

package/claude/public-interfaces.md

@@ -0,0 +1,84 @@
+# 公开接口
+
+## 核心导出 (src/index.ts)
+
+```typescript
+// 类型
+export type User = { id, username, password, role, permissions, created_at, updated_at, is_active, email? }
+export type Session = { token, user_id, created_at, expires_at, is_active }
+export interface WebSocketMessage = { action, requestId, libraryId, clientId, payload: { type, data } }
+
+// 事件系统
+export class EventManager extends EventEmitter {
+  subscribe<T>(eventName, handler, priority?): string
+  subscribeOnce<T>(eventName, handler): string
+  unsubscribe(subscriptionId): boolean
+  broadcast<T>(eventName, args): Promise<boolean>
+  dispose(): void
+}
+// 单例: EventManager.instance
+
+// 库列表
+export function getLibraries(dirPath?): Promise<any[]>
+export function saveLibraries(dirPath?, libraries): Promise<void>
+```
+
+## 存储层 (src/storage/sqlite/)
+
+```typescript
+export interface ILibraryServerData {
+  // 文件操作
+  addFile(file): Promise<any>
+  getFile(id): Promise<any>
+  getFiles(query): Promise<any[]>
+  deleteFile(id): Promise<boolean>
+  updateFile(id, data): Promise<any>
+  // 文件夹操作
+  addFolder(folder): Promise<any>
+  getFolders(query?): Promise<any[]>
+  deleteFolder(id): Promise<boolean>
+  updateFolder(id, data): Promise<any>
+  // 标签操作
+  addTag(tag): Promise<any>
+  getTags(query?): Promise<any[]>
+  deleteTag(id): Promise<boolean>
+  updateTag(id, data): Promise<any>
+  // 统计
+  getFileStatistics(): Promise<any>
+  // 导入
+  importFiles(files, options?): Promise<any>
+}
+
+export class LibraryServerDataSQLite implements ILibraryServerData { ... }
+```
+
+## SDK (src/shared/sdk/)
+
+```typescript
+export class MiraClient {
+  constructor(config: { baseUrl, wsUrl? })
+  auth(): AuthModule
+  user(): UserModule
+  libraries(): LibraryModule
+  plugins(): PluginModule
+  files(): FileModule
+  database(): DatabaseModule
+  devices(): DeviceModule
+  system(): SystemModule
+  tags(): TagModule
+  folders(): FolderModule
+}
+
+export class WebSocketClient { ... }
+export class HttpClient { ... }
+```
+
+## package.json exports
+
+```json
+{
+  ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
+  "./storage/sqlite": { "types": "./dist/storage/sqlite/index.d.ts", ... },
+  "./shared/sdk": { "types": "./dist/shared/sdk/index.d.ts", "import": "./dist/shared/sdk/mira-sdk.esm.mjs", ... }
+}
+```

package/dist/shared/sdk/client/HttpClient.d.ts

@@ -0,0 +1,53 @@
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { ClientConfig } from '../types';
+/**
+ * HTTP 客户端基础类
+ * 提供统一的 HTTP 请求处理和错误处理
+ */
+export declare class HttpClient {
+    private axiosInstance;
+    private config;
+    constructor(config: ClientConfig);
+    /**
+     * 设置认证令牌
+     */
+    setToken(token: string): void;
+    /**
+     * 清除认证令牌
+     */
+    clearToken(): void;
+    /**
+     * GET 请求
+     */
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * POST 请求
+     */
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * PUT 请求
+     */
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * DELETE 请求
+     */
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 上传文件
+     */
+    upload<T = any>(url: string, formData: FormData, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 下载文件
+     */
+    download(url: string, config?: AxiosRequestConfig): Promise<Blob>;
+    /**
+     * 提取响应数据
+     * 支持不同的响应格式
+     */
+    private extractData;
+    /**
+     * 获取原始 axios 实例
+     */
+    getAxiosInstance(): AxiosInstance;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/shared/sdk/client/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../../src/shared/sdk/client/HttpClient.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAAiB,MAAM,OAAO,CAAC;AAChF,OAAO,EAAE,YAAY,EAA+B,MAAM,UAAU,CAAC;AAErE;;;GAGG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IA6DhC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxE;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EACb,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK3E;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,CAAC,CAAC;IAWb;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvE;;;OAGG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,gBAAgB,IAAI,aAAa;CAGpC"}

package/dist/shared/sdk/client/HttpClient.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * HTTP 客户端基础类
+ * 提供统一的 HTTP 请求处理和错误处理
+ */
+class HttpClient {
+    constructor(config) {
+        this.config = config;
+        this.axiosInstance = axios_1.default.create({
+            baseURL: config.baseURL,
+            timeout: config.timeout || 10000 * 6,
+            headers: {
+                'Content-Type': 'application/json',
+                ...config.headers,
+            },
+        });
+        // 设置请求拦截器
+        this.axiosInstance.interceptors.request.use((config) => {
+            const token = this.config.getToken?.() || this.config.token;
+            if (token) {
+                config.headers.Authorization = `Bearer ${token}`;
+            }
+            return config;
+        }, (error) => {
+            return Promise.reject(error);
+        });
+        // 设置响应拦截器
+        this.axiosInstance.interceptors.response.use((response) => {
+            return response;
+        }, (error) => {
+            if (error.response) {
+                // 服务器返回了错误状态码
+                const errorResponse = {
+                    error: error.response.data?.error || 'HTTP_ERROR',
+                    message: error.response.data?.message || error.message,
+                    timestamp: new Date().toISOString(),
+                    stack: error.response.data?.stack,
+                };
+                return Promise.reject(errorResponse);
+            }
+            else if (error.request) {
+                // 请求已发出但没有收到响应
+                const errorResponse = {
+                    error: 'NETWORK_ERROR',
+                    message: 'Network error or server is not responding',
+                    timestamp: new Date().toISOString(),
+                };
+                return Promise.reject(errorResponse);
+            }
+            else {
+                // 其他错误
+                const errorResponse = {
+                    error: 'REQUEST_ERROR',
+                    message: error.message,
+                    timestamp: new Date().toISOString(),
+                };
+                return Promise.reject(errorResponse);
+            }
+        });
+    }
+    /**
+     * 设置认证令牌
+     */
+    setToken(token) {
+        this.config.token = token;
+    }
+    /**
+     * 清除认证令牌
+     */
+    clearToken() {
+        this.config.token = undefined;
+    }
+    /**
+     * GET 请求
+     */
+    async get(url, config) {
+        const response = await this.axiosInstance.get(url, config);
+        return this.extractData(response);
+    }
+    /**
+     * POST 请求
+     */
+    async post(url, data, config) {
+        const response = await this.axiosInstance.post(url, data, config);
+        return this.extractData(response);
+    }
+    /**
+     * PUT 请求
+     */
+    async put(url, data, config) {
+        const response = await this.axiosInstance.put(url, data, config);
+        return this.extractData(response);
+    }
+    /**
+     * DELETE 请求
+     */
+    async delete(url, config) {
+        const response = await this.axiosInstance.delete(url, config);
+        return this.extractData(response);
+    }
+    /**
+     * 上传文件
+     */
+    async upload(url, formData, config) {
+        const response = await this.axiosInstance.post(url, formData, {
+            ...config,
+            headers: {
+                'Content-Type': 'multipart/form-data',
+                ...config?.headers,
+            },
+        });
+        return response.data;
+    }
+    /**
+     * 下载文件
+     */
+    async download(url, config) {
+        const response = await this.axiosInstance.get(url, {
+            ...config,
+            responseType: 'blob',
+        });
+        return response.data;
+    }
+    /**
+     * 提取响应数据
+     * 支持不同的响应格式
+     */
+    extractData(response) {
+        const data = response.data;
+        // 如果响应包含 data 字段，则提取 data
+        if (typeof data === 'object' && data !== null && 'data' in data) {
+            return data.data;
+        }
+        // 否则直接返回响应数据
+        return data;
+    }
+    /**
+     * 获取原始 axios 实例
+     */
+    getAxiosInstance() {
+        return this.axiosInstance;
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=HttpClient.js.map

package/dist/shared/sdk/client/HttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../../../src/shared/sdk/client/HttpClient.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAgF;AAGhF;;;GAGG;AACH,MAAa,UAAU;IAInB,YAAY,MAAoB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,eAAK,CAAC,MAAM,CAAC;YAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK,GAAG,CAAC;YACpC,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,GAAG,MAAM,CAAC,OAAO;aACpB;SACJ,CAAC,CAAC;QAEH,UAAU;QACV,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CACvC,CAAC,MAAM,EAAE,EAAE;YACP,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAC5D,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACN,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CACJ,CAAC;QAEF,UAAU;QACV,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACxC,CAAC,QAAQ,EAAE,EAAE;YACT,OAAO,QAAQ,CAAC;QACpB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACN,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjB,cAAc;gBACd,MAAM,aAAa,GAAkB;oBACjC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,YAAY;oBACjD,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO;oBACtD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK;iBACpC,CAAC;gBACF,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACzC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvB,eAAe;gBACf,MAAM,aAAa,GAAkB;oBACjC,KAAK,EAAE,eAAe;oBACtB,OAAO,EAAE,2CAA2C;oBACpD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACtC,CAAC;gBACF,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACJ,OAAO;gBACP,MAAM,aAAa,GAAkB;oBACjC,KAAK,EAAE,eAAe;oBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACtC,CAAC;gBACF,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACzC,CAAC;QACL,CAAC,CACJ,CAAC;IACN,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QAClB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU;QACN,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAU,GAAW,EAAE,MAA2B;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAkB,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACN,GAAW,EACX,IAAU,EACV,MAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAkB,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACL,GAAW,EACX,IAAU,EACV,MAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAkB,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAU,GAAW,EAAE,MAA2B;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAkB,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACR,GAAW,EACX,QAAkB,EAClB,MAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAI,GAAG,EAAE,QAAQ,EAAE;YAC7D,GAAG,MAAM;YACT,OAAO,EAAE;gBACL,cAAc,EAAE,qBAAqB;gBACrC,GAAG,MAAM,EAAE,OAAO;aACrB;SACJ,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,MAA2B;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE;YAC/C,GAAG,MAAM;YACT,YAAY,EAAE,MAAM;SACvB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;OAGG;IACK,WAAW,CAAI,QAA4C;QAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAE3B,0BAA0B;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YAC9D,OAAQ,IAAwB,CAAC,IAAI,CAAC;QAC1C,CAAC;QAED,aAAa;QACb,OAAO,IAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,gBAAgB;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;CACJ;AA1KD,gCA0KC"}

package/dist/shared/sdk/client/MiraClient.d.ts

@@ -0,0 +1,185 @@
+import { HttpClient } from './HttpClient';
+import { WebSocketClient } from './WebSocketClient';
+import { AuthModule } from '../modules/AuthModule';
+import { UserModule } from '../modules/UserModule';
+import { LibraryModule } from '../modules/LibraryModule';
+import { PluginModule } from '../modules/PluginModule';
+import { FileModule } from '../modules/FileModule';
+import { DatabaseModule } from '../modules/DatabaseModule';
+import { DeviceModule } from '../modules/DeviceModule';
+import { SystemModule } from '../modules/SystemModule';
+import { TagModule } from '../modules/TagModule';
+import { FolderModule } from '../modules/FolderModule';
+import { ClientConfig, WebSocketOptions } from '../types';
+/**
+ * Mira Client - 主客户端类
+ * 提供链式调用接口，统一管理所有模块
+ *
+ * @example
+ * ```typescript
+ * // 基本用法
+ * const client = new MiraClient('http://localhost:8081');
+ *
+ * // 链式调用登录并获取用户信息
+ * await client.auth().login('username', 'password');
+ * const userInfo = await client.user().getInfo();
+ *
+ * // 管理素材库
+ * const libraries = await client.libraries().getAll();
+ * await client.libraries().start('library-id');
+ *
+ * // 文件上传
+ * const uploadResult = await client.files().uploadFile(file, 'library-id');
+ * ```
+ */
+export declare class MiraClient {
+    private httpClient;
+    private _auth;
+    private _user;
+    private _libraries;
+    private _plugins;
+    private _files;
+    private _database;
+    private _devices;
+    private _system;
+    private _tags;
+    private _folders;
+    constructor(baseURL: string, config?: Partial<ClientConfig>);
+    /**
+     * 获取认证模块
+     * @returns AuthModule
+     */
+    auth(): AuthModule;
+    /**
+     * 获取用户模块
+     * @returns UserModule
+     */
+    user(): UserModule;
+    /**
+     * 获取素材库模块
+     * @returns LibraryModule
+     */
+    libraries(): LibraryModule;
+    /**
+     * 获取插件模块
+     * @returns PluginModule
+     */
+    plugins(): PluginModule;
+    /**
+     * 获取文件模块
+     * @returns FileModule
+     */
+    files(): FileModule;
+    /**
+     * 获取数据库模块
+     * @returns DatabaseModule
+     */
+    database(): DatabaseModule;
+    /**
+     * 获取设备模块
+     * @returns DeviceModule
+     */
+    devices(): DeviceModule;
+    /**
+     * 获取系统模块
+     * @returns SystemModule
+     */
+    system(): SystemModule;
+    /**
+     * 获取标签模块
+     * @returns TagModule
+     */
+    tags(): TagModule;
+    /**
+     * 获取文件夹模块
+     * @returns FolderModule
+     */
+    folders(): FolderModule;
+    /**
+     * 创建WebSocket客户端
+     * @param port WebSocket服务器端口
+     * @param options WebSocket连接选项
+     * @returns WebSocketClient
+     */
+    websocket(port: number, options?: WebSocketOptions): WebSocketClient;
+    /**
+     * 设置认证令牌
+     * @param token 访问令牌
+     * @returns MiraClient 返回自身以支持链式调用
+     */
+    setToken(token: string): MiraClient;
+    /**
+     * 清除认证令牌
+     * @returns MiraClient 返回自身以支持链式调用
+     */
+    clearToken(): MiraClient;
+    /**
+     * 快速登录方法
+     * @param username 用户名
+     * @param password 密码
+     * @returns Promise<MiraClient> 返回自身以支持链式调用
+     */
+    login(username: string, password: string): Promise<MiraClient>;
+    /**
+     * 快速登出方法
+     * @returns Promise<MiraClient> 返回自身以支持链式调用
+     */
+    logout(): Promise<MiraClient>;
+    /**
+     * 检查连接状态
+     * @returns Promise<boolean>
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * 等待服务器就绪
+     * @param timeout 超时时间（毫秒）
+     * @param checkInterval 检查间隔（毫秒）
+     * @returns Promise<boolean>
+     */
+    waitForServer(timeout?: number, checkInterval?: number): Promise<boolean>;
+    /**
+     * 获取客户端配置
+     * @returns Partial<ClientConfig>
+     */
+    getConfig(): Partial<ClientConfig>;
+    /**
+     * 更新客户端配置
+     * @param config 新的配置
+     * @returns MiraClient 返回自身以支持链式调用
+     */
+    updateConfig(config: Partial<ClientConfig>): MiraClient;
+    /**
+     * 获取原始 HTTP 客户端（用于高级用法）
+     * @returns HttpClient
+     */
+    getHttpClient(): HttpClient;
+    /**
+     * 创建新的客户端实例（用于多服务器场景）
+     * @param baseURL 新的服务器地址
+     * @param config 配置选项
+     * @returns MiraClient
+     */
+    static create(baseURL: string, config?: Partial<ClientConfig>): MiraClient;
+    /**
+     * 批量操作工具方法 - 执行多个异步操作
+     * @param operations 操作函数数组
+     * @returns Promise<any[]>
+     */
+    batch<T>(operations: Array<() => Promise<T>>): Promise<T[]>;
+    /**
+     * 错误处理工具方法
+     * @param operation 要执行的操作
+     * @param fallback 失败时的回退值
+     * @returns Promise<T>
+     */
+    safe<T>(operation: () => Promise<T>, fallback: T): Promise<T>;
+    /**
+     * 重试工具方法
+     * @param operation 要执行的操作
+     * @param maxRetries 最大重试次数
+     * @param delay 重试间隔（毫秒）
+     * @returns Promise<T>
+     */
+    retry<T>(operation: () => Promise<T>, maxRetries?: number, delay?: number): Promise<T>;
+}
+//# sourceMappingURL=MiraClient.d.ts.map

package/dist/shared/sdk/client/MiraClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiraClient.d.ts","sourceRoot":"","sources":["../../../../src/shared/sdk/client/MiraClient.ts"],"names":[],"mappings":"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"}