@lovrabet/sdk 1.1.19 → 1.1.20

package/README.md

@@ -246,7 +246,7 @@ SDK 提供了 `client.api` 命名空间，用于执行自定义 SQL 查询和其
 
 ```typescript
 // 执行 SQL 查询，返回结果数组
-const results = await client.api.executeSql('fc8e7777-06e3847d');
+const results = await client.api.executeSql("fc8e7777-06e3847d");
 console.log(results);
 // [
 //   { creation_date: '2025-08-13', page_count: 2 },
@@ -259,9 +259,9 @@ console.log(results);
 
 ```typescript
 // 传递参数到 SQL
-const results = await client.api.executeSql('fc8e7777-xxxxx', {
-  userId: '123',
-  startDate: '2025-01-01'
+const results = await client.api.executeSql("fc8e7777-xxxxx", {
+  userId: "123",
+  startDate: "2025-01-01",
 });
 ```
 
@@ -275,9 +275,9 @@ interface PageStat {
 }
 
 // 使用泛型获得类型安全
-const stats = await client.api.executeSql<PageStat>('fc8e7777-06e3847d');
-stats.forEach(stat => {
-  console.log(stat.creation_date);  // TypeScript 自动补全
+const stats = await client.api.executeSql<PageStat>("fc8e7777-06e3847d");
+stats.forEach((stat) => {
+  console.log(stat.creation_date); // TypeScript 自动补全
   console.log(stat.page_count);
 });
 ```
@@ -286,31 +286,33 @@ stats.forEach(stat => {
 
 ```typescript
 // 获取第一条结果
-const results = await client.api.executeSql<PageStat>('fc8e7777-xxxxx');
+const results = await client.api.executeSql<PageStat>("fc8e7777-xxxxx");
 const firstResult = results[0];
 
 if (firstResult) {
-  console.log(`日期: ${firstResult.creation_date}, 数量: ${firstResult.page_count}`);
+  console.log(
+    `日期: ${firstResult.creation_date}, 数量: ${firstResult.page_count}`
+  );
 } else {
-  console.log('无结果');
+  console.log("无结果");
 }
 
 // 过滤结果
-const activeItems = results.filter(item => item.status === 'active');
+const activeItems = results.filter((item) => item.status === "active");
 
 // 查找特定结果
-const targetItem = results.find(item => item.id === '123');
+const targetItem = results.find((item) => item.id === "123");
 ```
 
 #### 错误处理
 
 ```typescript
 try {
-  const results = await client.api.executeSql('fc8e7777-xxxxx');
+  const results = await client.api.executeSql("fc8e7777-xxxxx");
 } catch (error) {
   if (error instanceof LovrabetError) {
-    console.error('SQL执行失败:', error.message);
-    console.error('错误代码:', error.code);
+    console.error("SQL执行失败:", error.message);
+    console.error("错误代码:", error.code);
   }
 }
 ```
@@ -507,23 +509,25 @@ const client = createClient({ token });
 
   ```typescript
   // 执行 SQL 查询
-  const data = await client.api.executeSql('fc8e7777-06e3847d');
+  const data = await client.api.executeSql("fc8e7777-06e3847d");
 
   // 应用层检查执行结果
   if (data.execSuccess && data.execResult) {
-    data.execResult.forEach(row => {
+    data.execResult.forEach((row) => {
       console.log(row);
     });
   }
   ```
 
   **核心特性：**
+
   - 支持参数化查询，防止 SQL 注入
   - 完整的 TypeScript 类型支持（泛型）
   - 返回 `{ execSuccess: boolean, execResult?: T[] }` 结构
   - 应用层负责检查 `execSuccess` 状态
 
   **适用场景：**
+
   - 复杂数据统计和聚合查询
   - 跨表关联查询
   - 自定义报表数据获取
@@ -531,66 +535,11 @@ const client = createClient({ token });
 
 - 🏗️ **API 命名空间架构** - 新增 `client.api` 命名空间，用于管理通用 API 调用
 
-  ```typescript
-  const client = createClient({ /* ... */ });
-
-  // 通过 api 命名空间访问
-  const data = await client.api.executeSql('sqlCode');
-  ```
-
-  - 统一的 API 调用入口
-  - 为未来扩展预留空间（executeFunction、callWebhook 等）
-  - 与 Model API 保持一致的设计风格
-
-**类型定义 (Type Definitions):**
-
-- 新增 `SqlExecuteRequest` 接口：
-
-  ```typescript
-  interface SqlExecuteRequest {
-    sqlCode: string | number;  // SQL 代码
-    params?: Record<string, string | number>;  // SQL 参数
-  }
-  ```
-
-- 新增 `SqlExecuteResult<T>` 接口：
-
-  ```typescript
-  interface SqlExecuteResult<T = Record<string, any>> {
-    execSuccess: boolean;  // SQL 执行是否成功
-    execResult?: T[];      // 查询结果数组
-  }
-  ```
-
-- 导出 `ApiNamespace` 类供高级用户使用
-
-**重要说明 (Important Notes):**
-
-:::warning SDK 返回值设计原则
-
-SDK 的 `executeSql()` 方法返回包含 `execSuccess` 和 `execResult` 的对象，**不直接返回结果数组**。
-
-这是因为：
-1. **分离职责** - SDK 负责 HTTP 通信，应用层负责业务逻辑判断
-2. **错误处理** - `execSuccess: false` 表示 SQL 执行失败（业务错误），HTTP 失败才抛异常
-3. **灵活性** - 应用层可以根据 `execSuccess` 自行决定如何处理
-
-```typescript
-// ✅ 正确使用方式
-const data = await client.api.executeSql('sqlCode');
-if (data.execSuccess && data.execResult) {
-  // 使用 execResult
-}
-
-// ❌ 错误使用方式
-const data = await client.api.executeSql('sqlCode');
-data.execResult.forEach(...);  // 没有检查 execSuccess！
-```
-:::
+详细说明参考：[说明文档](https://open.lovrabet.com/docs/lovrabet-sdk/sql-api)
 
 ---
 
-### v1.1.18 (2025-10-18)
+### v1.1.17 (2025-10-18)
 
 **新增功能 (New Features):**