@lovrabet/sdk 1.3.6 → 1.3.8

package/README.md

@@ -14,6 +14,27 @@
 
 ## 🆕 What's New
 
+### v1.3.7 (2026-03-16)
+- ✨ **批量操作支持** - `update()` 和 `delete()` 现在支持批量操作，最多 1000 条记录
+  ```typescript
+  // 批量更新
+  await client.models.users.update([1001, 1002, 1003], { status: "active" });
+
+  // 批量删除
+  await client.models.users.delete([1001, 1002, 1003]);
+  ```
+- ✨ **聚合查询接口** - 新增 `aggregate()` 方法，支持分组统计、求和、平均值等操作
+  ```typescript
+  const result = await client.models.orders.aggregate({
+    groupBy: ["status"],
+    aggregations: [
+      { field: "id", type: "count", alias: "orderCount" },
+      { field: "amount", type: "sum", alias: "totalAmount" }
+    ]
+  });
+  ```
+- 📖 **文档完善** - 新增完整的使用指南文档，详见 `help/lovrabet-sdk-guide.md`
+
 ### v1.1.14 (2026-03-06)
 - ✨ **Node.js 环境 Cookie 支持** - 新增 `cookie` 配置参数，支持在 Node.js 环境显式传递 Cookie 字符串
 - 🎯 **统一认证接口** - Cookie 认证现在在浏览器和 Node.js 环境中都可以使用，只是传递方式不同
@@ -466,20 +487,44 @@ const newUser = await client.models.users.create({
   email: "john@example.com",
 });
 
-// 更新
+// 更新（支持单条和批量）
+// 单条更新
 const updated = await client.models.users.update("user-id", {
   name: "Jane Doe",
 });
 
-// 删除
+// 批量更新（最多 1000 条）
+const updatedBatch = await client.models.users.update(
+  ["user-id-1", "user-id-2", "user-id-3"],
+  { status: "inactive" }
+);
+
+// 删除（支持单条和批量）
+// 单条删除
 await client.models.users.delete("user-id");
 
+// 批量删除（最多 1000 条）
+await client.models.users.delete(["user-id-1", "user-id-2", "user-id-3"]);
+
 // 获取下拉选项（WebAPI 模式）
 const options = await client.models.users.getSelectOptions({
   code: "user_id", // 用作选项值的字段名
   label: "user_name", // 用作显示文本的字段名
 });
 // 返回: [{ label: '张三', value: 'user001' }, { label: '李四', value: 'user002' }]
+
+// 聚合查询
+const result = await client.models.orders.aggregate({
+  where: { status: { $eq: "completed" } },
+  groupBy: ["region"],
+  aggregations: [
+    { field: "id", type: "count", alias: "orderCount" },
+    { field: "amount", type: "sum", alias: "totalAmount" },
+    { field: "amount", type: "avg", alias: "avgAmount" }
+  ],
+  currentPage: 1,
+  pageSize: 20
+});
 ```
 
 ### 🔍 高级过滤查询（推荐）
@@ -668,6 +713,7 @@ const client = createClient({ token });
 ## 📚 文档
 
 - **[文档中心](./docs/README.md)** - 完整的文档导航
+- **[使用指南](../help/lovrabet-sdk-guide.md)** - 完整的 SDK 使用指南 ⭐
 - **[OpenAPI 完整指南](./docs/openapi-guide.md)** - OpenAPI 实现原理和使用案例 ⭐
 - [使用指南](./docs/usage-guide.md) - 详细的使用文档和示例
 - [API 参考](./docs/api-reference.md) - 完整的 API 文档