@tacoreai/web-sdk 1.0.12 → 1.3.0

package/database/core/apps/AppsClient.KnowledgeBase.js

@@ -0,0 +1,130 @@
+export const appsClientKnowledgeBaseMethods = {
+  // ==================== Knowledge Base (RAG) ====================
+
+  /**
+   * 创建 Knowledge Base Data Store
+   * @param {Object} params
+   * @param {string} params.storeId - Data Store ID
+   * @param {string} params.displayName - 显示名称
+   * @param {string} [params.provider='google'] - 提供商 (google, aliyun)
+   * @returns {Promise<Object>} 创建结果
+   */
+  async createKnowledgeBaseDataStore({ storeId, displayName, provider = "google" }) {
+    if (!storeId || !displayName) {
+      throw new Error("storeId and displayName are required.");
+    }
+    return this._post("/apps/knowledge-base/dataStore", { storeId, displayName, provider });
+  },
+
+  /**
+   * 删除 Knowledge Base Data Store
+   * @param {string} storeId
+   * @param {string} [provider='google']
+   * @returns {Promise<Object>} 删除结果
+   */
+  async deleteKnowledgeBaseDataStore(storeId, provider = "google") {
+    if (!storeId) {
+      throw new Error("storeId is required.");
+    }
+    return this._delete(`/apps/knowledge-base/dataStore/${storeId}`, { provider });
+  },
+
+  /**
+   * 获取 Knowledge Base Data Store 详情
+   * @param {string} storeId
+   * @param {string} [provider='google']
+   * @returns {Promise<Object>} Data Store 详情
+   */
+  async getKnowledgeBaseDataStore(storeId, provider = "google") {
+    if (!storeId) {
+      throw new Error("storeId is required.");
+    }
+    return this._get(`/apps/knowledge-base/dataStore/${storeId}`, { provider });
+  },
+
+  /**
+   * 列出所有 Knowledge Base Data Stores
+   * @param {string} [provider='google']
+   * @returns {Promise<Object>} Data Store 列表
+   */
+  async listKnowledgeBaseDataStores(provider = "google") {
+    return this._get("/apps/knowledge-base/dataStore", { provider });
+  },
+
+  /**
+   * 导入文档到 Knowledge Base Data Store
+   * @param {Object} params
+   * @param {string} params.storeId - 目标 Data Store ID
+   * @param {string} params.sourceUri - 源 URI
+   * @param {string} [params.provider='google']
+   * @returns {Promise<Object>} 导入操作信息
+   */
+  async importKnowledgeBaseDocuments({ storeId, sourceUri, provider = "google" }) {
+    if (!storeId || !sourceUri) {
+      throw new Error("storeId and sourceUri are required.");
+    }
+    return this._post("/apps/knowledge-base/dataStore/import", { storeId, sourceUri, provider });
+  },
+
+  /**
+   * 获取 Knowledge Base 文档列表
+   * @param {string} storeId
+   * @param {string} pageToken
+   * @param {number} pageSize
+   * @param {string} provider
+   */
+  async listKnowledgeBaseDocuments(storeId, pageToken = "", pageSize = 10, provider = "google") {
+    return this._get(`/apps/knowledge-base/dataStore/${storeId}/documents`, {
+      pageToken,
+      pageSize,
+      provider,
+    });
+  },
+
+  /**
+   * 删除 Knowledge Base 文档
+   * @param {string} storeId
+   * @param {string} documentId
+   * @param {string} provider
+   */
+  async deleteKnowledgeBaseDocument(storeId, documentId, provider = "google") {
+    return this._delete(`/apps/knowledge-base/dataStore/${storeId}/documents/${documentId}`, { provider });
+  },
+
+  // ==================== Deprecated Vertex AI Aliases ====================
+
+  /**
+   * @deprecated Use createKnowledgeBaseDataStore
+   */
+  async createVertexDataStore({ dataStoreId, displayName }) {
+    return this.createKnowledgeBaseDataStore({ storeId: dataStoreId, displayName, provider: "google" });
+  },
+
+  /**
+   * @deprecated Use deleteKnowledgeBaseDataStore
+   */
+  async deleteVertexDataStore(dataStoreId) {
+    return this.deleteKnowledgeBaseDataStore(dataStoreId, "google");
+  },
+
+  /**
+   * @deprecated Use getKnowledgeBaseDataStore
+   */
+  async getVertexDataStore(dataStoreId) {
+    return this.getKnowledgeBaseDataStore(dataStoreId, "google");
+  },
+
+  /**
+   * @deprecated Use listKnowledgeBaseDataStores
+   */
+  async listVertexDataStores() {
+    return this.listKnowledgeBaseDataStores("google");
+  },
+
+  /**
+   * @deprecated Use importKnowledgeBaseDocuments
+   */
+  async importVertexDocuments({ dataStoreId, gcsUri }) {
+    return this.importKnowledgeBaseDocuments({ storeId: dataStoreId, sourceUri: gcsUri, provider: "google" });
+  },
+};

package/database/core/apps/AppsClient.Message.js

@@ -0,0 +1,27 @@
+export const appsClientMessageMethods = {
+  // ==================== [新增] 统一消息服务 ====================
+
+  /**
+   * 发送消息（统一接口）
+   * 支持多种 Provider (email, sms, wechat 等)
+   *
+   * @param {object} options
+   * @param {string} options.provider - 渠道标识: 'email' | 'sms' | 'wechat' ...
+   * @param {object} options.data - 消息数据，根据 provider 不同而不同
+   * @returns {Promise<{success: boolean, data: any}>}
+   */
+  async sendMessage({ provider, data }) {
+    if (!provider) {
+      throw new Error("provider is required for sendMessage.");
+    }
+    if (!data || typeof data !== "object") {
+      throw new Error("data object is required for sendMessage.");
+    }
+
+    return this._post("/apps/message/send", {
+      appId: this.appId,
+      provider,
+      data,
+    });
+  },
+};

package/database/core/apps/AppsClient.Realtime.js

@@ -0,0 +1,46 @@
+export const appsClientRealtimeMethods = {
+  // ==================== 实时数据接口 (高频/本地) ====================
+
+  /**
+   * 发布（写入）一条新的实时数据。
+   * 强制规则：此方法仅在客户端本地通过内部事件总线工作，永远不会将数据发送到云端。
+   * 这是为了保护云端数据库免受高频写入的影响。
+   * @param {string} modelName - 数据模型的名称。
+   * @param {Object} data - 要发布的数据。
+   */
+  publishRealtimeData(modelName, data) {
+    const listeners = this.subscribers.get(modelName);
+    if (listeners) {
+      listeners.forEach(callback => {
+        try {
+          callback(data);
+        } catch (e) {
+          console.error("Error in realtime data subscriber:", e);
+        }
+      });
+    }
+  },
+
+  /**
+   * 订阅指定模型的数据流。
+   * 强制规则：此方法仅订阅来自客户端本地的数据流。
+   * @param {string} modelName - 要订阅的数据模型的名称。
+   * @param {Function} callback - 接收新数据的回调函数。
+   * @returns {Function} 一个 unsubscribe 函数，用于取消订阅。
+   */
+  subscribeToRealtimeData(modelName, callback) {
+    if (!this.subscribers.has(modelName)) {
+      this.subscribers.set(modelName, []);
+    }
+    const listeners = this.subscribers.get(modelName);
+    listeners.push(callback);
+
+    // 返回取消订阅函数
+    return () => {
+      const index = listeners.indexOf(callback);
+      if (index > -1) {
+        listeners.splice(index, 1);
+      }
+    };
+  },
+};

package/database/core/apps/AppsClient.Storage.js

@@ -0,0 +1,275 @@
+import { isBrowser } from "../../../utils/index.js";
+
+export const appsClientStorageMethods = {
+  // ==================== 文件存储 API (R2 & GCS & OSS) ====================
+
+  /**
+   * 上传文件到 Cloudflare R2 (用于前端展示)
+   * @param {File | {data: string, encoding: 'base64', name: string}} file - 文件对象
+   * @returns {Promise<{success: boolean, data: {url: string, key: string}}>} 
+   */
+  async uploadFile(file) {
+    // 统一使用 R2 作为默认存储
+    return this.uploadToR2(file);
+  },
+
+  /**
+   * [原子接口] 获取 R2 上传预签名 URL
+   * @param {string} fileName - 文件名 (包含扩展名)
+   * @param {string} contentType - 文件 MIME 类型
+   * @returns {Promise<{uploadUrl: string, url: string, key: string, headers: object}>}
+   */
+  async getR2UploadUrl(fileName, contentType) {
+    if (!fileName) throw new Error("fileName is required");
+
+    const result = await this._post("/apps/upload-r2-presigned", {
+      appId: this.appId,
+      fileName,
+      contentType: contentType || "application/octet-stream",
+    });
+
+    if (!result.success || !result.data?.uploadUrl) {
+      throw new Error(result.message || "Failed to get upload URL");
+    }
+
+    return result.data;
+  },
+
+  /**
+   * 上传文件到 Cloudflare R2 (使用 Presigned URL 直传，支持代理转发以解决 CORS)
+   * @param {File | {data: string, encoding: 'base64', name: string}} file - 文件对象
+   * @returns {Promise<{success: boolean, data: {url: string, key: string}}>} 
+   */
+  async uploadToR2(file) {
+    if (!file) throw new Error("file is required");
+
+    let fileName;
+    let contentType;
+    let fileBody;
+
+    if (isBrowser) {
+      if (!(file instanceof File)) {
+        throw new Error("Invalid file input in browser. Provide a File object.");
+      }
+      fileName = file.name;
+      contentType = file.type || "application/octet-stream";
+      fileBody = file;
+    } else {
+      // isBackend
+      if (typeof file === "object" && file.data && file.name && file.encoding === "base64") {
+        fileName = file.name;
+        contentType = file.type || "application/octet-stream"; // 默认类型
+        fileBody = Buffer.from(file.data, "base64");
+      } else {
+        throw new Error(
+          "Invalid file input in Node.js. Provide { data: base64_string, encoding: 'base64', name: string }."
+        );
+      }
+    }
+
+    // 1. 获取上传地址 (使用原子接口)
+    const { uploadUrl, url: publicUrl, key, headers: uploadHeaders } = await this.getR2UploadUrl(fileName, contentType);
+
+    // 2. 执行上传 (直接使用后端返回的代理 URL 和 headers)
+    const uploadResponse = await fetch(uploadUrl, {
+      method: "PUT",
+      headers: uploadHeaders || { "Content-Type": contentType },
+      body: fileBody,
+    });
+
+    if (!uploadResponse.ok) {
+      throw new Error(`Failed to upload to R2: ${uploadResponse.statusText}`);
+    }
+
+    return {
+      success: true,
+      url: publicUrl,
+      key: key,
+    };
+  },
+
+  /**
+   * 下载 R2 文件 (流式/Blob)
+   * @param {string} key - 文件 Key
+   * @returns {Promise<Response>}
+   */
+  async downloadFromR2(key) {
+    if (!key) throw new Error("key is required");
+    const url = `${this.config.apiBaseUrl}/apps/download-r2?key=${encodeURIComponent(key)}`;
+    const headers = this._getRequestHeaders();
+
+    const response = await fetch(url, {
+      method: "GET",
+      headers,
+    });
+
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: "Network error" }));
+      throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    return response;
+  },
+
+  /**
+   * 获取 R2 文件的公开访问链接
+   * @param {string} key - 文件 Key
+   * @returns {string}
+   */
+  getR2PublicUrl(key) {
+    if (!key) throw new Error("key is required");
+    return `https://storage-r2.tacore.ai/${key}`;
+  },
+
+  /**
+   * 删除 R2 文件
+   * @param {string} key - 文件 Key
+   * @returns {Promise<{success: boolean, message: string}>}
+   */
+  async deleteFromR2(key) {
+    if (!key) throw new Error("key is required");
+    const url = `${this.config.apiBaseUrl}/apps/delete-r2`;
+    const headers = this._getRequestHeaders();
+    headers["Content-Type"] = "application/json";
+
+    const response = await fetch(url, {
+      method: "DELETE",
+      headers,
+      body: JSON.stringify({ key }),
+    });
+
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: "Network error" }));
+      throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    return response.json();
+  },
+
+  /**
+   * 上传文件到 Aliyun OSS
+   * @param {File | {data: string, encoding: 'base64', name: string}} file - 文件对象
+   * @returns {Promise<{success: boolean, data: {url: string, name: string}}>} 
+   */
+  async uploadToOSS(file) {
+    if (!file) throw new Error("file is required");
+
+    const url = `${this.config.apiBaseUrl}/apps/oss/upload`;
+    const form = new FormData();
+    form.append("appId", this.appId);
+
+    if (isBrowser) {
+      if (!(file instanceof File)) {
+        throw new Error("Invalid file input in browser. Provide a File object.");
+      }
+      form.append("file", file, file.name);
+    } else {
+      // isBackend
+      if (typeof file === "object" && file.data && file.name && file.encoding === "base64") {
+        const buffer = Buffer.from(file.data, "base64");
+        const fileBlob = new Blob([buffer]);
+        form.append("file", fileBlob, file.name);
+      } else {
+        throw new Error(
+          "Invalid file input in Node.js. Provide { data: base64_string, encoding: 'base64', name: string }."
+        );
+      }
+    }
+
+    const headers = this._getRequestHeaders();
+    delete headers["Content-Type"]; // Let browser set boundary
+
+    const resp = await fetch(url, {
+      method: "POST",
+      headers,
+      body: form,
+    });
+
+    if (!resp.ok) {
+      const err = await resp.json().catch(() => ({}));
+      throw new Error(err.message || `HTTP ${resp.status}: ${resp.statusText}`);
+    }
+    return resp.json();
+  },
+
+  /**
+   * 上传文件到 Google Cloud Storage (GCS) - 用于 AI 多模态理解
+   * @param {File | {data: string, encoding: 'base64', name: string, type: string}} file - 文件对象
+   * @returns {Promise<{signedUrl: string, fileUrl: string, fileUri: string, accessUrl: string}>}
+   */
+  async uploadToGCS(file) {
+    if (!file) throw new Error("file is required");
+
+    let fileName;
+    let contentType;
+    let fileBody;
+
+    if (isBrowser) {
+      if (!(file instanceof File)) {
+        throw new Error("Invalid file input in browser. Provide a File object.");
+      }
+      fileName = file.name;
+      contentType = file.type || "application/octet-stream";
+      fileBody = file;
+    } else {
+      // isBackend
+      if (typeof file === "object" && file.data && file.name && file.encoding === "base64") {
+        fileName = file.name;
+        contentType = file.type || "application/octet-stream";
+        fileBody = Buffer.from(file.data, "base64");
+      } else {
+        throw new Error(
+          "Invalid file input in Node.js. Provide { data: base64_string, encoding: 'base64', name: string, type: string }."
+        );
+      }
+    }
+
+    // [DEBUG] 打印上传参数
+    console.log("[AppsClient] uploadToGCS - Requesting signed URL for:", { fileName, contentType });
+
+    // 1. 获取签名 URL
+    const signResult = await this._post("/apps/storage/gcs-signed-url/generate", {
+      appId: this.appId,
+      fileName,
+      contentType,
+    });
+
+    if (!signResult.success || !signResult.data?.signedUrl) {
+      throw new Error(signResult.error || "Failed to get GCS signed URL");
+    }
+
+    const { signedUrl, fileUrl, fileUri, accessUrl } = signResult.data;
+
+    // [DEBUG] 打印签名 URL 和上传头
+    console.log("[AppsClient] uploadToGCS - Got signed URL:", signedUrl);
+    console.log("[AppsClient] uploadToGCS - Uploading with headers:", {
+      "Content-Type": contentType,
+      "x-target-hostname": "storage.googleapis.com",
+    });
+
+    // 2. 使用签名 URL 上传文件
+    // 注意：这里直接使用 fetch 上传到 GCS (通过代理)，不经过 tacore-server
+    // 后端已经将 signedUrl 替换为代理域名，直接使用即可
+    try {
+      const uploadResponse = await fetch(signedUrl, {
+        method: "PUT",
+        headers: {
+          "Content-Type": contentType,
+          "x-target-hostname": "storage.googleapis.com",
+        },
+        body: fileBody,
+      });
+
+      if (!uploadResponse.ok) {
+        const errorText = await uploadResponse.text().catch(() => "No error details");
+        console.error("[AppsClient] uploadToGCS - Upload failed:", uploadResponse.status, errorText);
+        throw new Error(`Failed to upload to GCS: ${uploadResponse.statusText} (${uploadResponse.status})`);
+      }
+    } catch (error) {
+      console.error("[AppsClient] uploadToGCS - Network error:", error);
+      throw error;
+    }
+
+    return { signedUrl, fileUrl, fileUri, accessUrl };
+  },
+};