ai-world-sdk 1.2.1 → 1.2.2

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

@@ -0,0 +1,8 @@
+/**
+ * ResourceClient 集成测试
+ * 使用真实 SDK 调用后端 /api/resources 接口
+ * 需要后端运行 + MinIO 服务 + 数据库可用
+ *
+ * 运行: npx jest --testPathPattern=resource.test.ts
+ */
+export {};

package/dist/__tests__/resource.test.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * ResourceClient 集成测试
+ * 使用真实 SDK 调用后端 /api/resources 接口
+ * 需要后端运行 + MinIO 服务 + 数据库可用
+ *
+ * 运行: npx jest --testPathPattern=resource.test.ts
+ */
+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("ResourceClient 测试", () => {
+    let client;
+    let uploadedResourceId;
+    beforeAll(() => {
+        index_1.sdkConfig.setPluginId(PLUGIN_ID);
+        client = new index_1.ResourceClient();
+    });
+    // ==================== 上传 ====================
+    test("上传资源 - 默认 private", async () => {
+        const content = "Resource test content: " + Date.now();
+        const blob = new Blob([content], { type: "text/plain" });
+        const file = new File([blob], "resource-test.txt", { type: "text/plain" });
+        const result = await client.upload("test/resource-test.txt", file);
+        expect(result).toBeDefined();
+        expect(result.id).toBeDefined();
+        expect(result.path).toBe("test/resource-test.txt");
+        expect(result.access_level).toBe("private");
+        expect(result.owner_id).toBeDefined();
+        expect(result.plugin_id).toBe(PLUGIN_ID);
+        expect(result.size).toBeGreaterThan(0);
+        uploadedResourceId = result.id;
+        console.log("上传成功:", result);
+    }, 30000);
+    test("上传资源 - public 带描述", async () => {
+        const blob = new Blob(["public content"], { type: "text/plain" });
+        const file = new File([blob], "public-file.txt", { type: "text/plain" });
+        const result = await client.upload("test/public-file.txt", file, {
+            accessLevel: "public",
+            description: "公开测试文件",
+        });
+        expect(result).toBeDefined();
+        expect(result.access_level).toBe("public");
+        expect(result.description).toBe("公开测试文件");
+        console.log("公开资源上传成功:", result);
+    }, 30000);
+    // ==================== 列表 ====================
+    test("列出我的资源", async () => {
+        const resources = await client.listMy();
+        expect(resources).toBeDefined();
+        expect(Array.isArray(resources)).toBe(true);
+        expect(resources.length).toBeGreaterThan(0);
+        const testFile = resources.find((r) => r.path === "test/resource-test.txt");
+        expect(testFile).toBeDefined();
+        console.log(`我的资源 (${resources.length} 个):`, resources.map((r) => r.path));
+    }, 30000);
+    test("列出公开资源", async () => {
+        const resources = await client.listPublic();
+        expect(resources).toBeDefined();
+        expect(Array.isArray(resources)).toBe(true);
+        const publicFile = resources.find((r) => r.path === "test/public-file.txt");
+        expect(publicFile).toBeDefined();
+        console.log(`公开资源 (${resources.length} 个):`, resources.map((r) => r.path));
+    }, 30000);
+    // ==================== 获取详情 ====================
+    test("获取资源详情", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        const info = await client.getInfo(uploadedResourceId);
+        expect(info).toBeDefined();
+        expect(info.id).toBe(uploadedResourceId);
+        expect(info.path).toBe("test/resource-test.txt");
+        expect(info.filename).toBe("resource-test.txt");
+        console.log("资源详情:", info);
+    }, 30000);
+    // ==================== 修改权限 ====================
+    test("修改访问级别为 public", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        const updated = await client.updateAccess(uploadedResourceId, "public");
+        expect(updated).toBeDefined();
+        expect(updated.access_level).toBe("public");
+        console.log("访问级别已更新:", updated.access_level);
+    }, 30000);
+    test("修改访问级别为 specific_users", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        const updated = await client.updateAccess(uploadedResourceId, "specific_users");
+        expect(updated).toBeDefined();
+        expect(updated.access_level).toBe("specific_users");
+        console.log("访问级别已更新:", updated.access_level);
+    }, 30000);
+    // ==================== 批量分享 ====================
+    test("批量添加分享 - 单个用户", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        const result = await client.addShare(uploadedResourceId, 99);
+        expect(result).toBeDefined();
+        expect(result.resource_id).toBe(uploadedResourceId);
+        expect(result.total_requested).toBe(1);
+        console.log("批量添加分享（单个）:", result);
+    }, 30000);
+    test("批量添加分享 - 多个用户", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        const result = await client.addShare(uploadedResourceId, [100, 101]);
+        expect(result).toBeDefined();
+        expect(result.total_requested).toBe(2);
+        console.log("批量添加分享（多个）:", result);
+    }, 30000);
+    test("批量移除分享 - 多个用户", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        const result = await client.removeShare(uploadedResourceId, [99, 100, 101]);
+        expect(result).toBeDefined();
+        expect(result.total_requested).toBe(3);
+        console.log("批量移除分享:", result);
+    }, 30000);
+    // ==================== 下载 ====================
+    test("通过资源 ID 下载", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        // 先改回 private 验证 owner 仍可下载
+        await client.updateAccess(uploadedResourceId, "private");
+        const blob = await client.download(uploadedResourceId);
+        expect(blob).toBeDefined();
+        expect(blob.size).toBeGreaterThan(0);
+        console.log("下载成功, 大小:", blob.size);
+    }, 30000);
+    // ==================== 列出被分享的 ====================
+    test("列出被分享给我的资源", async () => {
+        const resources = await client.listSharedWithMe();
+        expect(resources).toBeDefined();
+        expect(Array.isArray(resources)).toBe(true);
+        console.log(`被分享资源 (${resources.length} 个)`);
+    }, 30000);
+    // ==================== 跨插件 ====================
+    test("列出我的资源 - 跨插件", async () => {
+        const resources = await client.listMy({ crossPlugin: true });
+        expect(resources).toBeDefined();
+        expect(Array.isArray(resources)).toBe(true);
+        console.log(`跨插件资源 (${resources.length} 个)`);
+    }, 30000);
+    // ==================== 删除 ====================
+    test("删除资源", async () => {
+        expect(uploadedResourceId).toBeDefined();
+        await client.delete(uploadedResourceId);
+        console.log("资源已删除:", uploadedResourceId);
+        // 验证已删除
+        try {
+            await client.getInfo(uploadedResourceId);
+            fail("应该抛出错误");
+        }
+        catch (e) {
+            expect(e.message).toContain("404");
+        }
+    }, 30000);
+    // 清理 public-file
+    test("清理测试资源", async () => {
+        const resources = await client.listMy();
+        const publicFile = resources.find((r) => r.path === "test/public-file.txt");
+        if (publicFile) {
+            await client.delete(publicFile.id);
+            console.log("清理 public-file:", publicFile.id);
+        }
+    }, 30000);
+    // ==================== 插件 ID 验证 ====================
+    test("缺少 pluginId 时抛出错误", () => {
+        const originalPluginId = index_1.sdkConfig.getPluginId();
+        index_1.sdkConfig.setPluginId("");
+        const badClient = new index_1.ResourceClient();
+        expect(() => {
+            badClient.ensurePluginId();
+        }).toThrow("X-Plugin-Id is required");
+        index_1.sdkConfig.setPluginId(originalPluginId || PLUGIN_ID);
+    });
+});

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.1";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.2";
 /**
  * 版本兼容性错误
  */
@@ -24,8 +24,8 @@ declare class SDKConfig {
     private _pluginId;
     private _versionCompatible;
     private _versionCheckPromise;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.2.1";
-    readonly sdkVersion = "1.2.1";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.2.2";
+    readonly sdkVersion = "1.2.2";
     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.1";
+const SDK_VERSION = "1.2.2";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.2.1";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.1";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.2.2";
 /**
  * 版本兼容性错误
  */

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export { VideoGenerationClient, type VideoGenerationConfig, type VideoGeneration
 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 { ResourceClient, type ResourceClientConfig, type ResourceInfo, type AccessLevel, type UploadResourceOptions, type ListResourceOptions, } from "./resource";
 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.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.SDK_SIGNATURE = exports.VersionCompatibilityError = exports.sdkConfig = exports.getCurrentUserInfo = exports.AuthClient = exports.ResourceClient = 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");
@@ -56,6 +56,9 @@ Object.defineProperty(exports, "ChatAnthropic", { enumerable: true, get: functio
 // Export MinIO storage client
 var minio_1 = require("./minio");
 Object.defineProperty(exports, "MinioStorageClient", { enumerable: true, get: function () { return minio_1.MinioStorageClient; } });
+// Export resource management client
+var resource_1 = require("./resource");
+Object.defineProperty(exports, "ResourceClient", { enumerable: true, get: function () { return resource_1.ResourceClient; } });
 // Export global configuration
 var config_2 = require("./config");
 Object.defineProperty(exports, "sdkConfig", { enumerable: true, get: function () { return config_2.sdkConfig; } });

package/dist/resource.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Resource Client
+ * 资源管理客户端
+ * 通过后端 /api/resources 代理操作资源管理系统
+ * 支持 private / specific_users / public 三级访问控制，默认按 plugin_id 隔离
+ */
+export interface ResourceClientConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+    pluginId?: string;
+}
+export type AccessLevel = "private" | "specific_users" | "public";
+export interface ResourceInfo {
+    id: number;
+    owner_id: number;
+    plugin_id: string;
+    path: string;
+    object_path: string;
+    filename: string;
+    size: number;
+    content_type: string;
+    access_level: AccessLevel;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+    shared_users?: number[];
+}
+export interface UploadResourceOptions {
+    accessLevel?: AccessLevel;
+    description?: string;
+    contentType?: string;
+}
+export interface ListResourceOptions {
+    crossPlugin?: boolean;
+}
+/**
+ * Resource Client
+ * 资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { ResourceClient, sdkConfig } from 'ai-world-sdk';
+ *
+ * sdkConfig.setPluginId('my-plugin');
+ * const resources = new ResourceClient();
+ *
+ * // 上传并设为公开
+ * const file = new File(['hello'], 'hello.txt', { type: 'text/plain' });
+ * const res = await resources.upload('docs/hello.txt', file, { accessLevel: 'public' });
+ *
+ * // 列出我的资源
+ * const myFiles = await resources.listMy();
+ *
+ * // 查看某用户的公开资源
+ * const userFiles = await resources.listByUser(42);
+ *
+ * // 分享给指定用户
+ * await resources.addShare(res.id, 99);
+ *
+ * // 通过 userId + path 下载
+ * const blob = await resources.downloadByUser(42, 'docs/hello.txt');
+ * ```
+ */
+export declare class ResourceClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: ResourceClientConfig);
+    private ensurePluginId;
+    private handleErrorResponse;
+    /**
+     * 上传文件并创建资源记录
+     */
+    upload(path: string, file: File | Blob, options?: UploadResourceOptions): Promise<ResourceInfo>;
+    /**
+     * 列出当前用户的资源
+     */
+    listMy(options?: ListResourceOptions): Promise<ResourceInfo[]>;
+    /**
+     * 获取资源详情
+     */
+    getInfo(resourceId: number): Promise<ResourceInfo>;
+    /**
+     * 修改资源访问级别
+     */
+    updateAccess(resourceId: number, accessLevel: AccessLevel): Promise<ResourceInfo>;
+    /**
+     * 批量添加用户的访问授权
+     *
+     * @param resourceId - 资源 ID
+     * @param userIds - 被授权用户 ID 列表（支持单个或多个）
+     */
+    addShare(resourceId: number, userIds: number | number[]): Promise<{
+        resource_id: number;
+        added_user_ids: number[];
+        total_requested: number;
+    }>;
+    /**
+     * 批量移除用户的访问授权
+     *
+     * @param resourceId - 资源 ID
+     * @param userIds - 要移除授权的用户 ID 列表（支持单个或多个）
+     */
+    removeShare(resourceId: number, userIds: number | number[]): Promise<{
+        resource_id: number;
+        removed_user_ids: number[];
+        total_requested: number;
+    }>;
+    /**
+     * 通过资源 ID 下载
+     */
+    download(resourceId: number): Promise<Blob>;
+    /**
+     * 删除资源
+     */
+    delete(resourceId: number): Promise<void>;
+    /**
+     * 列出指定用户的可访问资源
+     */
+    listByUser(userId: number, options?: ListResourceOptions): Promise<ResourceInfo[]>;
+    /**
+     * 通过 userId + path 下载资源
+     */
+    downloadByUser(userId: number, path: string, pluginId?: string): Promise<Blob>;
+    /**
+     * 列出被分享给当前用户的资源
+     */
+    listSharedWithMe(options?: ListResourceOptions): Promise<ResourceInfo[]>;
+    /**
+     * 列出所有 public 资源
+     */
+    listPublic(options?: ListResourceOptions): Promise<ResourceInfo[]>;
+    /**
+     * 下载资源并触发浏览器下载
+     */
+    downloadAsFile(resourceId: number, filename?: string): Promise<void>;
+}

package/dist/resource.js

@@ -0,0 +1,390 @@
+"use strict";
+/**
+ * Resource Client
+ * 资源管理客户端
+ * 通过后端 /api/resources 代理操作资源管理系统
+ * 支持 private / specific_users / public 三级访问控制，默认按 plugin_id 隔离
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+// ==================== ResourceClient ====================
+/**
+ * Resource Client
+ * 资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { ResourceClient, sdkConfig } from 'ai-world-sdk';
+ *
+ * sdkConfig.setPluginId('my-plugin');
+ * const resources = new ResourceClient();
+ *
+ * // 上传并设为公开
+ * const file = new File(['hello'], 'hello.txt', { type: 'text/plain' });
+ * const res = await resources.upload('docs/hello.txt', file, { accessLevel: 'public' });
+ *
+ * // 列出我的资源
+ * const myFiles = await resources.listMy();
+ *
+ * // 查看某用户的公开资源
+ * const userFiles = await resources.listByUser(42);
+ *
+ * // 分享给指定用户
+ * await resources.addShare(res.id, 99);
+ *
+ * // 通过 userId + path 下载
+ * const blob = await resources.downloadByUser(42, 'docs/hello.txt');
+ * ```
+ */
+class ResourceClient {
+    constructor(config = {}) {
+        this.baseUrl =
+            config.baseUrl ||
+                config_1.sdkConfig.getServerUrl() ||
+                (typeof window !== "undefined" ? window.location.origin : "");
+        const globalHeaders = config_1.sdkConfig.getHeaders();
+        const globalToken = config.token || config_1.sdkConfig.getToken();
+        this.headers = {
+            ...globalHeaders,
+            ...config.headers,
+        };
+        const pluginId = config.pluginId || config_1.sdkConfig.getPluginId();
+        if (pluginId) {
+            this.headers["X-Plugin-Id"] = pluginId;
+        }
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    ensurePluginId() {
+        if (!this.headers["X-Plugin-Id"]) {
+            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 ResourceClientConfig.");
+            }
+        }
+    }
+    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 {
+            // ignore parse error
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * 上传文件并创建资源记录
+     */
+    async upload(path, file, options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const params = new URLSearchParams();
+        params.append("path", path);
+        if (options.accessLevel) {
+            params.append("access_level", options.accessLevel);
+        }
+        if (options.description) {
+            params.append("description", options.description);
+        }
+        const apiUrl = `${this.baseUrl}/api/resources/upload?${params.toString()}`;
+        const formData = new FormData();
+        const filename = file instanceof File ? file.name : path.split("/").pop() || "file";
+        formData.append("file", file, filename);
+        const headers = { ...this.headers };
+        delete headers["Content-Type"];
+        (0, log_1.debugLog)("Resource upload request:", { path, options });
+        (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)("Resource upload response:", result);
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * 列出当前用户的资源
+     */
+    async listMy(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const params = new URLSearchParams();
+        if (options.crossPlugin)
+            params.append("cross_plugin", "true");
+        const apiUrl = `${this.baseUrl}/api/resources/my?${params.toString()}`;
+        (0, log_1.debugLog)("Resource listMy request:", options);
+        (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)("Resource listMy response:", { count: result.length });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * 获取资源详情
+     */
+    async getInfo(resourceId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/resources/${resourceId}`;
+        (0, log_1.debugLog)("Resource getInfo request:", { resourceId });
+        (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)("Resource getInfo response:", result);
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * 修改资源访问级别
+     */
+    async updateAccess(resourceId, accessLevel) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/resources/${resourceId}/access`;
+        (0, log_1.debugLog)("Resource updateAccess request:", { resourceId, accessLevel });
+        (0, log_1.logRequest)("PATCH", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "PATCH",
+            headers: {
+                ...this.headers,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ access_level: accessLevel }),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        const result = (await response.json());
+        (0, log_1.debugLog)("Resource updateAccess response:", result);
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * 批量添加用户的访问授权
+     *
+     * @param resourceId - 资源 ID
+     * @param userIds - 被授权用户 ID 列表（支持单个或多个）
+     */
+    async addShare(resourceId, userIds) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const ids = Array.isArray(userIds) ? userIds : [userIds];
+        const apiUrl = `${this.baseUrl}/api/resources/${resourceId}/share`;
+        (0, log_1.debugLog)("Resource addShare request:", { resourceId, userIds: ids });
+        (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({ user_ids: ids }),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        const result = await response.json();
+        (0, log_1.debugLog)("Resource addShare completed:", result);
+        return result;
+    }
+    /**
+     * 批量移除用户的访问授权
+     *
+     * @param resourceId - 资源 ID
+     * @param userIds - 要移除授权的用户 ID 列表（支持单个或多个）
+     */
+    async removeShare(resourceId, userIds) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const ids = Array.isArray(userIds) ? userIds : [userIds];
+        const apiUrl = `${this.baseUrl}/api/resources/${resourceId}/unshare`;
+        (0, log_1.debugLog)("Resource removeShare request:", { resourceId, userIds: ids });
+        (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({ user_ids: ids }),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        const result = await response.json();
+        (0, log_1.debugLog)("Resource removeShare completed:", result);
+        return result;
+    }
+    /**
+     * 通过资源 ID 下载
+     */
+    async download(resourceId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/resources/${resourceId}/download`;
+        (0, log_1.debugLog)("Resource download request:", { resourceId });
+        (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)("Resource download completed:", {
+            size: blob.size,
+            type: blob.type,
+        });
+        return blob;
+    }
+    /**
+     * 删除资源
+     */
+    async delete(resourceId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const apiUrl = `${this.baseUrl}/api/resources/${resourceId}`;
+        (0, log_1.debugLog)("Resource delete request:", { resourceId });
+        (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)("Resource delete completed:", { resourceId });
+    }
+    /**
+     * 列出指定用户的可访问资源
+     */
+    async listByUser(userId, options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const params = new URLSearchParams();
+        if (options.crossPlugin)
+            params.append("cross_plugin", "true");
+        const apiUrl = `${this.baseUrl}/api/resources/user/${userId}?${params.toString()}`;
+        (0, log_1.debugLog)("Resource listByUser request:", { userId, options });
+        (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)("Resource listByUser response:", { count: result.length });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * 通过 userId + path 下载资源
+     */
+    async downloadByUser(userId, path, pluginId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const params = new URLSearchParams();
+        if (pluginId)
+            params.append("plugin_id", pluginId);
+        const queryStr = params.toString();
+        const apiUrl = `${this.baseUrl}/api/resources/user/${userId}/download/${encodeURIComponent(path)}${queryStr ? `?${queryStr}` : ""}`;
+        (0, log_1.debugLog)("Resource downloadByUser request:", { userId, path, pluginId });
+        (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)("Resource downloadByUser completed:", {
+            size: blob.size,
+            type: blob.type,
+        });
+        return blob;
+    }
+    /**
+     * 列出被分享给当前用户的资源
+     */
+    async listSharedWithMe(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const params = new URLSearchParams();
+        if (options.crossPlugin)
+            params.append("cross_plugin", "true");
+        const apiUrl = `${this.baseUrl}/api/resources/shared-with-me?${params.toString()}`;
+        (0, log_1.debugLog)("Resource listSharedWithMe request:", options);
+        (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)("Resource listSharedWithMe response:", { count: result.length });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * 列出所有 public 资源
+     */
+    async listPublic(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        this.ensurePluginId();
+        const params = new URLSearchParams();
+        if (options.crossPlugin)
+            params.append("cross_plugin", "true");
+        const apiUrl = `${this.baseUrl}/api/resources/public?${params.toString()}`;
+        (0, log_1.debugLog)("Resource listPublic request:", options);
+        (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)("Resource listPublic response:", { count: result.length });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    /**
+     * 下载资源并触发浏览器下载
+     */
+    async downloadAsFile(resourceId, filename) {
+        const blob = await this.download(resourceId);
+        const downloadFilename = filename || "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);
+        setTimeout(() => URL.revokeObjectURL(url), 100);
+    }
+}
+exports.ResourceClient = ResourceClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",