@lovrabet/sdk 1.1.16 → 1.1.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +108 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/src/models/abstract-base-model.d.ts +2 -1
- package/dist/src/models/openapi-model.d.ts +5 -0
- package/dist/src/types/index.d.ts +46 -0
- package/package.json +1 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { BaseModelMethods, ListParams, ListResponse, ModelConfig, ClientConfig, SortList } from '../types';
|
|
1
|
+
import type { BaseModelMethods, ListParams, ListResponse, ModelConfig, ClientConfig, SortList, SelectOption, SelectOptionsParams } from '../types';
|
|
2
2
|
import type { HttpClient } from '../http/http-client';
|
|
3
3
|
/**
|
|
4
4
|
* 抽象基础模型类
|
|
@@ -20,6 +20,7 @@ export declare abstract class AbstractBaseModel implements BaseModelMethods {
|
|
|
20
20
|
update<T = any>(id: string | number, data: Record<string, any>): Promise<T>;
|
|
21
21
|
delete(id: string | number): Promise<void>;
|
|
22
22
|
getDatasetList<T = any>(): Promise<T[]>;
|
|
23
|
+
getSelectOptions(params: SelectOptionsParams): Promise<SelectOption[]>;
|
|
23
24
|
private isOpenApiMode;
|
|
24
25
|
getConfig(): ModelConfig;
|
|
25
26
|
getModelName(): string;
|
|
@@ -15,4 +15,9 @@ export declare class OpenApiModel extends AbstractBaseModel {
|
|
|
15
15
|
* 请求体只包含业务数据
|
|
16
16
|
*/
|
|
17
17
|
protected buildRequestBody(method: string, data: any, sortList?: SortList): any;
|
|
18
|
+
/**
|
|
19
|
+
* OpenAPI 模式暂不支持 delete 操作
|
|
20
|
+
* @throws Error 当尝试调用 delete 时抛出错误
|
|
21
|
+
*/
|
|
22
|
+
delete(id: string | number): Promise<void>;
|
|
18
23
|
}
|
|
@@ -62,6 +62,35 @@ export interface ListResponse<T> {
|
|
|
62
62
|
/** 每页数量 */
|
|
63
63
|
pageSize: number;
|
|
64
64
|
}
|
|
65
|
+
/**
|
|
66
|
+
* 下拉选项接口
|
|
67
|
+
* @description 用于 Select 组件的选项数据格式
|
|
68
|
+
*/
|
|
69
|
+
export interface SelectOption {
|
|
70
|
+
/** 显示文本 */
|
|
71
|
+
label: string;
|
|
72
|
+
/** 选项值 */
|
|
73
|
+
value: string;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* 获取下拉选项的参数接口
|
|
77
|
+
* @description 指定用于生成下拉选项的字段映射
|
|
78
|
+
* @example
|
|
79
|
+
* ```typescript
|
|
80
|
+
* // 获取用户列表的下拉选项
|
|
81
|
+
* const options = await model.getSelectOptions({
|
|
82
|
+
* code: 'user_id', // 将 user_id 字段作为 value
|
|
83
|
+
* label: 'user_name' // 将 user_name 字段作为 label
|
|
84
|
+
* });
|
|
85
|
+
* // 返回: [{ label: '张三', value: 'user001' }, ...]
|
|
86
|
+
* ```
|
|
87
|
+
*/
|
|
88
|
+
export interface SelectOptionsParams {
|
|
89
|
+
/** 用作选项值的字段名 */
|
|
90
|
+
code: string;
|
|
91
|
+
/** 用作显示文本的字段名 */
|
|
92
|
+
label: string;
|
|
93
|
+
}
|
|
65
94
|
/**
|
|
66
95
|
* 单个模型配置接口
|
|
67
96
|
* @description 定义数据模型的基本配置信息
|
|
@@ -200,6 +229,7 @@ export interface BaseModelMethods {
|
|
|
200
229
|
* 删除数据
|
|
201
230
|
* @param id 要删除的数据 ID
|
|
202
231
|
* @returns Promise<void>
|
|
232
|
+
* @throws Error OpenAPI 模式暂不支持此操作,仅 WebAPI 模式可用
|
|
203
233
|
*/
|
|
204
234
|
delete(id: string | number): Promise<void>;
|
|
205
235
|
/**
|
|
@@ -209,6 +239,22 @@ export interface BaseModelMethods {
|
|
|
209
239
|
* @description 获取当前应用下的所有数据集列表,主要用于 OpenAPI 模式
|
|
210
240
|
*/
|
|
211
241
|
getDatasetList<T = any>(): Promise<T[]>;
|
|
242
|
+
/**
|
|
243
|
+
* 获取下拉选项
|
|
244
|
+
* @param params 字段映射参数,指定用作 value 和 label 的字段名
|
|
245
|
+
* @returns 返回下拉选项数组
|
|
246
|
+
* @description 用于获取数据表的下拉选项数据,适用于 Select 组件(仅 WebAPI 模式支持)
|
|
247
|
+
* @example
|
|
248
|
+
* ```typescript
|
|
249
|
+
* // 获取用户下拉选项
|
|
250
|
+
* const options = await model.getSelectOptions({
|
|
251
|
+
* code: 'user_id',
|
|
252
|
+
* label: 'user_name'
|
|
253
|
+
* });
|
|
254
|
+
* // 返回: [{ label: '张三', value: 'user001' }, { label: '李四', value: 'user002' }]
|
|
255
|
+
* ```
|
|
256
|
+
*/
|
|
257
|
+
getSelectOptions(params: SelectOptionsParams): Promise<SelectOption[]>;
|
|
212
258
|
}
|
|
213
259
|
/**
|
|
214
260
|
* 模型管理器接口
|