@lovrabet/sdk 1.1.16 → 1.1.18

package/README.md

@@ -273,6 +273,8 @@ import {
   type ListResponse,
   type ListParams,
   type SortList,
+  type SelectOption,
+  type SelectOptionsParams,
 
   // 枚举
   SortOrder,
@@ -330,6 +332,40 @@ const updated = await client.models.users.update("user-id", {
 
 // 删除
 await client.models.users.delete("user-id");
+
+// 获取下拉选项（WebAPI 模式）
+const options = await client.models.users.getSelectOptions({
+  code: "user_id", // 用作选项值的字段名
+  label: "user_name", // 用作显示文本的字段名
+});
+// 返回: [{ label: '张三', value: 'user001' }, { label: '李四', value: 'user002' }]
+```
+
+### ⚠️ 操作限制
+
+**OpenAPI 模式暂不支持以下操作：**
+
+- ❌ `delete()` - 删除操作（如需删除，请使用 WebAPI 模式）
+- ❌ `getSelectOptions()` - 获取下拉选项（仅 WebAPI 模式支持）
+
+```typescript
+// OpenAPI 模式调用 delete 会抛出错误
+try {
+  await client.models.users.delete("user-id");
+} catch (error) {
+  // Error: OpenAPI 模式暂不支持 delete 操作。如需删除数据，请使用 WebAPI 模式（Cookie 认证）。
+}
+
+// 如需删除，请使用 WebAPI 模式（Cookie 认证）
+const webApiClient = createClient({
+  appCode: "your-app-code",
+  // 不提供 token/accessKey，自动使用 Cookie 认证
+  models: {
+    /* ... */
+  },
+});
+
+await webApiClient.models.users.delete("user-id"); // ✅ 可以使用
 ```
 
 ## 🛡️ 安全最佳实践
@@ -380,6 +416,78 @@ const client = createClient({ token });
 
 ## 📝 What's New
 
+### v1.1.18 (2025-10-18)
+
+**新增功能 (New Features):**
+
+- ✨ **下拉选项接口** - 新增 `getSelectOptions` 方法，用于快速获取下拉选项数据
+
+  ```typescript
+  // 获取下拉选项（WebAPI 模式）
+  const options = await client.models.users.getSelectOptions({
+    code: "user_id", // 用作选项值的字段名
+    label: "user_name", // 用作显示文本的字段名
+  });
+
+  // 返回格式：
+  // [
+  //   { label: '张三', value: 'user001' },
+  //   { label: '李四', value: 'user002' },
+  //   { label: '王五', value: 'user003' }
+  // ]
+
+  // 在 React 中使用
+  <Select>
+    {options.map((option) => (
+      <Option key={option.value} value={option.value}>
+        {option.label}
+      </Option>
+    ))}
+  </Select>;
+  ```
+
+  - 返回标准化的 `{ label, value }` 格式，直接适用于前端组件
+  - 自动从数据表字段映射为选项数据
+  - 适用于 Select、Radio、Checkbox 等表单组件
+  - **仅 WebAPI 模式（Cookie 认证）支持**
+
+**操作限制说明 (Restrictions):**
+
+- ⚠️ **明确 OpenAPI 模式限制** - OpenAPI 模式暂不支持以下操作：
+
+  - ❌ `delete()` - 删除操作（如需删除，请使用 WebAPI 模式）
+  - ❌ `getSelectOptions()` - 获取下拉选项（仅 WebAPI 模式支持）
+
+  ```typescript
+  // OpenAPI 模式调用这些方法会抛出明确的错误提示
+  try {
+    await client.models.users.delete("user-id");
+  } catch (error) {
+    // Error: OpenAPI 模式暂不支持 delete 操作。如需删除数据，请使用 WebAPI 模式（Cookie 认证）。
+  }
+  ```
+
+**类型定义 (Type Definitions):**
+
+- 新增 `SelectOption` 接口：
+
+  ```typescript
+  interface SelectOption {
+    label: string; // 显示文本
+    value: string; // 选项值
+  }
+  ```
+
+- 新增 `SelectOptionsParams` 接口：
+  ```typescript
+  interface SelectOptionsParams {
+    code: string; // 用作选项值的字段名
+    label: string; // 用作显示文本的字段名
+  }
+  ```
+
+---
+
 ### v1.1.16 (2025-10-15)
 
 **新增功能 (New Features):**

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { AbstractBaseModel, OpenApiModel, WebApiModel, ModelFactory, } from "./s
 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, Environment, BaseModelMethods, SortList, } from "./src/types/index";
+export type { ListParams, ListResponse, Environment, BaseModelMethods, SortList, SelectOption, SelectOptionsParams, } from "./src/types/index";
 export { SortOrder, } from "./src/types/index";