ai-world-sdk 1.2.0 → 1.2.2

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.0",
+  "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",
@@ -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",