ai-world-sdk 1.2.0 → 1.2.1

package/dist/__tests__/example.test.js

@@ -1581,3 +1581,123 @@ describe("Langchain SDK Tests", () => {
         }
     }, 240000);
 });
+// ==================== MinIO 存储测试 ====================
+describe("MinIO Storage Tests", () => {
+    const PLUGIN_ID = "test-plugin";
+    let storageClient;
+    beforeAll(() => {
+        index_1.sdkConfig.setPluginId(PLUGIN_ID);
+        storageClient = new index_1.MinioStorageClient();
+    });
+    test("MinIO 存储 - 上传文件", async () => {
+        const content = "Hello, MinIO! This is a test file.";
+        const blob = new Blob([content], { type: "text/plain" });
+        const file = new File([blob], "test-hello.txt", { type: "text/plain" });
+        const result = await storageClient.upload("test/hello.txt", file);
+        expect(result).toBeDefined();
+        expect(result.path).toBe("test/hello.txt");
+        expect(result.size).toBeGreaterThan(0);
+        expect(result.etag).toBeDefined();
+        console.log("上传成功:", result);
+    }, 30000);
+    test("MinIO 存储 - 列出文件", async () => {
+        const files = await storageClient.list({ prefix: "test/" });
+        expect(files).toBeDefined();
+        expect(Array.isArray(files)).toBe(true);
+        expect(files.length).toBeGreaterThan(0);
+        const testFile = files.find((f) => f.name === "test/hello.txt");
+        expect(testFile).toBeDefined();
+        console.log("文件列表:", files);
+    }, 30000);
+    test("MinIO 存储 - 获取文件信息", async () => {
+        const info = await storageClient.info("test/hello.txt");
+        expect(info).toBeDefined();
+        expect(info.name).toBe("test/hello.txt");
+        expect(info.size).toBeGreaterThan(0);
+        expect(info.content_type).toBe("text/plain");
+        console.log("文件信息:", info);
+    }, 30000);
+    test("MinIO 存储 - 下载文件", async () => {
+        const blob = await storageClient.download("test/hello.txt");
+        expect(blob).toBeDefined();
+        expect(blob.size).toBeGreaterThan(0);
+        const text = await blob.text();
+        expect(text).toBe("Hello, MinIO! This is a test file.");
+        console.log("下载成功, 内容:", text);
+    }, 30000);
+    test("MinIO 存储 - 获取预签名下载 URL", async () => {
+        const result = await storageClient.getPresignedUrl("test/hello.txt", 600);
+        expect(result).toBeDefined();
+        expect(result.url).toBeDefined();
+        expect(result.url).toContain("http");
+        expect(result.expires_in).toBe(600);
+        console.log("预签名下载 URL:", result.url);
+    }, 30000);
+    test("MinIO 存储 - 获取预签名上传 URL", async () => {
+        const result = await storageClient.getPresignedUploadUrl("test/upload-via-presigned.txt", 600);
+        expect(result).toBeDefined();
+        expect(result.url).toBeDefined();
+        expect(result.url).toContain("http");
+        expect(result.expires_in).toBe(600);
+        console.log("预签名上传 URL:", result.url);
+    }, 30000);
+    test("MinIO 存储 - 删除文件", async () => {
+        // 先上传一个用于删除测试的文件
+        const blob = new Blob(["delete me"], { type: "text/plain" });
+        const file = new File([blob], "to-delete.txt", { type: "text/plain" });
+        await storageClient.upload("test/to-delete.txt", file);
+        // 删除文件
+        await storageClient.delete("test/to-delete.txt");
+        console.log("删除成功: test/to-delete.txt");
+        // 验证文件已删除（获取信息应该失败）
+        try {
+            await storageClient.info("test/to-delete.txt");
+            // 如果没有抛出错误，说明文件还在
+            console.warn("文件可能未被删除");
+        }
+        catch (error) {
+            expect(error.message).toContain("404");
+            console.log("验证: 文件已成功删除");
+        }
+    }, 30000);
+    test("MinIO 存储 - 清理测试文件", async () => {
+        // 清理上传的测试文件
+        try {
+            await storageClient.delete("test/hello.txt");
+            console.log("清理完成: test/hello.txt");
+        }
+        catch {
+            console.log("清理: test/hello.txt 已不存在");
+        }
+    }, 30000);
+    test("MinIO 存储 - 无 Plugin ID 时应报错", async () => {
+        // 创建一个没有 pluginId 的客户端
+        const clientWithoutPlugin = new index_1.MinioStorageClient({
+            baseUrl: "http://localhost:8000",
+            token: index_1.sdkConfig.getToken() || "",
+        });
+        // 临时清除 pluginId
+        const originalPluginId = index_1.sdkConfig.getPluginId();
+        index_1.sdkConfig._pluginId = null;
+        index_1.sdkConfig._headers = {
+            ...index_1.sdkConfig.getHeaders(),
+        };
+        delete index_1.sdkConfig._headers["X-Plugin-Id"];
+        const clientNoPlugin = new index_1.MinioStorageClient({
+            baseUrl: "http://localhost:8000",
+            token: index_1.sdkConfig.getToken() || "",
+        });
+        try {
+            await clientNoPlugin.list();
+            fail("应该抛出错误");
+        }
+        catch (error) {
+            expect(error.message).toContain("X-Plugin-Id");
+            console.log("正确抛出错误:", error.message);
+        }
+        // 恢复 pluginId
+        if (originalPluginId) {
+            index_1.sdkConfig.setPluginId(originalPluginId);
+        }
+    }, 30000);
+});

package/dist/__tests__/minio.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MinioStorageClient 测试
+ * 使用真实 SDK 调用后端 /api/minio 接口
+ * 需要后端运行 + MinIO 服务可用
+ *
+ * 运行: npm run test:minio
+ */
+export {};

package/dist/__tests__/minio.test.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * MinioStorageClient 测试
+ * 使用真实 SDK 调用后端 /api/minio 接口
+ * 需要后端运行 + MinIO 服务可用
+ *
+ * 运行: npm run test:minio
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv = __importStar(require("dotenv"));
+const index_1 = require("../index");
+dotenv.config();
+index_1.sdkConfig.setBaseUrl("http://localhost:8000");
+index_1.sdkConfig.setToken(process.env.AUTH_TOKEN || process.env.TOKEN || "");
+index_1.sdkConfig.setDebug(true);
+const PLUGIN_ID = "test-plugin";
+describe("MinioStorageClient 测试", () => {
+    let client;
+    beforeAll(() => {
+        index_1.sdkConfig.setPluginId(PLUGIN_ID);
+        client = new index_1.MinioStorageClient();
+    });
+    // ==================== 上传 ====================
+    test("上传文本文件", async () => {
+        const content = "Hello, MinIO! Timestamp: " + Date.now();
+        const blob = new Blob([content], { type: "text/plain" });
+        const file = new File([blob], "hello.txt", { type: "text/plain" });
+        const result = await client.upload("test/hello.txt", file);
+        expect(result).toBeDefined();
+        expect(result.path).toBe("test/hello.txt");
+        expect(result.size).toBeGreaterThan(0);
+        expect(result.etag).toBeDefined();
+        expect(result.bucket).toBeDefined();
+        console.log("上传成功:", result);
+    }, 30000);
+    test("上传不指定 path 时使用文件名", async () => {
+        const blob = new Blob(["auto-name-test"], { type: "text/plain" });
+        const file = new File([blob], "auto-name.txt", { type: "text/plain" });
+        const result = await client.upload("test/auto-name.txt", file);
+        expect(result).toBeDefined();
+        expect(result.size).toBe(14);
+        console.log("自动命名上传成功:", result);
+    }, 30000);
+    // ==================== 列表 ====================
+    test("列出文件", async () => {
+        const files = await client.list({ prefix: "test/" });
+        expect(files).toBeDefined();
+        expect(Array.isArray(files)).toBe(true);
+        expect(files.length).toBeGreaterThan(0);
+        const helloFile = files.find((f) => f.name === "test/hello.txt");
+        expect(helloFile).toBeDefined();
+        console.log(`文件列表 (${files.length} 个):`, files.map((f) => f.name));
+    }, 30000);
+    test("列出文件 - 无 prefix", async () => {
+        const files = await client.list();
+        expect(files).toBeDefined();
+        expect(Array.isArray(files)).toBe(true);
+        console.log(`全部文件 (${files.length} 个)`);
+    }, 30000);
+    test("列出文件 - 非递归", async () => {
+        const files = await client.list({ prefix: "test/", recursive: false });
+        expect(files).toBeDefined();
+        expect(Array.isArray(files)).toBe(true);
+        console.log(`非递归列表 (${files.length} 个):`, files.map((f) => ({ name: f.name, is_dir: f.is_dir })));
+    }, 30000);
+    // ==================== 文件信息 ====================
+    test("获取文件信息", async () => {
+        const info = await client.info("test/hello.txt");
+        expect(info).toBeDefined();
+        expect(info.name).toBe("test/hello.txt");
+        expect(info.size).toBeGreaterThan(0);
+        expect(info.content_type).toBe("text/plain");
+        expect(info.etag).toBeDefined();
+        expect(info.last_modified).toBeDefined();
+        console.log("文件信息:", info);
+    }, 30000);
+    // ==================== 下载 ====================
+    test("下载文件", async () => {
+        const blob = await client.download("test/hello.txt");
+        expect(blob).toBeDefined();
+        expect(blob.size).toBeGreaterThan(0);
+        const text = await blob.text();
+        expect(text).toContain("Hello, MinIO!");
+        console.log("下载成功, 大小:", blob.size, "内容:", text.substring(0, 50));
+    }, 30000);
+    // ==================== 预签名 URL ====================
+    test("获取预签名下载 URL", async () => {
+        const result = await client.getPresignedUrl("test/hello.txt", 600);
+        expect(result).toBeDefined();
+        expect(result.url).toBeDefined();
+        expect(result.url).toContain("http");
+        expect(result.expires_in).toBe(600);
+        console.log("预签名下载 URL:", result.url.substring(0, 100) + "...");
+    }, 30000);
+    test("获取预签名上传 URL", async () => {
+        const result = await client.getPresignedUploadUrl("test/presigned-upload.txt", 600);
+        expect(result).toBeDefined();
+        expect(result.url).toBeDefined();
+        expect(result.url).toContain("http");
+        expect(result.expires_in).toBe(600);
+        console.log("预签名上传 URL:", result.url.substring(0, 100) + "...");
+    }, 30000);
+    // ==================== 删除 ====================
+    test("删除文件", async () => {
+        // 上传一个用于删除的文件
+        const blob = new Blob(["delete me"], { type: "text/plain" });
+        const file = new File([blob], "to-delete.txt", { type: "text/plain" });
+        await client.upload("test/to-delete.txt", file);
+        // 删除
+        await client.delete("test/to-delete.txt");
+        console.log("删除成功: test/to-delete.txt");
+        // 验证文件已删除
+        try {
+            await client.info("test/to-delete.txt");
+            console.warn("文件可能未被删除");
+        }
+        catch (error) {
+            expect(error.message).toMatch(/404|不存在/);
+            console.log("验证: 文件已成功删除");
+        }
+    }, 30000);
+    // ==================== 清理 ====================
+    test("清理测试文件", async () => {
+        const filesToClean = ["test/hello.txt", "test/auto-name.txt"];
+        for (const path of filesToClean) {
+            try {
+                await client.delete(path);
+                console.log("清理:", path);
+            }
+            catch {
+                console.log("清理跳过:", path, "(不存在)");
+            }
+        }
+    }, 30000);
+    // ==================== 错误处理 ====================
+    test("下载不存在的文件应返回 404", async () => {
+        try {
+            await client.download("nonexist/file-" + Date.now() + ".txt");
+            fail("应该抛出错误");
+        }
+        catch (error) {
+            expect(error.message).toMatch(/404|不存在/);
+            console.log("正确返回 404:", error.message);
+        }
+    }, 30000);
+    test("无 Plugin ID 时应报错", async () => {
+        // 保存原始值
+        const originalPluginId = index_1.sdkConfig.getPluginId();
+        const originalHeaders = { ...index_1.sdkConfig.getHeaders() };
+        // 清除 pluginId
+        index_1.sdkConfig._pluginId = null;
+        delete index_1.sdkConfig._headers["X-Plugin-Id"];
+        const clientNoPlugin = new index_1.MinioStorageClient({
+            baseUrl: "http://localhost:8000",
+            token: index_1.sdkConfig.getToken() || "",
+        });
+        try {
+            await clientNoPlugin.list();
+            fail("应该抛出错误");
+        }
+        catch (error) {
+            expect(error.message).toContain("X-Plugin-Id");
+            console.log("正确抛出错误:", error.message);
+        }
+        // 恢复
+        if (originalPluginId) {
+            index_1.sdkConfig.setPluginId(originalPluginId);
+        }
+    }, 30000);
+});

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.0";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.1";
 /**
  * 版本兼容性错误
  */
@@ -24,8 +24,8 @@ declare class SDKConfig {
     private _pluginId;
     private _versionCompatible;
     private _versionCheckPromise;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.2.0";
-    readonly sdkVersion = "1.2.0";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.2.1";
+    readonly sdkVersion = "1.2.1";
     constructor();
     /**
      * Set global base URL

package/dist/config.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkConfig = exports.VersionCompatibilityError = exports.SDK_SIGNATURE = void 0;
 // SDK 版本号（构建时自动从 package.json 更新）
 // 此版本号会在运行 npm run build 时自动从 package.json 读取并更新
-const SDK_VERSION = "1.2.0";
+const SDK_VERSION = "1.2.1";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.2.0";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.0";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.1";
 /**
  * 版本兼容性错误
  */

package/dist/index.d.ts

@@ -27,6 +27,7 @@ export { GeminiImageGenerationClient, type GeminiImageGenerationConfig, type Gem
 export { VideoGenerationClient, type VideoGenerationConfig, type VideoGenerationRequest, type ContentGenerationTaskID, type ContentGenerationTask, };
 export { OpenAIVideoGenerationClient, type OpenAIVideoGenerationConfig, type OpenAIVideoGenerationRequest, type OpenAIVideoTaskResponse, };
 export { DownloadClient, type DownloadConfig, type DownloadOptions, type StreamDownloadOptions, };
+export { MinioStorageClient, type MinioStorageConfig, type UploadResponse, type ObjectInfo, type PresignedUrlResponse, type UploadOptions, type ListOptions, } from "./minio";
 export { AuthClient, getCurrentUserInfo, type AuthConfig, type UserInfo, };
 export { sdkConfig, VersionCompatibilityError, SDK_SIGNATURE } from "./config";
 /**

package/dist/index.js

@@ -20,7 +20,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_SIGNATURE = exports.VersionCompatibilityError = exports.sdkConfig = exports.getCurrentUserInfo = exports.AuthClient = exports.DownloadClient = exports.OpenAIVideoGenerationClient = exports.VideoGenerationClient = exports.GeminiImageGenerationClient = exports.DoubaoImageGenerationClient = exports.ChatAnthropic = exports.ChatGoogleGenerativeAI = exports.ChatOpenAI = exports.BaseChatModel = exports.AIMessageChunk = exports.SystemMessage = exports.AIMessage = exports.HumanMessage = void 0;
+exports.SDK_SIGNATURE = exports.VersionCompatibilityError = exports.sdkConfig = exports.getCurrentUserInfo = exports.AuthClient = exports.MinioStorageClient = exports.DownloadClient = exports.OpenAIVideoGenerationClient = exports.VideoGenerationClient = exports.GeminiImageGenerationClient = exports.DoubaoImageGenerationClient = exports.ChatAnthropic = exports.ChatGoogleGenerativeAI = exports.ChatOpenAI = exports.BaseChatModel = exports.AIMessageChunk = exports.SystemMessage = exports.AIMessage = exports.HumanMessage = void 0;
 exports.createChatModel = createChatModel;
 const openai_1 = require("./chat_models/openai");
 const google_1 = require("./chat_models/google");
@@ -53,6 +53,9 @@ var google_2 = require("./chat_models/google");
 Object.defineProperty(exports, "ChatGoogleGenerativeAI", { enumerable: true, get: function () { return google_2.ChatGoogleGenerativeAI; } });
 var anthropic_1 = require("./chat_models/anthropic");
 Object.defineProperty(exports, "ChatAnthropic", { enumerable: true, get: function () { return anthropic_1.ChatAnthropic; } });
+// Export MinIO storage client
+var minio_1 = require("./minio");
+Object.defineProperty(exports, "MinioStorageClient", { enumerable: true, get: function () { return minio_1.MinioStorageClient; } });
 // Export global configuration
 var config_2 = require("./config");
 Object.defineProperty(exports, "sdkConfig", { enumerable: true, get: function () { return config_2.sdkConfig; } });

package/dist/minio.d.ts

@@ -0,0 +1,156 @@
+/**
+ * MinIO Storage Client
+ * MinIO 对象存储客户端
+ * 通过后端 /api/minio 代理操作 MinIO 存储
+ */
+export interface MinioStorageConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+    pluginId?: string;
+}
+export interface UploadResponse {
+    path: string;
+    object_path: string;
+    size: number;
+    etag: string;
+    bucket: string;
+}
+export interface ObjectInfo {
+    name: string;
+    size?: number;
+    last_modified?: string;
+    etag?: string;
+    is_dir?: boolean;
+    content_type?: string;
+    metadata?: Record<string, string>;
+}
+export interface PresignedUrlResponse {
+    url: string;
+    expires_in: number;
+}
+export interface UploadOptions {
+    /** MIME content type */
+    contentType?: string;
+}
+export interface ListOptions {
+    /** 路径前缀过滤 */
+    prefix?: string;
+    /** 是否递归列出子目录，默认 true */
+    recursive?: boolean;
+}
+export interface PresignedUploadRequest {
+    path: string;
+    expires_in?: number;
+}
+/**
+ * MinIO Storage Client
+ * MinIO 对象存储客户端类
+ *
+ * @example
+ * ```typescript
+ * import { MinioStorageClient, sdkConfig } from 'ai-world-sdk';
+ *
+ * sdkConfig.setPluginId('my-plugin');
+ *
+ * const storage = new MinioStorageClient();
+ *
+ * // 上传文件
+ * const file = new File(['hello'], 'hello.txt', { type: 'text/plain' });
+ * const result = await storage.upload('docs/hello.txt', file);
+ *
+ * // 列出文件
+ * const files = await storage.list({ prefix: 'docs/' });
+ *
+ * // 下载文件
+ * const blob = await storage.download('docs/hello.txt');
+ *
+ * // 获取预签名 URL
+ * const { url } = await storage.getPresignedUrl('docs/hello.txt');
+ *
+ * // 删除文件
+ * await storage.delete('docs/hello.txt');
+ * ```
+ */
+export declare class MinioStorageClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: MinioStorageConfig);
+    /**
+     * 确保 X-Plugin-Id 已设置
+     */
+    private ensurePluginId;
+    /**
+     * 处理错误响应
+     */
+    private handleErrorResponse;
+    /**
+     * Upload a file to MinIO storage
+     * 上传文件到 MinIO 存储
+     *
+     * @param path - 存储路径（不含 userId/pluginId 前缀）
+     * @param file - 要上传的文件 (File, Blob, 或 Buffer)
+     * @param options - 上传选项
+     * @returns 上传结果
+     */
+    upload(path: string, file: File | Blob, options?: UploadOptions): Promise<UploadResponse>;
+    /**
+     * Download a file from MinIO storage
+     * 从 MinIO 存储下载文件
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @returns 文件 Blob
+     */
+    download(path: string): Promise<Blob>;
+    /**
+     * List files in MinIO storage
+     * 列出 MinIO 存储中的文件
+     *
+     * @param options - 列表选项（prefix, recursive）
+     * @returns 对象信息列表
+     */
+    list(options?: ListOptions): Promise<ObjectInfo[]>;
+    /**
+     * Delete a file from MinIO storage
+     * 从 MinIO 存储中删除文件
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     */
+    delete(path: string): Promise<void>;
+    /**
+     * Get a presigned download URL
+     * 获取预签名下载 URL
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @param expiresIn - 过期时间（秒），默认 3600
+     * @returns 预签名 URL 信息
+     */
+    getPresignedUrl(path: string, expiresIn?: number): Promise<PresignedUrlResponse>;
+    /**
+     * Get a presigned upload URL
+     * 获取预签名上传 URL
+     *
+     * 返回一个可直接上传文件的临时 URL，客户端可直接 PUT 文件到该 URL。
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @param expiresIn - 过期时间（秒），默认 3600
+     * @returns 预签名 URL 信息
+     */
+    getPresignedUploadUrl(path: string, expiresIn?: number): Promise<PresignedUrlResponse>;
+    /**
+     * Get file information/metadata
+     * 获取文件元信息
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @returns 对象信息
+     */
+    info(path: string): Promise<ObjectInfo>;
+    /**
+     * Download a file and trigger browser download
+     * 下载文件并触发浏览器下载
+     *
+     * @param path - 文件路径
+     * @param filename - 可选的下载文件名
+     */
+    downloadAsFile(path: string, filename?: string): Promise<void>;
+}

package/dist/minio.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * MinIO Storage Client
+ * MinIO 对象存储客户端
+ * 通过后端 /api/minio 代理操作 MinIO 存储
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinioStorageClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+// ==================== MinioStorageClient ====================
+/**
+ * MinIO Storage Client
+ * MinIO 对象存储客户端类
+ *
+ * @example
+ * ```typescript
+ * import { MinioStorageClient, sdkConfig } from 'ai-world-sdk';
+ *
+ * sdkConfig.setPluginId('my-plugin');
+ *
+ * const storage = new MinioStorageClient();
+ *
+ * // 上传文件
+ * const file = new File(['hello'], 'hello.txt', { type: 'text/plain' });
+ * const result = await storage.upload('docs/hello.txt', file);
+ *
+ * // 列出文件
+ * const files = await storage.list({ prefix: 'docs/' });
+ *
+ * // 下载文件
+ * const blob = await storage.download('docs/hello.txt');
+ *
+ * // 获取预签名 URL
+ * const { url } = await storage.getPresignedUrl('docs/hello.txt');
+ *
+ * // 删除文件
+ * await storage.delete('docs/hello.txt');
+ * ```
+ */
+class MinioStorageClient {
+    constructor(config = {}) {
+        // 使用配置的 baseUrl 或全局配置
+        this.baseUrl =
+            config.baseUrl ||
+                config_1.sdkConfig.getServerUrl() ||
+                (typeof window !== "undefined" ? window.location.origin : "");
+        // 合并 headers
+        const globalHeaders = config_1.sdkConfig.getHeaders();
+        const globalToken = config.token || config_1.sdkConfig.getToken();
+        this.headers = {
+            ...globalHeaders,
+            ...config.headers,
+        };
+        // 设置 plugin ID
+        const pluginId = config.pluginId || config_1.sdkConfig.getPluginId();
+        if (pluginId) {
+            this.headers["X-Plugin-Id"] = pluginId;
+        }
+        // 如果有 token，添加到 Authorization header
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    /**
+     * 确保 X-Plugin-Id 已设置
+     */
+    ensurePluginId() {
+        if (!this.headers["X-Plugin-Id"]) {
+            // 尝试从 sdkConfig 获取最新的 pluginId
+            const pluginId = config_1.sdkConfig.getPluginId();
+            if (pluginId) {
+                this.headers["X-Plugin-Id"] = pluginId;
+            }
+            else {
+                throw new Error("X-Plugin-Id is required. Set it via sdkConfig.setPluginId() or pass pluginId in MinioStorageConfig.");
+            }
+        }
+    }
+    /**
+     * 处理错误响应
+     */
+    async handleErrorResponse(response) {
+        let errorMessage = `Request failed: ${response.status} ${response.statusText}`;
+        try {
+            const errorText = await response.text();
+            const errorJson = JSON.parse(errorText);
+            errorMessage = errorJson.detail || errorMessage;
+        }
+        catch {
+            // 忽略解析错误
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * Upload a file to MinIO storage
+     * 上传文件到 MinIO 存储
+     *
+     * @param path - 存储路径（不含 userId/pluginId 前缀）
+     * @param file - 要上传的文件 (File, Blob, 或 Buffer)
+     * @param options - 上传选项
+     * @returns 上传结果
+     */
+    async upload(path, file, options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/minio/upload?path=${encodeURIComponent(path)}`;
+        const formData = new FormData();
+        // 如果是 File 对象，保留文件名；否则使用 path 中的文件名
+        const filename = file instanceof File ? file.name : path.split("/").pop() || "file";
+        formData.append("file", file, filename);
+        // FormData 请求不应该设置 Content-Type，浏览器会自动添加 boundary
+        const headers = { ...this.headers };
+        delete headers["Content-Type"];
+        (0, log_1.debugLog)("MinIO upload request:", { path, filename, size: file.size });
+        (0, log_1.logRequest)("POST", apiUrl, headers);
+        const response = await fetch(apiUrl, {
+            method: "POST",
+            headers,
+            body: formData,
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const result = (await response.json());
+        (0, log_1.debugLog)("MinIO upload response:", result);
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * Download a file from MinIO storage
+     * 从 MinIO 存储下载文件
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @returns 文件 Blob
+     */
+    async download(path) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/minio/download/${encodeURIComponent(path)}`;
+        (0, log_1.debugLog)("MinIO download request:", { path });
+        (0, log_1.logRequest)("GET", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "GET",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const blob = await response.blob();
+        (0, log_1.debugLog)("MinIO download completed:", { size: blob.size, type: blob.type });
+        return blob;
+    }
+    /**
+     * List files in MinIO storage
+     * 列出 MinIO 存储中的文件
+     *
+     * @param options - 列表选项（prefix, recursive）
+     * @returns 对象信息列表
+     */
+    async list(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const params = new URLSearchParams();
+        if (options.prefix) {
+            params.append("prefix", options.prefix);
+        }
+        if (options.recursive !== undefined) {
+            params.append("recursive", String(options.recursive));
+        }
+        const queryString = params.toString();
+        const apiUrl = `${this.baseUrl}/api/minio/list${queryString ? `?${queryString}` : ""}`;
+        (0, log_1.debugLog)("MinIO list request:", options);
+        (0, log_1.logRequest)("GET", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "GET",
+            headers: {
+                ...this.headers,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const result = (await response.json());
+        (0, log_1.debugLog)("MinIO list response:", { count: result.length });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * Delete a file from MinIO storage
+     * 从 MinIO 存储中删除文件
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     */
+    async delete(path) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/minio/delete/${encodeURIComponent(path)}`;
+        (0, log_1.debugLog)("MinIO delete request:", { path });
+        (0, log_1.logRequest)("DELETE", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        (0, log_1.debugLog)("MinIO delete completed:", { path });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, { path, deleted: true });
+    }
+    /**
+     * Get a presigned download URL
+     * 获取预签名下载 URL
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @param expiresIn - 过期时间（秒），默认 3600
+     * @returns 预签名 URL 信息
+     */
+    async getPresignedUrl(path, expiresIn = 3600) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/minio/presigned-url/${encodeURIComponent(path)}?expires_in=${expiresIn}`;
+        (0, log_1.debugLog)("MinIO presigned URL request:", { path, expiresIn });
+        (0, log_1.logRequest)("GET", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "GET",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const result = (await response.json());
+        (0, log_1.debugLog)("MinIO presigned URL response:", result);
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * Get a presigned upload URL
+     * 获取预签名上传 URL
+     *
+     * 返回一个可直接上传文件的临时 URL，客户端可直接 PUT 文件到该 URL。
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @param expiresIn - 过期时间（秒），默认 3600
+     * @returns 预签名 URL 信息
+     */
+    async getPresignedUploadUrl(path, expiresIn = 3600) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/minio/presigned-upload`;
+        const body = {
+            path,
+            expires_in: expiresIn,
+        };
+        (0, log_1.debugLog)("MinIO presigned upload URL request:", body);
+        (0, log_1.logRequest)("POST", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "POST",
+            headers: {
+                ...this.headers,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const result = (await response.json());
+        (0, log_1.debugLog)("MinIO presigned upload URL response:", result);
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * Get file information/metadata
+     * 获取文件元信息
+     *
+     * @param path - 文件路径（不含 userId/pluginId 前缀）
+     * @returns 对象信息
+     */
+    async info(path) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/minio/info/${encodeURIComponent(path)}`;
+        (0, log_1.debugLog)("MinIO info request:", { path });
+        (0, log_1.logRequest)("GET", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "GET",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const result = (await response.json());
+        (0, log_1.debugLog)("MinIO info response:", result);
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * Download a file and trigger browser download
+     * 下载文件并触发浏览器下载
+     *
+     * @param path - 文件路径
+     * @param filename - 可选的下载文件名
+     */
+    async downloadAsFile(path, filename) {
+        const blob = await this.download(path);
+        // 确定下载文件名
+        const downloadFilename = filename || path.split("/").pop() || "download";
+        // 创建下载链接
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement("a");
+        a.href = url;
+        a.download = downloadFilename;
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+        // 清理 URL
+        setTimeout(() => URL.revokeObjectURL(url), 100);
+    }
+}
+exports.MinioStorageClient = MinioStorageClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,9 @@
     "test:image-generation": "jest -t 'ImageGenerationClient - 基础图像生成'",
     "test:video-generation": "jest -t 'VideoGenerationClient - 轮询视频生成任务'",
     "test:llm": "jest --testPathPattern=llm.test.ts",
-    "test:llm-real": "jest --testPathPattern=llm.real.test.ts"
+    "test:llm-real": "jest --testPathPattern=llm.real.test.ts",
+    "test:minio": "jest --testPathPattern=minio.test.ts",
+    "test:minio-real": "jest -t 'MinIO Storage Tests'"
   },
   "keywords": [
     "ai-world",