@lovrabet/sdk 1.2.4 → 1.2.6

package/LICENSE

@@ -51,7 +51,7 @@
 如有疑问或需要商业授权，请联系：
 - 网站：https://www.lovrabet.com
 - 邮箱：support@lovrabet.com
-- 文档：https://docs.lovrabet.com
+- 文档：https://help.lovrabet.com
 
 ---
 

package/README.md

@@ -570,18 +570,6 @@ const result = await client.models.users.filter({
 });
 ```
 
-#### filter vs getList
-
-| 特性 | `filter()` | `getList()` |
-|------|-----------|------------|
-| 复杂条件查询 | ✅ 支持 $and, $or 等 | ❌ 仅支持简单参数 |
-| 字段选择 | ✅ 支持 select | ❌ 返回所有字段 |
-| 条件操作符 | ✅ 支持 11 种操作符 | ❌ 仅支持精确匹配 |
-| 排序 | ✅ 支持多字段排序 | ✅ 支持多字段排序 |
-| 分页 | ✅ 支持 | ✅ 支持 |
-| 性能 | 更优（减少数据传输） | 一般 |
-| 使用场景 | **推荐用于复杂查询** | 简单列表查询 |
-
 ### ⚠️ 操作限制
 
 **OpenAPI 模式暂不支持以下操作：**
@@ -657,6 +645,33 @@ const client = createClient({ token });
 
 ## 📝 What's New
 
+### v1.2.5 (2026-01-02)
+
+**错误处理增强 (Error Handling):**
+
+- 🤖 **AI 友好的错误信息** - `LovrabetError` 新增 `description` 字段，提供 LLM 可理解的错误描述和修复建议
+
+  ```typescript
+  try {
+    await client.models.users.create({ invalid_field: 'value' });
+  } catch (error) {
+    if (error instanceof LovrabetError) {
+      console.log(error.message);     // "invalid_field列不存在"
+      console.log(error.code);        // "SERVER_ERROR"
+      console.log(error.description); // "服务端返回错误: invalid_field列不存在。错误类型: 参数错误。状态码: 400。建议: 字段 \"invalid_field\" 不存在，请检查字段名是否拼写正确; 使用 MCP 工具获取数据集的正确字段列表"
+    }
+  }
+  ```
+
+  **错误类型覆盖：**
+  - `MODEL_NOT_FOUND` - 模型不存在，提供可用模型列表
+  - `CONFIG_NOT_FOUND` - 配置不存在，提供已注册配置列表
+  - `SERVER_ERROR` - 服务端参数错误，提供字段修复建议
+  - `401 权限不足` - 登录过期/appCode无权限/HTTPS/CORS 等建议
+  - `TIMEOUT` - 请求超时，提供超时配置建议
+
+---
+
 ### v1.2.2 (2025-12-30)
 
 **重大更新 (Major Changes):**

package/dist/index.d.ts

@@ -8,6 +8,6 @@ export { ApiNamespace } from "./src/api/index";
 export { AuthManager, } from "./src/auth/index";
 export { generateOpenApiToken, TokenGenerator, isTokenExpiring, getTokenRemainingTime, type GenerateTokenParams, type TokenResult } from "./src/auth/index";
 export type { ClientConfig, LovrabetClient, ModelConfig, ModelsConfig, } from "./src/types/index";
-export type { ListParams, ListResponse, FilterParams, WhereCondition, FieldCondition, ConditionOperator, Environment, BaseModelMethods, SortList, SelectOption, SelectOptionsParams, } from "./src/types/index";
+export type { ListParams, ListResponse, FilterParams, WhereCondition, FieldCondition, ConditionOperator, Environment, BaseModelMethods, SortList, SelectOption, SelectOptionsParams, AggregateParams, AggregateField, HavingCondition, } from "./src/types/index";
 export type { SqlExecuteRequest, SqlExecuteResult, } from "./src/api/types";
 export { SortOrder, } from "./src/types/index";