ai-world-sdk 1.2.0 → 1.2.2

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/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>;
+}