ai-world-sdk 1.3.3 → 1.3.6

package/dist/shared-resource.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Shared Resource Client
+ * 平台级共享资源客户端（与 ResourceClient 的插件级 ACL 资源不同）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedResourceClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+class SharedResourceClient {
+    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 = {
+            "Content-Type": "application/json",
+            ...globalHeaders,
+            ...config.headers,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    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);
+    }
+    buildUrl(path, params) {
+        const url = `${this.baseUrl}${path}`;
+        if (!params)
+            return url;
+        const sp = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== null)
+                sp.append(k, String(v));
+        }
+        const qs = sp.toString();
+        return qs ? `${url}?${qs}` : url;
+    }
+    async list(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/shared-resources/", {
+            page: options.page,
+            page_size: options.pageSize,
+            search: options.search,
+            category: options.category,
+            tag: options.tag,
+        });
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        const result = (await response.json());
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    async get(resourceId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/shared-resources/${resourceId}`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        const result = (await response.json());
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
+    async upload(file, options) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/shared-resources/upload", {
+            name: options?.name,
+            description: options?.description,
+            tags: options?.tags,
+        });
+        const formData = new FormData();
+        formData.append("file", file);
+        const uploadHeaders = { ...this.headers };
+        delete uploadHeaders["Content-Type"];
+        (0, log_1.logRequest)("POST", url, uploadHeaders);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: uploadHeaders,
+            body: formData,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async update(resourceId, data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/shared-resources/${resourceId}`;
+        (0, log_1.logRequest)("PUT", url, this.headers);
+        const response = await fetch(url, {
+            method: "PUT",
+            headers: this.headers,
+            body: JSON.stringify(data),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async delete(resourceId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/shared-resources/${resourceId}`;
+        (0, log_1.logRequest)("DELETE", url, this.headers);
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async download(resourceId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/shared-resources/${resourceId}/download`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.blob();
+    }
+}
+exports.SharedResourceClient = SharedResourceClient;

package/dist/stats.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Stats Client & Dashboard Client
+ * 统计客户端（管理员）和 Dashboard 客户端（普通用户）
+ */
+export interface StatsClientConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+export interface AiApiCallsOptions {
+    userId?: number;
+    apiType?: string;
+    provider?: string;
+    model?: string;
+    pluginId?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface AiApiCallsTrendOptions {
+    period?: "daily" | "weekly" | "monthly";
+    days?: number;
+    userId?: number;
+    apiType?: string;
+    provider?: string;
+    model?: string;
+}
+export interface AiApiCallsTrendByUserOptions {
+    period?: "daily" | "weekly" | "monthly";
+    days?: number;
+    apiType?: string;
+    provider?: string;
+    model?: string;
+    limit?: number;
+}
+export interface PluginAccessOptions {
+    userId?: number;
+    pluginId?: string;
+    page?: number;
+    pageSize?: number;
+}
+export declare class StatsClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: StatsClientConfig);
+    private handleErrorResponse;
+    private buildUrl;
+    getAiApiCalls(options?: AiApiCallsOptions): Promise<any>;
+    getAiApiCallsSummary(): Promise<any>;
+    getAiApiCallsTrend(options?: AiApiCallsTrendOptions): Promise<any>;
+    getAiApiCallsTrendByUser(options?: AiApiCallsTrendByUserOptions): Promise<any>;
+    getPluginAccess(options?: PluginAccessOptions): Promise<any>;
+    getPluginAccessSummary(): Promise<any>;
+}
+export declare class DashboardClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: StatsClientConfig);
+    private handleErrorResponse;
+    getMyStats(): Promise<any>;
+}

package/dist/stats.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Stats Client & Dashboard Client
+ * 统计客户端（管理员）和 Dashboard 客户端（普通用户）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardClient = exports.StatsClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+class StatsClient {
+    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 = {
+            "Content-Type": "application/json",
+            ...globalHeaders,
+            ...config.headers,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    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);
+    }
+    buildUrl(path, params) {
+        const url = `${this.baseUrl}${path}`;
+        if (!params)
+            return url;
+        const sp = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== null)
+                sp.append(k, String(v));
+        }
+        const qs = sp.toString();
+        return qs ? `${url}?${qs}` : url;
+    }
+    // ==================== AI 接口调用统计（管理员） ====================
+    async getAiApiCalls(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/stats/ai-api-calls", {
+            user_id: options.userId,
+            api_type: options.apiType,
+            provider: options.provider,
+            model: options.model,
+            plugin_id: options.pluginId,
+            page: options.page,
+            page_size: options.pageSize,
+        });
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+    async getAiApiCallsSummary() {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/stats/ai-api-calls/summary`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+    async getAiApiCallsTrend(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/stats/ai-api-calls/trend", {
+            period: options.period,
+            days: options.days,
+            user_id: options.userId,
+            api_type: options.apiType,
+            provider: options.provider,
+            model: options.model,
+        });
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+    async getAiApiCallsTrendByUser(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/stats/ai-api-calls/trend/by-user", {
+            period: options.period,
+            days: options.days,
+            api_type: options.apiType,
+            provider: options.provider,
+            model: options.model,
+            limit: options.limit,
+        });
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+    // ==================== 插件访问统计（管理员） ====================
+    async getPluginAccess(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/stats/plugin-access", {
+            user_id: options.userId,
+            plugin_id: options.pluginId,
+            page: options.page,
+            page_size: options.pageSize,
+        });
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+    async getPluginAccessSummary() {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/stats/plugin-access/summary`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+}
+exports.StatsClient = StatsClient;
+// ==================== Dashboard Client ====================
+class DashboardClient {
+    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 = {
+            "Content-Type": "application/json",
+            ...globalHeaders,
+            ...config.headers,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    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);
+    }
+    async getMyStats() {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/dashboard/my-stats`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+}
+exports.DashboardClient = DashboardClient;

package/dist/versioned-resource.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端
+ * 通过后端 /api/versioned-resources 操作版本化资源系统
+ * 资源名称为全局唯一标识，支持语义化版本号管理
+ */
+export interface VersionedResourceClientConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+export interface VersionedResourceInfo {
+    id: number;
+    name: string;
+    version: string;
+    description?: string;
+    filename: string;
+    size: number;
+    content_type: string;
+    uploader_id: number;
+    uploader_name?: string;
+    created_at: string;
+}
+export interface VersionedResourceSummary {
+    name: string;
+    latest_version: string;
+    description?: string;
+    filename: string;
+    size: number;
+    content_type: string;
+    version_count: number;
+    latest_uploader_name?: string;
+    created_at: string;
+}
+export interface VersionedResourceListResponse {
+    items: VersionedResourceSummary[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface ListVersionedResourceOptions {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+}
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { VersionedResourceClient } from 'ai-world-sdk';
+ *
+ * const vr = new VersionedResourceClient();
+ *
+ * // 上传新版本
+ * const file = new File(['content'], 'config.json', { type: 'application/json' });
+ * const res = await vr.upload('my-config', '1.0.0', file, '初始版本');
+ *
+ * // 获取最新版本
+ * const latest = await vr.getLatest('my-config');
+ *
+ * // 列出所有版本
+ * const versions = await vr.listVersions('my-config');
+ *
+ * // 下载指定版本
+ * const blob = await vr.download('my-config', '1.0.0');
+ *
+ * // 下载最新版本
+ * const latestBlob = await vr.download('my-config', 'latest');
+ * ```
+ */
+export declare class VersionedResourceClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: VersionedResourceClientConfig);
+    private handleErrorResponse;
+    /**
+     * 上传新版本
+     * @param name 资源名称（全局唯一标识）
+     * @param version 语义化版本号（必须高于当前最新版本）
+     * @param file 文件
+     * @param description 可选的版本描述
+     */
+    upload(name: string, version: string, file: File | Blob, description?: string): Promise<VersionedResourceInfo>;
+    /**
+     * 分页列出所有版本化资源（聚合最新版本信息）
+     */
+    list(options?: ListVersionedResourceOptions): Promise<VersionedResourceListResponse>;
+    /**
+     * 列出指定资源的所有版本（按版本号降序）
+     */
+    listVersions(name: string): Promise<VersionedResourceInfo[]>;
+    /**
+     * 获取指定资源的最新版本信息
+     */
+    getLatest(name: string): Promise<VersionedResourceInfo>;
+    /**
+     * 获取指定版本信息
+     */
+    getVersion(name: string, version: string): Promise<VersionedResourceInfo>;
+    /**
+     * 下载指定版本文件（version 可传 "latest" 下载最新版本）
+     */
+    download(name: string, version: string): Promise<Blob>;
+    /**
+     * 删除指定版本
+     */
+    deleteVersion(name: string, version: string): Promise<{
+        name: string;
+        version: string;
+        deleted: boolean;
+    }>;
+}

package/dist/versioned-resource.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端
+ * 通过后端 /api/versioned-resources 操作版本化资源系统
+ * 资源名称为全局唯一标识，支持语义化版本号管理
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionedResourceClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+// ==================== VersionedResourceClient ====================
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { VersionedResourceClient } from 'ai-world-sdk';
+ *
+ * const vr = new VersionedResourceClient();
+ *
+ * // 上传新版本
+ * const file = new File(['content'], 'config.json', { type: 'application/json' });
+ * const res = await vr.upload('my-config', '1.0.0', file, '初始版本');
+ *
+ * // 获取最新版本
+ * const latest = await vr.getLatest('my-config');
+ *
+ * // 列出所有版本
+ * const versions = await vr.listVersions('my-config');
+ *
+ * // 下载指定版本
+ * const blob = await vr.download('my-config', '1.0.0');
+ *
+ * // 下载最新版本
+ * const latestBlob = await vr.download('my-config', 'latest');
+ * ```
+ */
+class VersionedResourceClient {
+    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,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    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);
+    }
+    /**
+     * 上传新版本
+     * @param name 资源名称（全局唯一标识）
+     * @param version 语义化版本号（必须高于当前最新版本）
+     * @param file 文件
+     * @param description 可选的版本描述
+     */
+    async upload(name, version, file, description) {
+        const params = new URLSearchParams();
+        params.append("name", name);
+        params.append("version", version);
+        if (description)
+            params.append("description", description);
+        const url = `${this.baseUrl}/api/versioned-resources/upload?${params.toString()}`;
+        const formData = new FormData();
+        formData.append("file", file);
+        (0, log_1.debugLog)("VersionedResource", `Uploading ${name}@${version}`);
+        (0, log_1.logRequest)("POST", url);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                ...this.headers,
+            },
+            body: formData,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 分页列出所有版本化资源（聚合最新版本信息）
+     */
+    async list(options = {}) {
+        const params = new URLSearchParams();
+        if (options.page)
+            params.append("page", options.page.toString());
+        if (options.pageSize)
+            params.append("page_size", options.pageSize.toString());
+        if (options.search)
+            params.append("search", options.search);
+        const url = `${this.baseUrl}/api/versioned-resources/?${params.toString()}`;
+        (0, log_1.debugLog)("VersionedResource", `Listing resources`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 列出指定资源的所有版本（按版本号降序）
+     */
+    async listVersions(name) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/versions`;
+        (0, log_1.debugLog)("VersionedResource", `Listing versions of ${name}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 获取指定资源的最新版本信息
+     */
+    async getLatest(name) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/latest`;
+        (0, log_1.debugLog)("VersionedResource", `Getting latest version of ${name}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 获取指定版本信息
+     */
+    async getVersion(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}`;
+        (0, log_1.debugLog)("VersionedResource", `Getting ${name}@${version}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 下载指定版本文件（version 可传 "latest" 下载最新版本）
+     */
+    async download(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}/download`;
+        (0, log_1.debugLog)("VersionedResource", `Downloading ${name}@${version}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.blob();
+    }
+    /**
+     * 删除指定版本
+     */
+    async deleteVersion(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}`;
+        (0, log_1.debugLog)("VersionedResource", `Deleting ${name}@${version}`);
+        (0, log_1.logRequest)("DELETE", url);
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+}
+exports.VersionedResourceClient = VersionedResourceClient;

package/package.json

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