@tacoreai/web-sdk 1.0.12 → 1.3.0

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

@@ -0,0 +1,71 @@
+export const appsClientCrawlerMethods = {
+  // ==================== 网页爬虫服务 ====================
+
+  async scrapeUrl(options = {}) {
+    try {
+      if (!options.url) {
+        throw new Error("url is required for scraping.");
+      }
+      const result = await this._post("/apps/crawler/scrape", {
+        appId: this.appId,
+        ...options,
+      });
+      console.log(`✅ [AppsClient] URL scraped successfully for app: ${this.appId}`);
+      return result;
+    } catch (error) {
+      console.error(`网页爬取失败 (app: ${this.appId}):`, error);
+      throw error;
+    }
+  },
+
+  async scrapeMultipleUrls(options = {}) {
+    try {
+      if (!options.urls || !Array.isArray(options.urls) || options.urls.length === 0) {
+        throw new Error("urls array is required for batch scraping.");
+      }
+      const result = await this._post("/apps/crawler/scrape-batch", {
+        appId: this.appId,
+        ...options,
+      });
+      console.log(`✅ [AppsClient] Batch URL scraping completed for app: ${this.appId}`);
+      return result;
+    } catch (error) {
+      console.error(`批量爬取失败 (app: ${this.appId}):`, error);
+      throw error;
+    }
+  },
+
+  async firecrawlScrape(options = {}) {
+    try {
+      if (!options.url) {
+        throw new Error("url is required for firecrawl scrape.");
+      }
+      const result = await this._post("/apps/firecrawl/scrape", {
+        appId: this.appId,
+        ...options,
+      });
+      console.log(`✅ [AppsClient] Firecrawl scrape completed for app: ${this.appId}`);
+      return result;
+    } catch (error) {
+      console.error(`Firecrawl 爬取失败 (app: ${this.appId}):`, error);
+      throw error;
+    }
+  },
+
+  async firecrawlMap(options = {}) {
+    try {
+      if (!options.url) {
+        throw new Error("url is required for firecrawl map.");
+      }
+      const result = await this._post("/apps/firecrawl/map", {
+        appId: this.appId,
+        ...options,
+      });
+      console.log(`✅ [AppsClient] Firecrawl map completed for app: ${this.appId}`);
+      return result;
+    } catch (error) {
+      console.error(`Firecrawl 站点地图生成失败 (app: ${this.appId}):`, error);
+      throw error;
+    }
+  },
+};

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

@@ -0,0 +1,187 @@
+export const appsClientDataMethods = {
+  // ==================== 核心数据操作 (多模型) ====================
+
+  /**
+   * @deprecated Use `createData` or `updateData` instead.
+   */
+  async writeData(modelName, data, wyID, publicConfig = {}) {
+    console.warn(
+      "`writeData` is deprecated. Please use `createData` for new records or `updateData` for existing ones."
+    );
+    if (wyID) {
+      // 如果提供了 wyID，我们认为是更新操作
+      return this.updateData(modelName, wyID, data, undefined, publicConfig);
+    }
+    // 如果没有 wyID，我们认为是创建操作
+    // 注意：旧的 writeData 不支持在创建时传递 permissions，所以这里是 undefined
+    return this.createData(modelName, data, undefined, publicConfig);
+  },
+
+  /**
+   * [新增] 创建一条新数据
+   * @param {string} modelName - 模型的名称
+   * @param {object} data - 要创建的数据
+   * @param {object} [permissions] - 可选的权限对象，例如 { read: ["group:all_users"], update: ["role:creater"] }
+   * @param {object} [publicConfig] - 可选的公共配置
+   * @returns {Promise<string>} - 新创建数据的 wyID
+   */
+  async createData(modelName, data, permissions, publicConfig) {
+    try {
+      const requestData = {
+        appId: this.appId,
+        modelName,
+        data: data,
+        permissions, // 可以是 undefined
+        publicConfig,
+      };
+      const result = await this._post("/apps/data/create", requestData);
+      return result.wyID;
+    } catch (error) {
+      console.error(`创建AI应用数据失败 (model: ${modelName}):`, error);
+      throw error;
+    }
+  },
+
+  /**
+   * [新增] 更新一条现有数据
+   * @param {string} modelName - 模型的名称
+   * @param {string} wyID - 要更新数据的 wyID
+   * @param {object} data - 新的数据内容
+   * @param {object} [permissions] - 可选的权限对象，用于修改记录的访问权限
+   * @param {object} [publicConfig] - 可选的公共配置
+   * @returns {Promise<string>} - 被更新数据的 wyID
+   */
+  async updateData(modelName, wyID, data, permissions, publicConfig) {
+    try {
+      const requestData = {
+        appId: this.appId,
+        modelName,
+        wyID,
+        data: data,
+        permissions,
+        publicConfig,
+      };
+      const result = await this._post("/apps/data/update", requestData);
+      return result.wyID;
+    } catch (error) {
+      console.error(`更新AI应用数据失败 (model: ${modelName}, wyID: ${wyID}):`, error);
+      throw error;
+    }
+  },
+
+  async readData(modelName, query) {
+    try {
+      if (!modelName) {
+        throw new Error("modelName is required");
+      }
+
+      const params = {
+        appId: this.appId,
+        modelName: modelName,
+      };
+
+      if (typeof query === "string") {
+        params.wyID = query;
+      } else if (query && typeof query === "object") {
+        const { page = 1, pageSize = 20, fields, filter } = query;
+        params.page = Math.max(1, parseInt(page));
+        params.pageSize = parseInt(pageSize) || 1000;
+        console.log(params);
+        if (fields && Array.isArray(fields)) {
+          params.fields = fields;
+        }
+
+        if (filter && typeof filter === "object") {
+          params.filter = filter;
+        }
+      }
+
+      const result = await this._get("/apps/data/read", params);
+
+      if (result.data === null && params.wyID) {
+        console.log(`📋 [AppsClient] No data found for app: ${this.appId}, model: ${modelName}, wyID: ${params.wyID}`);
+        return null;
+      }
+
+      console.log(`✅ [AppsClient] Data read successfully for app: ${this.appId}, model: ${modelName}`);
+      return result;
+    } catch (error) {
+      // 404 Not Found and 403 Forbidden are business logic, not exceptions
+      if (error.message.includes("404") || error.message.includes("403")) {
+        console.warn(`读取AI应用数据警告 (model: ${modelName}):`, error.message);
+        return null;
+      }
+      console.error(`读取AI应用数据失败 (model: ${modelName}):`, error);
+      throw error;
+    }
+  },
+
+  async deleteData(modelName, wyID, options = {}) {
+    try {
+      if (!modelName) {
+        throw new Error("modelName is required");
+      }
+      if (!wyID) {
+        throw new Error("wyID is required");
+      }
+
+      const { hard = false } = options;
+
+      const requestData = {
+        appId: this.appId,
+        modelName: modelName,
+        wyID: wyID,
+        hard: hard,
+      };
+
+      const result = await this._delete("/apps/data/delete", requestData);
+
+      const deleteType = hard ? "hard deleted" : "soft deleted";
+      console.log(
+        `✅ [AppsClient] Data ${deleteType} successfully for app: ${this.appId}, model: ${modelName}, wyID: ${wyID}`
+      );
+      return result.wyID;
+    } catch (error) {
+      console.error(`删除AI应用数据失败 (model: ${modelName}, wyID: ${wyID}):`, error);
+      throw error;
+    }
+  },
+
+  // ==================== 便捷方法 ====================
+
+  async hasData(modelName) {
+    try {
+      if (!modelName) throw new Error("modelName is required for hasData");
+      const result = await this.readData(modelName, { page: 1, pageSize: 1 });
+      return result && result.data && result.data.length > 0;
+    } catch (error) {
+      console.error(`检查应用数据失败 (model: ${modelName}):`, error);
+      return false;
+    }
+  },
+
+  async clearData(modelName) {
+    try {
+      if (!modelName) throw new Error("modelName is required for clearData");
+      // This is not a correct implementation of clear. It just writes an empty object.
+      // A proper clear would require a dedicated backend endpoint.
+      // For now, we keep the old behavior.
+      return await this.createData(modelName, {});
+    } catch (error) {
+      console.error(`清空应用数据失败 (model: ${modelName}):`, error);
+      throw error;
+    }
+  },
+
+  async getDataVersion(modelName, wyID) {
+    try {
+      if (!modelName) throw new Error("modelName is required for getDataVersion");
+      if (!wyID) throw new Error("wyID is required for getDataVersion");
+      const result = await this.readData(modelName, wyID);
+      return result ? result.meta : null;
+    } catch (error) {
+      console.error(`获取数据版本失败 (model: ${modelName}):`, error);
+      throw error;
+    }
+  },
+};

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

@@ -0,0 +1,41 @@
+import { isBrowser } from "../../../utils/index.js";
+
+export const appsClientDebugMethods = {
+  // ==================== 便捷方法 ====================
+
+  updateConfig(newConfig) {
+    this.config = { ...this.config, ...newConfig };
+  },
+
+  getConfig() {
+    return { ...this.config };
+  },
+
+  // ==================== 调试和监控 ====================
+
+  async getClientStatus() {
+    try {
+      const status = {
+        appId: this.appId,
+        config: this.getConfig(),
+        clientType: "AppsClient (Multi-Model with AI)",
+      };
+      if (isBrowser) {
+        status.hasAccessToken = !!localStorage.getItem("tacoreai_apps_access_token");
+      }
+      return status;
+    } catch (error) {
+      console.error("获取AI应用客户端状态失败:", error);
+      const status = {
+        appId: this.appId,
+        config: this.getConfig(),
+        error: error.message,
+        clientType: "AppsClient (Multi-Model with AI)",
+      };
+      if (isBrowser) {
+        status.hasAccessToken = !!localStorage.getItem("tacoreai_apps_access_token");
+      }
+      return status;
+    }
+  },
+};

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

@@ -0,0 +1,66 @@
+export const appsClientDeployMethods = {
+  // ==================== [新增] 部署与环境管理 ====================
+
+  /**
+   * 独立部署 (Deploy Customer / Pro Plan)
+   * @param {object} params
+   * @param {string} params.appId
+   * @param {object} params.files
+   * @param {string} [params.envName='default']
+   * @param {string} params.appVersion
+   * @param {string} params.appHistoryVersionId
+   */
+  async deployCustomer(params) {
+    if (!params.appId || !params.files) {
+      throw new Error("appId and files are required for deployCustomer.");
+    }
+    console.log("🚀 [AppsClient] Starting deployCustomer for app:", params.appId);
+    return this._post("/apps/deploy-customer", params);
+  },
+
+  /**
+   * 添加自定义域名
+   * @param {object} params { appId, hostname, envName }
+   */
+  async addCustomDomain(params) {
+    if (!params.appId || !params.hostname) {
+      throw new Error("appId and hostname are required.");
+    }
+    return this._post("/apps/applications/addCustomDomain", params);
+  },
+
+  /**
+   * 删除自定义域名
+   * @param {object} params { appId, hostname, envName }
+   */
+  async deleteCustomDomain(params) {
+    if (!params.appId || !params.hostname) {
+      throw new Error("appId and hostname are required.");
+    }
+    return this._post("/apps/applications/deleteCustomDomain", params);
+  },
+
+  /**
+   * 创建自定义环境
+   * @param {object} params { appId, envName, description }
+   */
+  async createEnvironment(params) {
+    return this._post("/apps/applications/createEnvironment", params);
+  },
+
+  /**
+   * 更新环境信息
+   * @param {object} params { appId, envName, updates }
+   */
+  async updateEnvironment(params) {
+    return this._post("/apps/applications/updateEnvironment", params);
+  },
+
+  /**
+   * 删除环境
+   * @param {object} params { appId, envName }
+   */
+  async deleteEnvironment(params) {
+    return this._post("/apps/applications/deleteEnvironment", params);
+  },
+};

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

@@ -0,0 +1,151 @@
+export const appsClientEcommerceMethods = {
+  // ==================== [新增] 电商模块 ====================
+
+  /**
+   * (管理员) 创建一个新商品。
+   * @param {object} productData - 商品数据。
+   * @param {string} productData.name - (必填) 商品名称。
+   * @param {number} productData.price - (必填) 商品价格。
+   * @param {string} [productData.description] - (可选) 商品描述。
+   * @param {Array<{url: string, name?: string, size?: number}>} [productData.images] - (可选) 商品图片对象数组。
+   * @param {'active' | 'inactive'} [productData.status='active'] - (可选) 商品状态, 'active' (上架) 或 'inactive' (下架)。
+   * @returns {Promise<{success: boolean, data: {wyID: string}}>} 返回一个包含新商品 wyID 的对象。
+   */
+  async createProduct(productData) {
+    if (!productData || typeof productData !== "object") {
+      throw new Error("productData must be an object.");
+    }
+    if (!productData.name || typeof productData.name !== "string") {
+      throw new Error("productData.name is required and must be a string.");
+    }
+    if (productData.price === undefined || typeof productData.price !== "number") {
+      throw new Error("productData.price is required and must be a number.");
+    }
+    return this._post("/apps/product/create", { appId: this.appId, data: productData });
+  },
+
+  /**
+   * (公开) 获取单个商品详情。
+   * @param {string} productId - 要获取的商品的 wyID。
+   * @returns {Promise<{success: boolean, data: object|null}>} 返回一个包含商品完整文档的对象。如果找不到，data 为 null。
+   */
+  async getProduct(productId) {
+    if (!productId || typeof productId !== "string") {
+      throw new Error("productId is required and must be a string.");
+    }
+    return this._get("/apps/product/read", { appId: this.appId, wyID: productId });
+  },
+
+  /**
+   * (公开) 获取商品列表。
+   * @param {object} [options] - 分页选项。
+   * @param {number} [options.page=1] - 页码，从1开始。
+   * @param {number} [options.pageSize=20] - 每页数量。
+   * @returns {Promise<{success: boolean, data: object[], total: number, page: number, pageSize: number, totalPages: number, hasNext: boolean, hasPrev: boolean}>} 返回商品文档列表和分页信息。
+   */
+  async listProducts(options = {}) {
+    return this._get("/apps/product/read", { appId: this.appId, ...options });
+  },
+
+  /**
+   * (管理员) 更新一个商品。
+   * @param {string} productId - 要更新的商品的 wyID。
+   * @param {object} productData - 要更新的商品数据，可包含 name, description, price, images, status 中的任意字段。
+   * @returns {Promise<{success: boolean, data: {wyID: string}}>} 返回一个包含被更新商品 wyID 的对象。
+   */
+  async updateProduct(productId, productData) {
+    if (!productId || typeof productId !== "string") {
+      throw new Error("productId is required and must be a string.");
+    }
+    if (!productData || typeof productData !== "object" || Object.keys(productData).length === 0) {
+      throw new Error("productData must be a non-empty object.");
+    }
+    return this._post("/apps/product/update", { appId: this.appId, wyID: productId, data: productData });
+  },
+
+  /**
+   * (管理员) 删除一个商品 (软删除)。
+   * @param {string} productId - 要删除的商品的 wyID。
+   * @returns {Promise<{success: boolean, data: {wyID: string}}>} 返回一个包含被删除商品 wyID 的对象。
+   */
+  async deleteProduct(productId) {
+    if (!productId || typeof productId !== "string") {
+      throw new Error("productId is required and must be a string.");
+    }
+    return this._post("/apps/product/delete", { appId: this.appId, wyID: productId });
+  },
+
+  /**
+   * (用户) 创建一个新订单，并获取支付链接。
+   * @param {object} orderData - 订单数据。
+   * @param {Array<{productId: string, units: number}>} orderData.products - (必填) 商品列表，包含商品ID和数量。
+   * @param {string} orderData.successUrlPrefix - (必填) 支付成功后的跳转页面URL前缀，后端会自动附加 ?orderId=xxx。
+   * @param {object} [orderData.metadata] - (可选) 附加的元数据，如客户备注等。
+   * @returns {Promise<{success: boolean, data: {checkoutUrl: string, orderId: string}}>} 返回支付网关的URL和内部订单ID。
+   */
+  async createOrder(orderData) {
+    if (!orderData || typeof orderData !== "object") {
+      throw new Error("orderData must be an object.");
+    }
+    if (!Array.isArray(orderData.products) || orderData.products.length === 0) {
+      throw new Error("orderData.products is required and must be a non-empty array.");
+    }
+    if (!orderData.successUrlPrefix || typeof orderData.successUrlPrefix !== "string") {
+      throw new Error("orderData.successUrlPrefix is required and must be a string.");
+    }
+    return this._post("/apps/order/create", { appId: this.appId, ...orderData });
+  },
+
+  /**
+   * (用户/管理员) 获取单个订单详情。
+   * 普通用户只能获取自己的订单，管理员可以获取应用下任意订单。
+   * @param {string} orderId - 要获取的订单的 wyID。
+   * @returns {Promise<{success: boolean, data: object|null}>} 返回一个包含订单完整文档的对象。如果找不到或无权限，data 为 null。
+   */
+  async getOrder(orderId) {
+    if (!orderId || typeof orderId !== "string") {
+      throw new Error("orderId is required and must be a string.");
+    }
+    return this._get("/apps/order/read", { appId: this.appId, wyID: orderId });
+  },
+
+  /**
+   * (用户/管理员) 获取订单列表。
+   * 普通用户只能获取自己的订单列表，管理员可以获取应用下所有订单列表。
+   * @param {object} [options] - 分页选项。
+   * @param {number} [options.page=1] - 页码，从1开始。
+   * @param {number} [options.pageSize=20] - 每页数量。
+   * @returns {Promise<{success: boolean, data: object[], total: number, ...}>} 返回订单文档列表和分页信息。
+   */
+  async listOrders(options = {}) {
+    return this._get("/apps/order/read", { appId: this.appId, ...options });
+  },
+
+  /**
+   * (管理员) 更新一个订单。
+   * @param {string} orderId - 要更新的订单的 wyID。
+   * @param {object} orderData - 要更新的订单数据。
+   * @returns {Promise<{success: boolean, data: {wyID: string}}>} 返回一个包含被更新订单 wyID 的对象。
+   */
+  async updateOrder(orderId, orderData) {
+    if (!orderId || typeof orderId !== "string") {
+      throw new Error("orderId is required and must be a string.");
+    }
+    if (!orderData || typeof orderData !== "object" || Object.keys(orderData).length === 0) {
+      throw new Error("orderData must be a non-empty object.");
+    }
+    return this._post("/apps/order/update", { appId: this.appId, wyID: orderId, data: orderData });
+  },
+
+  /**
+   * (管理员) 删除一个订单 (软删除)。
+   * @param {string} orderId - 要删除的订单的 wyID。
+   * @returns {Promise<{success: boolean, data: {wyID: string}}>} 返回一个包含被删除订单 wyID 的对象。
+   */
+  async deleteOrder(orderId) {
+    if (!orderId || typeof orderId !== "string") {
+      throw new Error("orderId is required and must be a string.");
+    }
+    return this._post("/apps/order/delete", { appId: this.appId, wyID: orderId });
+  },
+};

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

@@ -0,0 +1,72 @@
+export const appsClientKvMethods = {
+  // ==================== KV 存储 ====================
+
+  /**
+   * Cloudflare KV: 获取数据
+   * @param {string} key
+   * @param {object} params - 查询参数
+   * @returns {Promise<any>}
+   */
+  async kvGet(key, params = {}) {
+    if (!key) throw new Error("key is required");
+    let endpoint = `/apps/kv/${encodeURIComponent(key)}`;
+
+    const searchParams = new URLSearchParams();
+    Object.keys(params).forEach(k => {
+      if (params[k] !== undefined && params[k] !== null) {
+        searchParams.append(k, params[k]);
+      }
+    });
+    const queryString = searchParams.toString();
+    if (queryString) {
+      endpoint += `?${queryString}`;
+    }
+
+    const result = await this._apiRequest(endpoint, {
+      method: "GET",
+    });
+    return result.data;
+  },
+
+  /**
+   * Cloudflare KV: 写入数据
+   * @param {string} key
+   * @param {any} value
+   * @param {object} options - { expirationTtl?: number, expiration?: number }
+   * @returns {Promise<boolean>}
+   */
+  async kvPut(key, value, options = {}) {
+    if (!key) throw new Error("key is required");
+    const endpoint = `/apps/kv/${encodeURIComponent(key)}`;
+    const result = await this._apiRequest(endpoint, {
+      method: "PUT",
+      body: JSON.stringify({ value, ...options }),
+    });
+    return result.success;
+  },
+
+  /**
+   * Cloudflare KV: 删除数据
+   * @param {string} key
+   * @param {object} params - 查询参数
+   * @returns {Promise<boolean>}
+   */
+  async kvDelete(key, params = {}) {
+    if (!key) throw new Error("key is required");
+    let endpoint = `/apps/kv/${encodeURIComponent(key)}`;
+
+    const searchParams = new URLSearchParams();
+    Object.keys(params).forEach(k => {
+      if (params[k] !== undefined && params[k] !== null) {
+        searchParams.append(k, params[k]);
+      }
+    });
+    const queryString = searchParams.toString();
+    if (queryString) {
+      endpoint += `?${queryString}`;
+    }
+
+    const result = await this._delete(endpoint);
+    return result.success;
+  },
+};