@lovrabet/sdk 1.1.19-beta.0 → 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);
   }
 }
 ```
@@ -499,7 +501,45 @@ const client = createClient({ token });
 
 ## 📝 What's New
 
-### v1.1.18 (2025-10-18)
+### v1.1.19 (2025-11-10)
+
+**新增功能 (New Features):**
+
+- ✨ **SQL API 支持** - 新增 `client.api.executeSql()` 方法，支持执行自定义 SQL 查询
+
+  ```typescript
+  // 执行 SQL 查询
+  const data = await client.api.executeSql("fc8e7777-06e3847d");
+
+  // 应用层检查执行结果
+  if (data.execSuccess && data.execResult) {
+    data.execResult.forEach((row) => {
+      console.log(row);
+    });
+  }
+  ```
+
+  **核心特性：**
+
+  - 支持参数化查询，防止 SQL 注入
+  - 完整的 TypeScript 类型支持（泛型）
+  - 返回 `{ execSuccess: boolean, execResult?: T[] }` 结构
+  - 应用层负责检查 `execSuccess` 状态
+
+  **适用场景：**
+
+  - 复杂数据统计和聚合查询
+  - 跨表关联查询
+  - 自定义报表数据获取
+  - 灵活的数据分析需求
+
+- 🏗️ **API 命名空间架构** - 新增 `client.api` 命名空间，用于管理通用 API 调用
+
+详细说明参考：[说明文档](https://open.lovrabet.com/docs/lovrabet-sdk/sql-api)
+
+---
+
+### v1.1.17 (2025-10-18)
 
 **新增功能 (New Features):**