@lovrabet/sdk 1.6.1-beta.1 → 1.6.1-beta.3

package/dist/index.d.ts

@@ -1,25 +1,3592 @@
-export { createClient } from "./src/client/index.js";
-export { registerModels, getRegisteredModels, getRegisteredConfigNames, unregisterModels, clearAllRegistrations, } from "./src/config/model-registry.js";
-export { getApiEndpoint, getAvailableEnvironments, getAvailableRegions, } from "./src/config/endpoints.js";
-export { CONFIG_NAMES, ENVIRONMENTS, REGIONS, DEFAULTS, HTTP_STATUS, ERROR_MESSAGES, API_PATHS, } from "./src/config/constants.js";
-export { LovrabetError } from "./src/utils/errors.js";
-export { safe } from "./src/utils/safe.js";
-export type { SafeResult } from "./src/utils/safe.js";
-export { sqlSafe } from "./src/utils/sql-safe.js";
-export type { SqlSafeResult } from "./src/utils/sql-safe.js";
-export { AbstractBaseModel, OpenApiModel, WebApiModel, ClientAkModel, ModelFactory, } from "./src/models/index.js";
-export { ApiNamespace, ClientAkSqlClient, ClientAkBffClient, PermitClient, ArtifactClient, ApprovalClient, AppClient, DatasetMetaClient, ManagementClient, } from "./src/api/index.js";
-export type { AppRoleRequest, AppRoleCreateParam, AppRoleUpdateParam, AppRolePermitQueryParam, AppRoleVO, UserAppRelationQueryParam, AppUserBaseVO, AppRoleUserVO, RoleUserUpdateParam, AppEmployee, BaseRoleVO, ResourcePermitDTO, MenuPermitDTO, AppResourceMenuParam, ResourcePermitParam, MenuRolePermitListVO, MenuRolePermitNodeVO, AppPermitBaseVO, AppMenuPermitVO, AppDatasetPermitVO, DatasetPermitListVO, AppDatasetActionRolePermitVO, AppDatasetRolePermitVO, DatasetRolePermitListVO, RuntimeIdentityPermission, UserAppRelation, ArtifactUpsertRequest, ArtifactListQuery, RuntimeArtifactDTO, ApprovalTodoQuery, ApprovalFlowTransferCandidate, ApprovalFlowIdentityLink, ApprovalFlowTaskItem, ApprovalFlowTaskDetail, ApprovalFlowApproveRequest, ApprovalFlowTransferRequest, LoginUserInfo, SmartApp, UserAccountBindRequest, NotificationChannelConfig, ScriptLogQuery, EndpointScriptSummary, ScriptDefinition, ClientAkBffExecuteRequest, PageResult, Paging, DataList, CustomSqlQueryRequest, UserCustomSqlDTO, DatasetRequest, DatasetMeta, DatasetDrivenDataQuery, } from "./src/api/index.js";
-export type { DatasetImportBatchRequest, DatasetImportBatchResult, DatasetImportReadbackResult, DatasetImportImageRequest, DatasetImportImageReadbackRequest, } from "./src/models/index.js";
-export { ServicesNamespace, FileClient, OcrClient, OcrType, OCR_TYPES, } from "./src/services/index.js";
-export type { LovrabetServices, FileQueryUrlRequest, FileService, FileUploadRequest, FileUploadResponse, FileUrlResponse, OcrRecognizeRequest, OcrRecognizeResponse, OcrService, ServiceRequestOptions, } from "./src/services/index.js";
-export { LovrabetFlowClient } from "./src/flow/index.js";
-export type { FlowBatchTaskActionRequest, FlowBatchTransferRequest, FlowCcQuery, FlowCcRequest, FlowCustomPageCcDetail, FlowCustomPageDefinition, FlowCustomPageStartResponse, FlowCustomPageSubmittedProcess, FlowCustomPageTaskDetail, FlowCustomPageTaskItem, FlowCustomPageTimeline, FlowDefinitionQuery, FlowPage, FlowPageQuery, FlowProcessReasonRequest, FlowRecord, FlowResubmitRequest, FlowReturnRequest, FlowReturnTarget, FlowStartRequest, FlowSubmittedQuery, FlowTaskActionRequest, FlowTransferRequest, FlowUpdateVariablesRequest, FlowVariableProjectionQuery, FlowVariableQuery, } from "./src/flow/index.js";
-export { PersonalNamespace, PersonalBffClient, } from "./src/personal/index.js";
-export type { LovrabetPersonal, PersonalBffExecuteRequest, PersonalBffScript, PersonalBffService, PersonalBffUpsertRequest, PersonalRequestOptions, } from "./src/personal/index.js";
-export { AuthManager, } from "./src/auth/index.js";
-export { generateOpenApiToken, generateFlowOpenApiToken, TokenGenerator, isTokenExpiring, getTokenRemainingTime, type GenerateTokenParams, type GenerateFlowTokenParams, type TokenResult } from "./src/auth/index.js";
-export type { ClientConfig, LovrabetClient, ModelConfig, ModelsConfig, AuthMode, Region, } from "./src/types/index.js";
-export type { ListParams, ListResponse, FilterParams, WhereCondition, FieldCondition, ConditionOperator, Environment, BaseModelMethods, SortList, SelectOption, SelectOptionsParams, AggregateParams, AggregateField, HavingCondition, } from "./src/types/index.js";
-export type { SqlExecuteRequest, SqlExecuteResult, } from "./src/api/types.js";
-export { SortOrder, } from "./src/types/index.js";
+declare class HttpClient {
+    private config;
+    private authManager;
+    private errorHandler;
+    constructor(config: ClientConfig, authManager: AuthManager$1);
+    /**
+     * 获取 API 基础地址
+     * 优先级：runtimeDomain > serverUrl >
+     * window.__GLOBAL__.deploymentConfig.RUNTIME_API_DOMAIN > getApiEndpoint(env, region)
+     *
+     * 注：serverUrl 为 runtimeDomain 的旧名称，向下兼容保留；两者均设置时以 runtimeDomain 优先。
+     */
+    getBaseUrl(): string;
+    private getFullUrl;
+    /**
+     * 准备请求的通用逻辑：认证头、Cookie配置等
+     */
+    private prepareRequestInit;
+    /**
+     * 通用的错误处理包装器
+     */
+    private executeWithErrorHandling;
+    /** Apply the request deadline until response parsing finishes, preserving caller cancellation. */
+    private withTimeout;
+    /**
+     * 通用的fetch请求方法（用于PUT/DELETE等没有专门优化函数的方法）
+     */
+    private makeRequest;
+    get<T = any>(url: string, params?: Record<string, any>, options?: RequestInit, datasetCode?: string): Promise<T>;
+    post<T = any>(url: string, data?: any, options?: RequestInit, datasetCode?: string): Promise<T>;
+    /**
+     * 调用绑定应用与操作人的 Flow OpenAPI。
+     * Flow 签名使用 operatorUserId，不使用 datasetCode；签名字段也必须随请求体发送。
+     */
+    postFlow<T = any>(url: string, paramMap: Record<string, any>, appCode: string, operatorUserId: string, options?: RequestInit): Promise<T>;
+    postForm<T = any>(url: string, data: FormData, options?: RequestInit): Promise<T>;
+    put<T = any>(url: string, data?: any, options?: RequestInit, datasetCode?: string): Promise<T>;
+    delete<T = any>(url: string, options?: RequestInit, datasetCode?: string): Promise<T>;
+    request<T = any>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', url: string, data?: any, options?: RequestInit, datasetCode?: string): Promise<T>;
+}
+
+/**
+ * 脚本日志查询参数（`GET /api/dev/script-logs/search`）
+ */
+interface ScriptLogQuery {
+    /** 起始时间（毫秒时间戳） */
+    startTime: number;
+    /** 结束时间（毫秒时间戳） */
+    endTime: number;
+    /** 日志级别 */
+    level?: string;
+    /** 关键字 */
+    keyword?: string;
+    /** 返回条数上限 */
+    limit?: number;
+}
+/**
+ * 研发管理客户端（仅 cookie 会话态）。
+ *
+ * 后端脚本缓存与日志诊断接口只注册在 `/api` 下，未提供 `/client` 镜像。
+ */
+declare class ManagementClient {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    /** 清理脚本缓存（`POST /api/management/script/cache/clear`） */
+    clearScriptCache(): Promise<string>;
+    /** 查询脚本运行日志（`GET /api/dev/script-logs/search`） */
+    searchScriptLogs(query: ScriptLogQuery): Promise<string[]>;
+    private assertMode;
+}
+
+/**
+ * SQL 执行请求参数
+ */
+interface SqlExecuteRequest {
+    /** SQL 代码（字符串格式 "appCode-sqlId" 或数字 ID） */
+    sqlCode: string | number;
+    /** SQL 参数对象（可选） */
+    params?: Record<string, string | number>;
+}
+/**
+ * SQL 执行结果数据
+ */
+interface SqlExecuteResult<T = Record<string, any>> {
+    /** SQL 执行是否成功 */
+    execSuccess: boolean;
+    /** SQL 查询结果数组 */
+    execResult?: T[];
+    /** 写操作影响行数（后端 `SqlExecResult`）。 */
+    affectedRows?: number;
+}
+/**
+ * 通用分页结果（后端 `PageResult<T>`）
+ */
+interface PageResult<T> {
+    /** 当前页数据 */
+    records: T[];
+    /** 当前页码 */
+    currentPage?: number;
+    /** 每页条数 */
+    pageSize?: number;
+    /** 总条数 */
+    totalCount?: number;
+    /** 总页数 */
+    totalPages?: number;
+}
+/**
+ * 通用分页元信息（后端 `Paging`）
+ */
+interface Paging$1 {
+    currentPage?: number;
+    totalCount?: number;
+    pageSize?: number;
+}
+/**
+ * 通用数据列表（后端 `DataList<T>`）
+ */
+interface DataList<T> {
+    tableData: T[];
+    paging?: Paging$1;
+    tableColumns?: Array<Record<string, unknown>>;
+    execResult?: string;
+    extend?: unknown;
+}
+/**
+ * 自定义 SQL 列表查询参数（`POST /client/sql/query`）
+ */
+interface CustomSqlQueryRequest {
+    /** 自定义 SQL 主键 */
+    id?: number;
+    /** SQL 编码 */
+    sqlCode?: string;
+    /** 绑定的数据集主键 */
+    datasetId?: number;
+    /** SQL 内容 */
+    sqlContent?: string;
+    /** 查询参数 */
+    params?: Record<string, unknown>;
+    /** 是否驼峰输出，默认 false */
+    camelCaseFlag?: boolean;
+    /** 应用编码 */
+    appCode?: string;
+    /** SQL 名称（模糊匹配） */
+    sqlName?: string;
+    /** 当前页，默认 1 */
+    currentPage?: number;
+    /** 每页条数，默认 10 */
+    pageSize?: number;
+}
+/**
+ * 自定义 SQL 元信息（后端 `UserCustomSqlDTO`）
+ */
+interface UserCustomSqlDTO {
+    id?: number;
+    tenantCode?: string;
+    appCode?: string;
+    dbId?: number;
+    sqlName?: string;
+    sqlCode?: string;
+    sqlContent?: string;
+    sqlConfig?: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * 数据集查询参数（`POST /client/dataset/list`）
+ */
+interface DatasetRequest {
+    appCode?: string;
+    datasetId?: number;
+    code?: string;
+    name?: string;
+    tableName?: string;
+    deleted?: boolean;
+    currentPage?: number;
+    pageSize?: number;
+}
+/**
+ * 数据集元信息（后端 `Dataset`，仅列出 SDK 使用到的字段）
+ */
+interface DatasetMeta {
+    dbtableConfig?: {
+        dbId?: number;
+        tableName?: string;
+        datasetKey?: string;
+        pkField?: string;
+        allFields?: string;
+        [key: string]: unknown;
+    };
+    id?: number;
+    name?: string;
+    code?: string;
+    source?: string;
+    description?: string;
+    appCode?: string;
+    tableName?: string;
+    version?: number;
+    relations?: Record<string, unknown>;
+    columns?: Array<Record<string, unknown>>;
+    relationPages?: Array<Record<string, unknown>>;
+    operations?: Record<string, unknown>;
+    extend?: string;
+}
+/**
+ * 数据集驱动配置查询参数（`GET /client/dataset/get-driven-data`）
+ */
+interface DatasetDrivenDataQuery {
+    /** 数据集主键（与 code 至少提供一个） */
+    id?: number;
+    /** 数据集编码（与 id 至少提供一个） */
+    code?: string;
+}
+/**
+ * 用户信息
+ */
+interface User {
+    /** 用户代码 */
+    code: string;
+    /** 用户名 */
+    userName: string;
+    /** 昵称 */
+    nickName?: string | null;
+    /** 手机号 */
+    mobile: string;
+    /** 邮箱 */
+    email?: string | null;
+    /** 头像 */
+    avatar?: string | null;
+}
+
+/**
+ * 数据集元信息客户端（仅 client-ak 模式）。
+ *
+ * 后端 `DatasetClientController` 只注册在 `/client/dataset` 下；
+ * 数据集 CRUD 仍由 `ClientAkModel` 负责。
+ */
+declare class DatasetMetaClient {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    /** 查询数据集元信息（`POST /client/dataset/list`） */
+    list(request?: DatasetRequest): Promise<DatasetMeta[]>;
+    /**
+     * 按 code 查询单个数据集（`GET /client/dataset/query`）。
+     *
+     * @deprecated 后端已标记该接口待下线，请优先使用 `getDrivenData({ code })`。
+     */
+    queryByCode(code: string): Promise<DatasetMeta | null>;
+    /**
+     * 查询数据集驱动配置（`GET /client/dataset/get-driven-data`）。
+     *
+     * 返回结构随数据集 `doVersion` 不同：v1 为 `DatasetDrivenData`，v2 为 `DoProtocol`，
+     * 因此保持泛型由调用方声明。
+     */
+    getDrivenData<T = unknown>(query: DatasetDrivenDataQuery): Promise<T>;
+    private assertMode;
+}
+
+/**
+ * 登录用户信息（后端 `UserSessionHolder.getUser()` 返回的 `User`）。
+ */
+interface LoginUserInfo {
+    id?: string;
+    userId?: number;
+    username?: string;
+    nickname?: string;
+    name?: string | null;
+    mobile?: string;
+    email?: string;
+    avatar?: string;
+    appCode?: string;
+    tenantCode?: string;
+    roleType?: string;
+    roleId?: number;
+    roleName?: string;
+    roleCode?: string;
+    [key: string]: unknown;
+}
+/**
+ * 智能应用（后端 `SmartApp`，仅列出常用字段）
+ */
+interface SmartApp {
+    id?: number;
+    appCode?: string;
+    appName?: string;
+    tenantCode?: string;
+    appPublishStatus?: string;
+    appDesc?: string;
+    appLogo?: string;
+    appDomain?: string;
+    appOwnerId?: string;
+    appOwnerName?: string;
+    createTime?: string;
+    updateTime?: string;
+    [key: string]: unknown;
+}
+/**
+ * 外部账号绑定参数（后端 `UserAccountBindRequest`）
+ */
+interface UserAccountBindRequest {
+    provider: string;
+    accountId: string;
+}
+/**
+ * 通知渠道配置（后端 `NotificationChannelConfigViewDTO`）
+ */
+interface NotificationChannelConfig {
+    configCode?: string;
+    configName?: string;
+    channelType?: string;
+    description?: string;
+}
+/** Client AK 应用/用户接口配置；身份查询不需要 appCode。 */
+type AppClientConfig = Pick<ClientConfig, 'appCode' | 'runtimeDomain' | 'serverUrl' | 'env' | 'region' | 'options'> & {
+    accessKey: string;
+};
+/** 创建应用/用户客户端，适用于尚未选定应用的身份查询。 */
+declare function createAppClient(config: AppClientConfig): AppClient;
+/**
+ * 应用与用户配置客户端（仅 client-ak 模式）。
+ *
+ * 对应后端 `/client/app`、`/client/user`、`/client/user-accounts`、
+ * `/client/app-config`、`/client/notification/channel-config`，均无 `/api` 镜像。
+ */
+declare class AppClient {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string | undefined, authMode: AuthMode);
+    /** 当前用户可见的应用（`GET /client/app/my-apps`） */
+    myApps(): Promise<SmartApp[]>;
+    /** 当前登录用户信息（`GET /client/user/loginUserInfo`） */
+    loginUserInfo<T = LoginUserInfo>(): Promise<T>;
+    /** 绑定外部账号（`POST /client/user-accounts/bind`） */
+    bindAccount(request: UserAccountBindRequest): Promise<boolean>;
+    /** 按 key 读取应用配置（`GET /client/app-config/getByKey`） */
+    getConfigByKey<T = unknown>(key: string): Promise<T>;
+    /** 查询通知渠道配置（`GET /client/notification/channel-config/list`） */
+    listNotificationChannels(channelType?: string): Promise<NotificationChannelConfig[]>;
+    private assertMode;
+    private requireAppCode;
+}
+
+/**
+ * 审批任务列表查询参数
+ */
+interface ApprovalTodoQuery {
+    currentPage?: number;
+    pageSize?: number;
+}
+/** 审批任务转办候选人（后端 `ApprovalFlowTransferCandidateDTO`）。 */
+interface ApprovalFlowTransferCandidate {
+    userId?: string;
+    userName?: string | null;
+}
+/** 审批任务身份链接（后端 `ApprovalFlowIdentityLinkDTO`）。 */
+interface ApprovalFlowIdentityLink {
+    type?: string;
+    userId?: string | null;
+    groupId?: string | null;
+}
+/**
+ * 审批任务列表项（后端 `ApprovalFlowTaskItemDTO`，仅列出常用字段）
+ */
+interface ApprovalFlowTaskItem {
+    id?: string;
+    name?: string;
+    taskDefinitionKey?: string;
+    taskMode?: string;
+    assignee?: string;
+    assigneeName?: string;
+    transferCandidates?: ApprovalFlowTransferCandidate[];
+    handleMode?: string;
+    processInstanceId?: string;
+    flowCode?: string;
+    flowName?: string;
+    appCode?: string;
+    pageMode?: string;
+    initiatorUserId?: string;
+    initiatorUsername?: string;
+    datasetCode?: string;
+    pageId?: number;
+    path?: string;
+    operationType?: string;
+    dataId?: unknown;
+    detailUrl?: string;
+    taskStatus?: string;
+    processStatus?: string;
+    createTime?: number;
+    endTime?: number;
+    processStartTime?: number;
+    businessVariables?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * 审批任务详情（后端 `ApprovalFlowTaskDetailDTO`，仅列出常用字段）
+ */
+interface ApprovalFlowTaskDetail {
+    id?: string;
+    name?: string;
+    taskDefinitionKey?: string;
+    taskMode?: string;
+    assignee?: string;
+    assigneeName?: string;
+    transferCandidates?: ApprovalFlowTransferCandidate[];
+    processInstanceId?: string;
+    appCode?: string;
+    flowType?: string;
+    pageMode?: string;
+    path?: string;
+    detailUrl?: string;
+    dataId?: unknown;
+    createTime?: number;
+    endTime?: number;
+    status?: string;
+    canHandle?: boolean;
+    handleMode?: string;
+    canCancel?: boolean;
+    canWithdraw?: boolean;
+    canResubmit?: boolean;
+    canVoid?: boolean;
+    canReturn?: boolean;
+    canReturnToStarter?: boolean;
+    processStatus?: string;
+    returnReason?: string;
+    approvalRound?: number;
+    formData?: Record<string, unknown>;
+    businessVariables?: Record<string, unknown>;
+    formSchema?: Record<string, unknown>;
+    formPermissions?: Record<string, unknown>;
+    identityLinks?: ApprovalFlowIdentityLink[];
+    timeline?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * 审批办理参数（后端 `ApprovalFlowApproveRequestDTO`）
+ */
+interface ApprovalFlowApproveRequest {
+    appCode?: string;
+    /** Flowable 任务 id */
+    taskId: string;
+    /** true 通过，false 拒绝 */
+    approved: boolean;
+    /** 审批意见 */
+    comment?: string;
+    /** 当前节点可编辑字段的 Patch */
+    formPatch?: Record<string, unknown>;
+    /** 表单数据版本，必须原样回传 task 详情返回值 */
+    formDataVersion?: number;
+    /** 额外流程变量 */
+    variables?: Record<string, unknown>;
+}
+/**
+ * 审批转办参数（后端 `ApprovalFlowTransferRequestDTO`）
+ */
+interface ApprovalFlowTransferRequest {
+    appCode?: string;
+    taskId: string;
+    targetUserId: string;
+    comment?: string;
+}
+/**
+ * 审批任务客户端（仅 client-ak 模式）。
+ *
+ * 后端 `ApprovalFlowClientController` 只注册在 `/client` 下，没有 `/api` 镜像。
+ */
+declare class ApprovalClient {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    /** 查询当前用户待办（`GET /client/approve/todo`） */
+    listTodo(query?: ApprovalTodoQuery): Promise<PageResult<ApprovalFlowTaskItem>>;
+    /** 查询审批任务详情（`GET /client/flow/task/{taskId}`） */
+    getTask(taskId: string): Promise<ApprovalFlowTaskDetail>;
+    /** 通过或拒绝审批任务（`POST /client/flow/approve`） */
+    approve(request: ApprovalFlowApproveRequest): Promise<void>;
+    /** 转办审批任务（`POST /client/flow/task/transfer`） */
+    transfer(request: ApprovalFlowTransferRequest): Promise<void>;
+    private assertMode;
+}
+
+/**
+ * Artifact 创建/更新参数（后端 `ArtifactUpsertRequest`）
+ */
+interface ArtifactUpsertRequest {
+    appCode?: string;
+    /** 产物类型 */
+    artifactType?: string;
+    /** 产物名称 */
+    name?: string;
+    /** 产物内容 */
+    content?: string;
+    /** 结构化元信息 */
+    metadata?: Record<string, unknown>;
+    /** 产物来源 */
+    source?: string;
+}
+/**
+ * Artifact 列表筛选条件
+ */
+interface ArtifactListQuery {
+    artifactType?: string;
+    source?: string;
+    favorite?: boolean;
+}
+/**
+ * Artifact 详情（后端 `RuntimeArtifactDTO`）
+ */
+interface RuntimeArtifactDTO {
+    id?: number;
+    appCode?: string;
+    artifactType?: string;
+    name?: string;
+    content?: string;
+    compiledContent?: string;
+    metadata?: Record<string, unknown>;
+    source?: string;
+    favorite?: boolean;
+    deleted?: number;
+    createTime?: string;
+    updateTime?: string;
+    createUserId?: string;
+    updateUserId?: string;
+}
+/**
+ * Artifact 客户端（仅 client-ak 模式）。
+ *
+ * 后端只在 `/client/artifact` 暴露该能力，没有 `/api` 镜像。
+ */
+declare class ArtifactClient {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    /** 列出当前应用的 Artifact（`GET /client/artifact/list`） */
+    list(query?: ArtifactListQuery): Promise<RuntimeArtifactDTO[]>;
+    /** 获取 Artifact 详情（`GET /client/artifact/{id}`） */
+    get(id: number): Promise<RuntimeArtifactDTO | null>;
+    /** 创建 Artifact（`POST /client/artifact/create`） */
+    create(request: ArtifactUpsertRequest): Promise<RuntimeArtifactDTO>;
+    /** 更新 Artifact（`POST /client/artifact/{id}/update`） */
+    update(id: number, request: ArtifactUpsertRequest): Promise<RuntimeArtifactDTO>;
+    /** 更新收藏状态（`POST /client/artifact/{id}/favorite`） */
+    updateFavorite(id: number, favorite: boolean): Promise<RuntimeArtifactDTO>;
+    private assertMode;
+}
+
+/**
+ * 角色查询参数（后端 `AppRoleRequest`）
+ */
+interface AppRoleRequest {
+    id?: number;
+    appCode?: string;
+    roleId?: number;
+    roleName?: string;
+    currentPage?: number;
+    pageSize?: number;
+}
+/**
+ * 角色创建参数（后端 `AppRoleCreateParam`，仅允许 CUSTOM）
+ */
+interface AppRoleCreateParam {
+    appCode?: string;
+    roleType?: string;
+    roleName: string;
+    roleCode?: string;
+    permits?: Record<string, string[]>;
+    remark?: string;
+    extend?: string;
+}
+/**
+ * 角色更新参数（后端 `AppRoleUpdateParam`，仅允许 CUSTOM）
+ */
+interface AppRoleUpdateParam {
+    id: number;
+    appCode?: string;
+    roleType?: string;
+    roleName?: string;
+    roleCode?: string;
+    permits?: Record<string, string[]>;
+    remark?: string;
+    extend?: string;
+}
+/**
+ * 权限角色查询参数（后端 `AppRolePermitQueryParam`）
+ */
+interface AppRolePermitQueryParam {
+    appCode?: string;
+    /** 是否补充「仅自己」内置角色 */
+    needSelf?: boolean;
+    /** 是否补充「全部」内置角色 */
+    needPublic?: boolean;
+}
+/**
+ * 角色视图对象（后端 `AppRoleVO`）
+ */
+interface AppRoleVO {
+    id?: number;
+    appCode?: string;
+    roleName?: string;
+    roleCode?: string;
+    roleType?: string;
+    permits?: Record<string, string[]>;
+    remark?: string;
+    extend?: string;
+    userCount?: number;
+    permitCount?: number;
+    gmtCreate?: string;
+    gmtModified?: string;
+}
+/**
+ * 用户角色查询参数（后端 `UserAppRelationQueryParam`）
+ */
+interface UserAppRelationQueryParam {
+    appCode?: string;
+    userId?: string;
+    roleType?: string;
+    roleId?: number;
+    tenantCode?: string;
+}
+/**
+ * 应用用户基础信息（后端 `AppUserBaseVO`，字段随租户扩展）
+ */
+interface AppUserBaseVO {
+    userId?: string;
+    username?: string;
+    nickname?: string;
+    userName?: string;
+    nickName?: string;
+    mobile?: string;
+    email?: string;
+    avatar?: string;
+    [key: string]: unknown;
+}
+/**
+ * 角色与用户关联（后端 `AppRoleUserVO`）
+ */
+interface AppRoleUserVO {
+    id?: number;
+    roleName?: string;
+    roleCode?: string;
+    roleType?: string;
+    userList?: AppUserBaseVO[];
+    applyUserList?: AppUserBaseVO[];
+}
+/**
+ * 角色成员更新参数（后端 `RoleUserUpdateParam`）
+ */
+interface RoleUserUpdateParam {
+    appCode?: string;
+    roleList: AppRoleUserVO[];
+}
+/**
+ * 应用成员（后端 `YtEmployee`）
+ */
+interface AppEmployee {
+    code?: string | number;
+    userName?: string;
+    nickName?: string;
+    displayName?: string;
+    mobile?: string;
+    email?: string;
+    avatar?: string;
+    status?: string;
+    extend?: Record<string, unknown>;
+}
+/**
+ * 资源权限中的角色条目（后端 `BaseRoleVO`）
+ */
+interface BaseRoleVO {
+    id?: number;
+    roleName?: string;
+    roleCode?: string;
+    roleType?: string;
+    allowed?: boolean;
+}
+/**
+ * 资源权限（后端 `ResourcePermitDTO`）
+ */
+interface ResourcePermitDTO {
+    id?: number;
+    appCode?: string;
+    menuId?: number | null;
+    pageId?: number | null;
+    resourceCode?: string;
+    resourceType?: string;
+    resourceName?: string;
+    rolePermit?: BaseRoleVO[] | null;
+    dataPermit?: BaseRoleVO[] | null;
+    fieldPermit?: string;
+    extend?: string;
+    gmtCreate?: string;
+    gmtModified?: string;
+}
+/**
+ * 页面权限保存参数（后端 `MenuPermitDTO`）
+ */
+interface MenuPermitDTO {
+    menuId?: number;
+    pageId?: number;
+    appCode?: string;
+    datasetCode?: string;
+    menuPermit?: ResourcePermitDTO;
+    dataCreate?: ResourcePermitDTO | null;
+    dataUpdate?: ResourcePermitDTO | null;
+    dataDelete?: ResourcePermitDTO | null;
+    dataDetail?: ResourcePermitDTO | null;
+    dataExport?: ResourcePermitDTO | null;
+    dataPermit?: ResourcePermitDTO | null;
+}
+/**
+ * 资源菜单查询参数（后端 `AppResourceMenuParam`）
+ */
+interface AppResourceMenuParam {
+    appCode?: string;
+    roleId?: number;
+}
+/**
+ * 资源批量保存参数（后端 `ResourcePermitParam`）
+ */
+interface ResourcePermitParam {
+    appCode?: string;
+    permitList: ResourcePermitDTO[];
+}
+/**
+ * 菜单角色权限列表（后端 `MenuRolePermitListVO`）
+ */
+interface MenuRolePermitListVO {
+    permitList?: MenuRolePermitNodeVO[];
+}
+/** 按角色求值后的资源权限（后端 `AppPermitBaseVO`）。 */
+interface AppPermitBaseVO {
+    resourceType?: string;
+    resourceCode?: string;
+    resourceName?: string;
+    allowed?: boolean;
+    allowedActions?: string[];
+}
+/** 菜单及页面资源的权限求值结果（后端 `AppMenuPermitVO`）。 */
+interface AppMenuPermitVO extends AppPermitBaseVO {
+    appCode?: string;
+    menuType?: string;
+    pageId?: number | null;
+    pageNodeList?: AppPermitBaseVO[] | null;
+}
+/** 菜单角色权限树；未配置权限时 rolePermit/permitId 为 null。 */
+interface MenuRolePermitNodeVO {
+    id?: number;
+    parentId?: number;
+    label?: string;
+    type?: string | null;
+    path?: string;
+    pageId?: number | null;
+    permitId?: number | null;
+    rolePermit?: BaseRoleVO[] | null;
+    children?: MenuRolePermitNodeVO[];
+    [key: string]: unknown;
+}
+/** 数据集各动作按角色求值后的权限。 */
+interface AppDatasetPermitVO {
+    appCode?: string;
+    datasetCode?: string;
+    datasetName?: string;
+    dataPermitList?: AppPermitBaseVO[];
+}
+interface DatasetPermitListVO {
+    permitList?: AppDatasetPermitVO[];
+}
+/** 数据动作的原始角色配置，区别于按角色求值后的 allowed。 */
+interface AppDatasetActionRolePermitVO {
+    permitId?: number | null;
+    resourceType?: string;
+    resourceCode?: string;
+    resourceName?: string;
+    rolePermit?: BaseRoleVO[] | null;
+}
+interface AppDatasetRolePermitVO {
+    appCode?: string;
+    datasetCode?: string;
+    datasetName?: string;
+    dataPermitList?: AppDatasetActionRolePermitVO[];
+}
+interface DatasetRolePermitListVO {
+    permitList?: AppDatasetRolePermitVO[];
+}
+/**
+ * 运行态身份权限快照（后端 `RuntimeIdentityPermissionVO`）
+ */
+interface RuntimeIdentityPermission {
+    appCode?: string;
+    appExists?: boolean;
+    sampleEnabled?: boolean;
+    appRoles?: string[];
+    platformRoles?: string[];
+}
+/**
+ * 应用用户关系（后端 `UserAppRelationDTO`）
+ */
+interface UserAppRelation {
+    id?: number;
+    appCode?: string;
+    appName?: string;
+    userId?: string;
+    username?: string;
+    status?: string;
+    roleType?: string;
+    roleId?: number;
+    roleName?: string;
+    tenantCode?: string;
+    roleCode?: string;
+    approve?: string;
+}
+/**
+ * 权限、角色与成员客户端。
+ *
+ * 后端成对提供了 `/api/permit/*`、`/api/dept/*`、`/api/menu/*` 镜像 controller，
+ * 因此本类同时支持 cookie 与 client-ak 两种模式；OpenAPI 模式不支持。
+ */
+declare class PermitClient {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    /** 查询角色分页列表（`POST {prefix}/permit/role/get-list`） */
+    getRoleList<T = DataList<AppRoleVO>>(request?: AppRoleRequest): Promise<T>;
+    /** 创建自定义角色（`POST {prefix}/permit/role/create`） */
+    createRole(request: AppRoleCreateParam): Promise<AppRoleVO>;
+    /** 更新自定义角色（`POST {prefix}/permit/role/update`） */
+    updateRole(request: AppRoleUpdateParam): Promise<AppRoleVO>;
+    /** 删除自定义角色（`POST {prefix}/permit/role/delete`） */
+    deleteRole(roleId: number): Promise<void>;
+    /** 查询权限场景下的角色列表（`POST {prefix}/permit/role/get-permit-list`） */
+    getRolePermitList<T = BaseRoleVO[]>(request?: AppRolePermitQueryParam): Promise<T>;
+    /** 查询角色成员（`POST {prefix}/permit/user-role/get-user-list`） */
+    getRoleUserList<T = AppRoleUserVO[]>(request?: UserAppRelationQueryParam): Promise<T>;
+    /** 更新角色成员（`POST {prefix}/permit/user-role/update-user-list`） */
+    updateRoleUserList(request: RoleUserUpdateParam): Promise<void>;
+    /** 查询应用成员（`GET {prefix}/dept/queryAppUser`） */
+    queryAppUsers(): Promise<AppEmployee[]>;
+    /** 查询页面权限（`GET {prefix}/permit/page/get-one`） */
+    getPagePermit<T = MenuPermitDTO>(menuId: number): Promise<T>;
+    /** 保存页面权限（`POST {prefix}/permit/page/save`） */
+    savePagePermit(request: MenuPermitDTO): Promise<MenuPermitDTO>;
+    /** 查询资源菜单权限（`POST {prefix}/permit/resource/get-menu-list`） */
+    getResourceMenuList<T = AppMenuPermitVO[]>(request?: AppResourceMenuParam): Promise<T>;
+    /** 批量保存菜单权限（`POST {prefix}/permit/resource/batch-save-menu`） */
+    saveMenuPermits(request: ResourcePermitParam): Promise<void>;
+    /** 批量保存数据集权限（`POST {prefix}/permit/resource/batch-save-dataset`） */
+    saveDatasetPermits(request: ResourcePermitParam): Promise<void>;
+    /** 查询数据集权限列表（`GET {prefix}/permit/dataset/list`） */
+    getDatasetPermitList<T = DatasetPermitListVO>(roleId: number): Promise<T>;
+    /** 查询数据集权限元信息（`GET {prefix}/permit/dataset/permit-list`） */
+    getDatasetPermitMeta<T = DatasetRolePermitListVO>(): Promise<T>;
+    /** 查询菜单角色权限列表（`GET {prefix}/menu/permit-list`） */
+    getMenuPermitList<T = MenuRolePermitListVO>(): Promise<T>;
+    /**
+     * 查询当前用户的运行态应用权限（`POST /client/permit/identity/resolve`）。
+     *
+     * 后端仅在 `/client` 注册该接口，cookie 模式下会 fail-closed。
+     */
+    resolveIdentity(): Promise<RuntimeIdentityPermission>;
+    /**
+     * 应用邀请审批回调（`POST /api/user/app-invite-callback` 或 `/client/user/app-invite-callback`）。
+     */
+    appInviteCallback(request?: UserAppRelation): Promise<boolean>;
+    private path;
+    /** 后端多数参数要求显式 appCode；调用方可以覆盖。 */
+    private withAppCode;
+}
+
+/**
+ * BFF 客户端请求参数
+ */
+interface ClientAkBffExecuteRequest {
+    /** 脚本名称（endpoint 函数名） */
+    scriptName: string;
+    /** 请求体参数（可选），序列化为 JSON 作为 POST body */
+    params?: Record<string, any>;
+    /** Fetch 请求选项（可选） */
+    options?: RequestInit;
+}
+/**
+ * 脚本端点摘要（后端 `EndpointScriptSummaryDTO`）
+ */
+interface EndpointScriptSummary {
+    id?: number;
+    appCode?: string;
+    functionName?: string;
+    description?: string;
+    version?: number;
+    gmtModified?: number;
+}
+/**
+ * 脚本详情（后端 `ScriptDefinitionDTO`）
+ */
+interface ScriptDefinition {
+    id?: number;
+    appCode?: string;
+    functionName?: string;
+    functionNode?: string;
+    scriptType?: string;
+    description?: string;
+    scriptContent?: string;
+    dependencyRefs?: string;
+    enableTransaction?: boolean;
+    apiPattern?: string;
+    operationType?: string;
+    version?: number;
+    [key: string]: unknown;
+}
+/**
+ * Client AK BFF 客户端 ——「执行 BFF 独立端点」（client-ak 模式）。
+ *
+ * **与自定义 SQL 无关**（SQL 见 `ClientAkSqlClient` / `client.sql.execute` → `POST /client/sql/execute`）。
+ *
+ * 与服务端约定一致（路径中拼写为 **excute**，非 execute）：
+ * `POST /client/bff/excute/{appCode}/{scriptName}`
+ * - Header：`X-User-AK`、`Content-Type: application/json`（由 HttpClient 注入）
+ * - Body：业务 JSON，例如 `{ "testCase": "basic_insert" }` → 对应本类 `params`
+ *
+ * 示例：`appCode=app-cf50ad43`，`scriptName=sqlTest` →
+ * `POST .../client/bff/excute/app-cf50ad43/sqlTest`，body `{ "testCase": "basic_insert" }`。
+ */
+declare class ClientAkBffClient {
+    private httpClient;
+    private appCode;
+    constructor(httpClient: HttpClient, appCode: string);
+    execute<T = any>(request: ClientAkBffExecuteRequest): Promise<T>;
+    /**
+     * 按函数名查询独立端点脚本摘要（`GET /client/bff/endpoint/{appCode}/{functionName}`）。
+     *
+     * 脚本不存在或为 personalOnly 时后端返回 `null`，SDK 原样透传。
+     */
+    getEndpoint(functionName: string): Promise<EndpointScriptSummary | null>;
+    /**
+     * 查询当前应用下全部独立端点脚本（`GET /client/bff/endpoint/{appCode}/functions`）。
+     */
+    listEndpoints(): Promise<EndpointScriptSummary[]>;
+    /**
+     * 按脚本主键查询脚本详情（`GET /client/bff/query/{scriptId}`）。
+     *
+     * personalOnly 脚本仅创建者本人可读，其他用户会被后端拒绝。
+     */
+    getScript<T = ScriptDefinition>(scriptId: number): Promise<T>;
+}
+
+/**
+ * BFF 客户端请求参数
+ */
+interface BffExecuteRequest {
+    /** 脚本名称（endpoint 函数名） */
+    scriptName: string;
+    /** 请求体参数（可选） */
+    params?: Record<string, any>;
+    /** Fetch 请求选项（可选） */
+    options?: RequestInit;
+}
+/**
+ * BFF 客户端 - 调用 Backend For Frontend 端点
+ *
+ * 与其他 SDK 接口保持一致的响应处理逻辑：
+ * - 成功：返回 data（业务数据）
+ * - 失败：抛出 LovrabetError 异常（由 processResponse 处理）
+ *
+ * @example
+ * ```typescript
+ * // 无参数调用
+ * const templates = await client.bff.execute({
+ *   scriptName: 'getBundleTemplates'
+ * });
+ * templates.forEach(template => console.log(template.name));
+ *
+ * // 带参数调用
+ * const price = await client.bff.execute({
+ *   scriptName: 'calculatePrice',
+ *   params: { productId: '123', quantity: 10 }
+ * });
+ * console.log('Price:', price);
+ *
+ * // 带 Fetch 选项
+ * const result = await client.bff.execute({
+ *   scriptName: 'getData',
+ *   params: { id: '123' },
+ *   options: { headers: { 'X-Custom-Header': 'value' } }
+ * });
+ *
+ * // 带类型提示
+ * interface BundleTemplate {
+ *   id: string;
+ *   name: string;
+ *   items: string[];
+ * }
+ * const templates = await client.bff.execute<BundleTemplate>({
+ *   scriptName: 'getBundleTemplates'
+ * });
+ * ```
+ */
+declare class BffClient {
+    private httpClient;
+    private appCode;
+    constructor(httpClient: HttpClient, appCode: string);
+    /**
+     * 调用 Backend For Frontend (BFF) 端点
+     *
+     * @param request 请求参数
+     * @returns BFF 函数返回的业务数据
+     * @throws {LovrabetError} 当 HTTP 请求失败时抛出异常
+     */
+    execute<T = any>(request: BffExecuteRequest): Promise<T>;
+}
+
+/**
+ * Client AK SQL 客户端 - 执行自定义 SQL 查询（client-ak 模式）
+ *
+ * 端点：`POST /client/sql/execute`，请求体：`{ sqlCode, params? }`（与运行态技术文档 curl 一致）。
+ * 鉴权：X-User-AK（由 HttpClient 通过 AuthManager 自动注入）。
+ *
+ * BFF 调用请使用 `ClientAkBffClient`，勿与本类混用。
+ */
+declare class ClientAkSqlClient {
+    private httpClient;
+    private appCode?;
+    constructor(httpClient: HttpClient, appCode?: string);
+    execute<T = Record<string, any>>(sqlCode: string | number, params?: Record<string, string | number>): Promise<SqlExecuteResult<T>>;
+    execute<T = Record<string, any>>(options: {
+        sqlCode: string | number;
+        params?: Record<string, string | number>;
+    }): Promise<SqlExecuteResult<T>>;
+    /**
+     * 分页查询自定义 SQL 元信息（`POST /client/sql/query`）。
+     *
+     * 与 `execute` 不同：这里只查询 SQL 定义列表，不执行 SQL。
+     */
+    query(request?: CustomSqlQueryRequest): Promise<DataList<UserCustomSqlDTO>>;
+    /**
+     * 查询当前应用下全部自定义 SQL（`GET /client/sql/list/{appCode}`）。
+     *
+     * 与 `query` 不同：该接口不分页、不接收筛选条件，返回完整列表。
+     */
+    listSqls(): Promise<UserCustomSqlDTO[]>;
+}
+
+/**
+ * OpenAPI SQL 客户端 - 执行自定义 SQL 查询（OpenAPI 模式）
+ *
+ * OpenAPI 模式的参数格式：
+ * - Body: { sqlCode, paramMap }
+ * - Headers: X-App-Code, X-Dataset-Code, X-Token, X-Time-Stamp（由 HttpClient 自动添加）
+ *
+ * 注意：
+ * - custom-sql 业务上不绑定特定数据集（可能跨多个数据集）
+ * - 但 OpenAPI 认证需要 datasetCode 来生成 token
+ * - 解决方案：自动使用配置的第一个数据集的 datasetCode
+ *
+ * @example
+ * ```typescript
+ * // 推荐：对象参数
+ * const data = await client.sql.execute({
+ *   sqlCode: '8cbdd953-8d5fa8e5',
+ *   params: { storeId: 1 }
+ * });
+ *
+ * // 兼容：直接传参
+ * const data = await client.sql.execute('8cbdd953-8d5fa8e5', { storeId: 1 });
+ *
+ * // 带类型提示
+ * interface OrderStat {
+ *   driver_name: string;
+ *   total_completed: number;
+ *   total_payment: number;
+ * }
+ * const data = await client.sql.execute<OrderStat>({
+ *   sqlCode: '8cbdd953-8d5fa8e5',
+ *   params: { storeId: 1 }
+ * });
+ * ```
+ */
+declare class OpenApiSqlClient {
+    private httpClient;
+    private config;
+    constructor(httpClient: HttpClient, config: ClientConfig);
+    /**
+     * 自动获取第一个数据集的 datasetCode
+     * 用于 OpenAPI token 生成（业务上 custom-sql 不绑定数据集，但 token 计算需要）
+     */
+    private getFirstDatasetCode;
+    /**
+     * 执行自定义 SQL 查询
+     *
+     * 支持两种调用方式：
+     * 1. execute({ sqlCode, params }) - 对象参数（推荐）
+     * 2. execute(sqlCode, params) - 直接传参（兼容）
+     *
+     * @returns SQL执行结果（包含 execSuccess 和 execResult）
+     */
+    execute<T = Record<string, any>>(sqlCode: string | number, params?: Record<string, string | number>): Promise<SqlExecuteResult<T>>;
+    execute<T = Record<string, any>>(options: {
+        sqlCode: string | number;
+        params?: Record<string, string | number>;
+    }): Promise<SqlExecuteResult<T>>;
+}
+
+/**
+ * SQL 客户端 - 执行自定义 SQL 查询（WebAPI 模式）
+ *
+ * WebAPI 模式的参数格式：
+ * - Body: { sqlCode, params }
+ * - 使用 Cookie 认证
+ *
+ * @example
+ * ```typescript
+ * // 推荐：对象参数
+ * const data = await client.sql.execute({
+ *   sqlCode: 'fc8e7777-06e3847d',
+ *   params: { userId: '123', startDate: '2025-01-01' }
+ * });
+ *
+ * // 兼容：直接传参
+ * const data = await client.sql.execute('fc8e7777-06e3847d', {
+ *   userId: '123',
+ *   startDate: '2025-01-01'
+ * });
+ *
+ * // 带类型提示
+ * interface PageStat {
+ *   creation_date: string;
+ *   page_count: number;
+ * }
+ * const data = await client.sql.execute<PageStat>({
+ *   sqlCode: 'fc8e7777-06e3847d'
+ * });
+ * ```
+ */
+declare class SqlClient {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * 执行自定义 SQL 查询
+     *
+     * 支持两种调用方式：
+     * 1. execute({ sqlCode, params }) - 对象参数（推荐）
+     * 2. execute(sqlCode, params) - 直接传参（兼容）
+     *
+     * @returns SQL执行结果（包含 execSuccess 和 execResult）
+     */
+    execute<T = Record<string, any>>(sqlCode: string | number, params?: Record<string, string | number>): Promise<SqlExecuteResult<T>>;
+    execute<T = Record<string, any>>(options: {
+        sqlCode: string | number;
+        params?: Record<string, string | number>;
+    }): Promise<SqlExecuteResult<T>>;
+}
+
+/** Per-request options supported by personal resource clients. */
+type PersonalRequestOptions = Omit<RequestInit, "method" | "body">;
+/** Input accepted when executing a personal BFF. */
+interface PersonalBffExecuteRequest {
+    /** Positive integer identifier of the personal BFF script. */
+    scriptId: number;
+    /** Parameters passed to the personal BFF script. */
+    params?: Record<string, unknown>;
+    /** Optional fetch settings. The HTTP method and body are controlled by the SDK. */
+    options?: PersonalRequestOptions;
+}
+/** Input accepted when creating or updating a personal BFF. */
+interface PersonalBffUpsertRequest {
+    /** Function name exposed by the personal BFF. */
+    functionName?: string;
+    /** Human readable description. */
+    description?: string;
+    /** Script content. */
+    scriptContent?: string;
+    /** Session that produced the script, used for traceability. */
+    sourceSessionId?: string;
+}
+/** Personal BFF metadata (backend `AppScriptDTO`, only common fields). */
+interface PersonalBffScript {
+    id?: number;
+    appCode?: string;
+    scriptType?: string;
+    scriptContent?: string;
+    dependencyRefs?: unknown;
+    description?: string;
+    functionName?: string;
+    functionNode?: unknown;
+    version?: number;
+    enableTransaction?: boolean;
+    config?: Record<string, unknown>;
+    createUserId?: string;
+    updateUserId?: string;
+    gmtCreate?: string;
+    gmtModified?: string;
+    [key: string]: unknown;
+}
+interface PersonalBffService {
+    execute<T = unknown>(request: PersonalBffExecuteRequest): Promise<T>;
+    list(): Promise<PersonalBffScript[]>;
+    get<T = PersonalBffScript>(scriptId: number): Promise<T>;
+    create<T = PersonalBffScript>(request: PersonalBffUpsertRequest): Promise<T>;
+    update<T = PersonalBffScript>(scriptId: number, request: PersonalBffUpsertRequest): Promise<T>;
+}
+/** Personal resources exposed under `client.personal`. */
+interface LovrabetPersonal {
+    readonly bff: PersonalBffService;
+}
+
+type FlowRecord = Record<string, any>;
+/** SDK 可见的独立流程定义；服务端只返回业务自定义页面类型。 */
+interface FlowCustomPageDefinition {
+    flowCode: string;
+    flowName?: string;
+    flowDesc?: string;
+    version?: number;
+    pageMode: "CUSTOM_PAGE";
+}
+/** 业务自定义页面独立流程的发起结果。 */
+interface FlowCustomPageStartResponse {
+    flowCode: string;
+    processInstanceId: string;
+    idempotentReplay?: boolean;
+}
+/** 业务自定义页面独立流程的待办或已办列表项。 */
+interface FlowCustomPageTaskItem {
+    taskId: string;
+    taskName?: string;
+    taskDefinitionKey?: string;
+    taskMode?: string;
+    assignee?: string;
+    assigneeName?: string;
+    handleMode?: string;
+    transferCandidates?: FlowRecord[];
+    processInstanceId: string;
+    flowCode?: string;
+    flowName?: string;
+    initiatorUserId?: string;
+    initiatorUsername?: string;
+    taskStatus?: string;
+    processStatus?: string;
+    createTime?: number;
+    endTime?: number;
+    processStartTime?: number;
+    businessVariables?: FlowRecord;
+}
+/** 业务自定义页面独立流程的已发起列表项。 */
+interface FlowCustomPageSubmittedProcess {
+    processInstanceId: string;
+    flowCode?: string;
+    flowName?: string;
+    startTime?: number;
+    endTime?: number;
+    status?: string;
+    cancelReason?: string;
+    currentNodeNames?: string[];
+    currentNodes?: FlowRecord[];
+    nextNodes?: FlowRecord[];
+    businessVariables?: FlowRecord;
+}
+/** 不包含数据集、平台页面或业务数据主键的独立流程轨迹。 */
+interface FlowCustomPageTimeline {
+    processInstanceId: string;
+    flowCode?: string;
+    flowName?: string;
+    startUserId?: string;
+    startUserName?: string;
+    startTime?: number;
+    endTime?: number;
+    status?: string;
+    cancelReason?: string;
+    canCancel: boolean;
+    canWithdraw: boolean;
+    canResubmit: boolean;
+    canVoid: boolean;
+    approvalRound?: number;
+    steps?: FlowRecord[];
+    flowDiagram?: FlowRecord;
+}
+/** 业务自定义页面独立流程详情；保留 formData，不返回平台表单渲染配置。 */
+interface FlowCustomPageTaskDetail {
+    taskId?: string;
+    taskName?: string;
+    taskDefinitionKey?: string;
+    taskMode?: string;
+    assignee?: string;
+    assigneeName?: string;
+    processInstanceId: string;
+    flowCode?: string;
+    flowName?: string;
+    initiatorUserId?: string;
+    initiatorUsername?: string;
+    taskCreateTime?: number;
+    taskEndTime?: number;
+    processStartTime?: number;
+    processEndTime?: number;
+    taskStatus?: string;
+    processStatus?: string;
+    canHandle: boolean;
+    handleMode?: string;
+    canCancel: boolean;
+    canWithdraw: boolean;
+    canResubmit: boolean;
+    canVoid: boolean;
+    canReturn: boolean;
+    returnTargets?: FlowReturnTarget[];
+    approvalRound?: number;
+    transferCandidates?: FlowRecord[];
+    formData?: FlowRecord;
+    businessVariables?: FlowRecord;
+    timeline?: FlowCustomPageTimeline;
+}
+interface FlowCustomPageCcDetail {
+    ccRecord: FlowRecord;
+    processDetail: FlowCustomPageTaskDetail;
+    approvalRecords: FlowRecord;
+}
+interface FlowPage<T = FlowRecord> {
+    records: T[];
+    currentPage: number;
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+}
+interface FlowPageQuery {
+    currentPage?: number;
+    pageSize?: number;
+}
+interface FlowVariableProjectionQuery extends FlowPageQuery {
+    /** 指定响应 businessVariables 中需要返回的普通业务变量名。 */
+    variableKeys?: string[];
+}
+interface FlowVariableQuery extends FlowVariableProjectionQuery {
+    /** 按流程变量精确匹配；服务端会屏蔽 sys 前缀变量。 */
+    variables?: FlowRecord;
+}
+interface FlowSubmittedQuery extends FlowVariableProjectionQuery {
+    status?: string;
+}
+interface FlowDefinitionQuery extends FlowPageQuery {
+    flowName?: string;
+}
+interface FlowStartRequest {
+    flowCode: string;
+    formData?: FlowRecord;
+    variables?: FlowRecord;
+    /** 同一应用内相同幂等键返回首次创建的流程实例。 */
+    idempotencyKey?: string;
+}
+interface FlowUpdateVariablesRequest {
+    processInstanceId: string;
+    /** 可设置普通业务变量，也可包含 formData；系统变量不可修改。 */
+    set?: FlowRecord;
+    /** 仅允许删除普通业务变量。 */
+    remove?: string[];
+}
+interface FlowTaskActionRequest {
+    taskId: string;
+    formPatch?: FlowRecord;
+    formDataVersion?: number;
+    variables?: FlowRecord;
+    comment?: string;
+}
+interface FlowBatchTaskActionRequest {
+    taskIds: string[];
+    comment?: string;
+    variables?: FlowRecord;
+}
+interface FlowTransferRequest {
+    taskId: string;
+    targetUserId: string;
+    comment?: string;
+}
+interface FlowBatchTransferRequest {
+    taskIds: string[];
+    targetUserId: string;
+    comment?: string;
+}
+interface FlowProcessReasonRequest {
+    processInstanceId: string;
+    reason?: string;
+}
+interface FlowResubmitRequest {
+    processInstanceId: string;
+    formPatch?: FlowRecord;
+    /** 重新提交时同步更新的普通业务流程变量；系统变量仍由 Runtime 拒绝。 */
+    variables?: FlowRecord;
+    /** 动态表单流程必填；非动态表单或没有版本号的自定义页面流程可省略。 */
+    formDataVersion?: number;
+    comment?: string;
+}
+interface FlowReturnRequest {
+    taskId: string;
+    targetNodeId: string;
+    reason?: string;
+}
+interface FlowCcRequest {
+    processInstanceId: string;
+    taskId?: string;
+    recipientUserIds: string[];
+    comment?: string;
+    /** 调用方幂等请求号。 */
+    requestId?: string;
+}
+interface FlowCcQuery extends FlowPageQuery {
+    readStatus?: string;
+}
+interface FlowReturnTarget {
+    nodeId: string;
+    nodeName: string;
+}
+
+/** 使用当前登录用户身份的独立流程自定义页面客户端。 */
+declare class LovrabetFlowClient {
+    private readonly httpClient;
+    private readonly appCode;
+    constructor(httpClient: HttpClient, appCode: string);
+    start<T = FlowCustomPageStartResponse>(request: FlowStartRequest): Promise<T>;
+    listTodo<T = FlowCustomPageTaskItem>(query?: FlowVariableQuery): Promise<FlowPage<T>>;
+    listAppTodo<T = FlowCustomPageTaskItem>(query?: FlowVariableQuery): Promise<FlowPage<T>>;
+    listDone<T = FlowCustomPageTaskItem>(query?: FlowVariableQuery): Promise<FlowPage<T>>;
+    listAppDone<T = FlowCustomPageTaskItem>(query?: FlowVariableQuery): Promise<FlowPage<T>>;
+    listSubmitted<T = FlowCustomPageSubmittedProcess>(query?: FlowSubmittedQuery): Promise<FlowPage<T>>;
+    listAppSubmitted<T = FlowCustomPageSubmittedProcess>(query?: FlowSubmittedQuery): Promise<FlowPage<T>>;
+    /** 列出 SDK 可发起的独立流程；服务端仅返回 CUSTOM_PAGE。 */
+    listIndependentFlows<T = FlowCustomPageDefinition>(query?: FlowDefinitionQuery): Promise<FlowPage<T>>;
+    getTaskDetail<T = FlowCustomPageTaskDetail>(taskId: string, variableKeys?: string[]): Promise<T>;
+    getProcessDetail<T = FlowCustomPageTaskDetail>(processInstanceId: string, variableKeys?: string[]): Promise<T>;
+    getCurrentTask<T = FlowCustomPageTaskDetail>(processInstanceId: string, variableKeys?: string[]): Promise<T>;
+    getTimeline<T = FlowCustomPageTimeline>(processInstanceId: string): Promise<T>;
+    getRecords<T = FlowRecord>(processInstanceId: string): Promise<T>;
+    updateVariables(request: FlowUpdateVariablesRequest): Promise<void>;
+    approve(request: FlowTaskActionRequest): Promise<void>;
+    reject(request: FlowTaskActionRequest): Promise<void>;
+    complete(request: FlowTaskActionRequest): Promise<void>;
+    batchApprove<T = FlowRecord>(request: FlowBatchTaskActionRequest): Promise<T>;
+    batchReject<T = FlowRecord>(request: FlowBatchTaskActionRequest): Promise<T>;
+    transfer(request: FlowTransferRequest): Promise<void>;
+    batchTransfer<T = FlowRecord>(request: FlowBatchTransferRequest): Promise<T>;
+    cancel(request: FlowProcessReasonRequest): Promise<void>;
+    withdraw(request: FlowProcessReasonRequest): Promise<void>;
+    resubmit(request: FlowResubmitRequest): Promise<void>;
+    getReturnTargets(taskId: string): Promise<FlowReturnTarget[]>;
+    returnTask(request: FlowReturnRequest): Promise<void>;
+    voidProcess(request: FlowProcessReasonRequest): Promise<void>;
+    ccProcess<T = FlowRecord>(request: FlowCcRequest): Promise<T[]>;
+    listCc<T = FlowRecord>(query?: FlowCcQuery): Promise<FlowPage<T>>;
+    getCcDetail<T = FlowCustomPageCcDetail>(ccRecordId: number | string): Promise<T>;
+    markCcRead(ccRecordId: number | string): Promise<void>;
+    private completeTask;
+    private completeTasks;
+    private processReason;
+    private executePage;
+    private executeCustomPage;
+    private post;
+}
+
+/** Per-request options supported by runtime service clients. */
+type ServiceRequestOptions = Omit<RequestInit, "method" | "body">;
+/**
+ * OCR recognition types supported by the runtime service.
+ *
+ * This is a runtime value as well as the source of the `OcrType` type, so
+ * JavaScript and TypeScript callers can both avoid handwritten strings.
+ */
+declare const OcrType: Readonly<{
+    readonly General: "General";
+    readonly Invoice: "Invoice";
+    readonly Advanced: "Advanced";
+    readonly AdvancedCoordinate: "AdvancedCoordinate";
+    readonly AdvancedGeneral: "AdvancedGeneral";
+    readonly IdCard: "IdCard";
+    readonly BankCard: "BankCard";
+    readonly BusinessLicense: "BusinessLicense";
+    readonly DrivingLicense: "DrivingLicense";
+    readonly CarNumber: "CarNumber";
+    readonly Table: "Table";
+}>;
+type OcrType = (typeof OcrType)[keyof typeof OcrType];
+/** Read-only OCR type list for selects, discovery, and schema generation. */
+declare const OCR_TYPES: readonly OcrType[];
+/** Input accepted by the public OCR service. */
+interface OcrRecognizeRequest {
+    /** Publicly accessible image or file URL. */
+    url: string;
+    /** Runtime OCR recognition type. */
+    type: OcrType;
+    /** Optional fetch settings. The HTTP method and body are controlled by the SDK. */
+    options?: ServiceRequestOptions;
+}
+/** OCR result returned by both the WebAPI and Client API routes. */
+interface OcrRecognizeResponse {
+    requestId?: string;
+    type?: OcrType;
+    text?: string;
+    lines?: string[];
+    kvData?: Record<string, string>;
+    width?: number;
+    height?: number;
+    pageNo?: number | null;
+    subImageCount?: number | null;
+    algoVersion?: string | null;
+    kvExcelUrl?: string | null;
+    xmlResult?: string | null;
+    rawData?: string | null;
+    [key: string]: unknown;
+}
+interface OcrService {
+    recognize(request: OcrRecognizeRequest): Promise<OcrRecognizeResponse>;
+}
+/** Input accepted by the runtime file upload service. */
+interface FileUploadRequest {
+    /** Browser File or a standards-compatible Blob. */
+    file: Blob;
+    /** Optional filename for Blob inputs. File.name is used when available. */
+    fileName?: string;
+    options?: ServiceRequestOptions;
+}
+interface FileUploadResponse {
+    fileName?: string | null;
+    filePath?: string | null;
+    fileUrl?: string | null;
+    downloadFlag?: boolean;
+    longTerm?: boolean;
+    fileType?: string | null;
+    size?: number | null;
+    sourceDir?: string | null;
+    [key: string]: unknown;
+}
+interface FileQueryUrlRequest {
+    /** Durable filePath returned by upload. */
+    filePath: string;
+    /** Request a download URL instead of a preview URL. */
+    download?: boolean;
+    /** Request a long-term URL for URL-only content embedding. */
+    longTerm?: boolean;
+    options?: ServiceRequestOptions;
+}
+interface FileUrlResponse {
+    fileName?: string | null;
+    filePath?: string | null;
+    fileUrl?: string | null;
+    downloadFlag?: boolean;
+    longTerm?: boolean;
+    expiresInDays?: number | null;
+    [key: string]: unknown;
+}
+interface FileService {
+    upload(request: FileUploadRequest): Promise<FileUploadResponse>;
+    queryUrl(request: FileQueryUrlRequest): Promise<FileUrlResponse>;
+}
+/** Runtime services exposed under `client.services`. */
+interface LovrabetServices {
+    readonly ocr: OcrService;
+    readonly file: FileService;
+}
+
+interface OpenApiAuthContext {
+    timestamp: number;
+    token: string;
+    headers: AuthHeaders;
+}
+
+declare const GENERATED_REGION_API_ENDPOINTS: {
+    readonly cn: {
+        readonly production: "https://runtime.lovrabet.com";
+        readonly online: "https://runtime.lovrabet.com";
+        readonly development: "https://dev.lovrabet.com";
+        readonly daily: "https://daily-runtime.lovrabet.com";
+    };
+    readonly id: {
+        readonly production: "https://runtime.lovrabet.id";
+        readonly online: "https://runtime.lovrabet.id";
+        readonly development: "https://dev.lovrabet.id";
+    };
+};
+
+/**
+ * Lovrabet SDK 核心类型定义
+ *
+ * 本文件包含 SDK 的所有核心类型定义，包括：
+ * - 环境配置类型
+ * - 请求和响应类型
+ * - 模型配置类型
+ * - 客户端配置类型
+ * - 认证相关类型
+ */
+/**
+ * 环境类型定义
+ * @description 支持的运行环境，用于区分不同的 API 端点
+ * - production: 线上环境（推荐使用）
+ * - online: 线上环境（向下兼容，等同于 production）
+ * - daily: 日常/测试环境
+ * - development: 本地开发环境
+ */
+type Environment$1 = "production" | "online" | "daily" | "development";
+/** Official Lovrabet Runtime region. Mainland China is the default. */
+type Region = keyof typeof GENERATED_REGION_API_ENDPOINTS;
+/**
+ * 排序方向枚举
+ * @description 定义数据排序的方向
+ */
+declare enum SortOrder {
+    /** 升序 */
+    ASC = "asc",
+    /** 降序 */
+    DESC = "desc"
+}
+/**
+ * 排序方向类型（同时支持枚举和字符串）
+ * @description 支持使用 SortOrder.ASC/DESC 或直接使用 "asc"/"desc" 字符串
+ */
+type SortOrderValue = SortOrder | "asc" | "desc";
+/**
+ * 排序配置类型
+ * @description 定义排序规则的 key-value 格式，key 为字段名，value 为排序方向
+ * @example
+ * ```typescript
+ * // 使用枚举
+ * const sortList1: SortList = [
+ *   { "id": SortOrder.DESC },
+ *   { "name": SortOrder.ASC }
+ * ];
+ *
+ * // 使用字符串（更简洁）
+ * const sortList2: SortList = [
+ *   { "id": "desc" },
+ *   { "name": "asc" }
+ * ];
+ * ```
+ */
+type SortList = Record<string, SortOrderValue>[];
+/**
+ * 列表查询参数接口
+ * @description 用于分页查询的通用参数接口
+ */
+interface ListParams {
+    /** 当前页码，从 1 开始 */
+    currentPage?: number;
+    /** 每页数量 */
+    pageSize?: number;
+    /** 其他查询参数，支持任意字段 */
+    [key: string]: any;
+}
+/**
+ * 分页信息（服务端原始格式）
+ */
+interface Paging {
+    /** 当前页码 */
+    currentPage: number;
+    /** 总数量 */
+    totalCount: number;
+    /** 每页数量 */
+    pageSize: number;
+}
+/**
+ * 列表响应数据接口
+ * @template T 数据项的类型
+ * @description 与服务端 data 结构完全对应
+ *
+ * 读取总数/当前页/页大小使用 paging：
+ * - result.paging.totalCount
+ * - result.paging.currentPage
+ * - result.paging.pageSize
+ */
+interface ListResponse<T> {
+    /** 数据列表 */
+    tableData: T[];
+    /** 分页信息 */
+    paging: Paging;
+    /** 列定义 */
+    tableColumns: any[];
+    /** 执行结果（一般为 null） */
+    execResult?: any;
+    /** 扩展信息（creator / modifier 等） */
+    extend?: Record<string, any>;
+}
+/**
+ * 条件操作符类型
+ * @description 用于构建查询条件的操作符
+ *
+ * 支持的操作符：
+ * - $eq: 等于
+ * - $ne: 不等于
+ * - $gt: 大于
+ * - $lt: 小于
+ * - $gte: 大于等于（推荐）；$gteq 为兼容旧写法的别名，后端同样映射为 >=
+ * - $lte: 小于等于（推荐）；$lteq 为兼容旧写法的别名，后端同样映射为 <=
+ * - $in: 在集合内
+ * - $contain: 包含（模糊匹配）
+ * - $startWith: 以...开头
+ * - $endWith: 以...结尾
+ * - $notNull: 非空判断
+ */
+type ConditionOperator = "$eq" | "$ne" | "$gt" | "$lt" | "$gte" | "$gteq" | "$lte" | "$lteq" | "$in" | "$contain" | "$startWith" | "$endWith" | "$notNull";
+/**
+ * 字段条件类型
+ * @description 单个字段的查询条件
+ * @example
+ * ```typescript
+ * // 等于
+ * { age: { $eq: 18 } }
+ * // 区间
+ * { age: { $gte: 18, $lte: 45 } }
+ * // 包含
+ * { country: { $in: ['中国', '美国', '日本'] } }
+ * // 模糊匹配
+ * { name: { $contain: 'hello' } }
+ * // 非空判断
+ * { app_code: { $notNull: true } }
+ * ```
+ */
+type FieldCondition = {
+    [K in ConditionOperator]?: any;
+};
+/**
+ * Where 条件类型
+ * @description 支持字段条件和逻辑连接符的递归定义
+ */
+type WhereCondition = {
+    $and?: WhereCondition[];
+    $or?: WhereCondition[];
+    [field: string]: FieldCondition | WhereCondition[] | any;
+};
+/**
+ * Filter 参数接口
+ * @description 用于 filter 方法的查询参数
+ * @example
+ * ```typescript
+ * // 使用枚举
+ * const filterParams1: FilterParams = {
+ *   where: {
+ *     $and: [
+ *       { age: { $gte: 18, $lte: 45 } },
+ *       { country: { $in: ['中国', '美国', '日本'] } }
+ *     ]
+ *   },
+ *   select: ['id', 'name', 'age', 'country'],
+ *   orderBy: [
+ *     { lastLoginAt: SortOrder.DESC },
+ *     { name: SortOrder.ASC }
+ *   ],
+ *   currentPage: 1,
+ *   pageSize: 20
+ * };
+ *
+ * // 或使用字符串（更简洁）
+ * const filterParams2: FilterParams = {
+ *   orderBy: [
+ *     { lastLoginAt: "desc" },
+ *     { name: "asc" }
+ *   ]
+ * };
+ * ```
+ */
+interface FilterParams {
+    /** Where 条件 */
+    where?: WhereCondition;
+    /** 选择返回的字段列表 */
+    select?: string[];
+    /** 排序规则 */
+    orderBy?: SortList;
+    /** 当前页码，从 1 开始 */
+    currentPage?: number;
+    /** 每页数量 */
+    pageSize?: number;
+}
+/**
+ * 聚合类型
+ */
+type AggregateType = 'SUM' | 'COUNT' | 'AVG' | 'MIN' | 'MAX';
+/**
+ * 聚合字段配置
+ */
+interface AggregateField {
+    /** 聚合类型 */
+    type: AggregateType;
+    /** 聚合列名 */
+    column?: string;
+    /**
+     * 聚合列名的旧别名。
+     * @deprecated Use `column`. The SDK normalizes `field` to `column` before sending requests.
+     */
+    field?: string;
+    /** 字段别名 */
+    alias?: string;
+    /** 是否 distinct */
+    distinct?: boolean;
+    /** 是否 round */
+    round?: boolean;
+    /** round 精度 */
+    precision?: number;
+}
+/**
+ * Join 类型
+ */
+type JoinType = 'LEFT' | 'RIGHT' | 'INNER';
+/**
+ * Join 配置
+ */
+interface JoinConfig {
+    /** Join 类型 */
+    type: JoinType;
+    /** 关联表名 */
+    table: string;
+    /** 关联条件，key 为当前表字段，value 为关联表字段 */
+    condition: Record<string, string>;
+}
+/**
+ * Having 条件
+ */
+interface HavingCondition {
+    /** 列名（通常是聚合字段的别名） */
+    columnName: string;
+    /** 条件 */
+    condition: FieldCondition;
+}
+/**
+ * Aggregate 参数接口
+ * @description 用于 aggregate 方法的聚合查询参数
+ * @example
+ * ```typescript
+ * // 使用枚举
+ * const aggregateParams1: AggregateParams = {
+ *   select: ['category_id'],
+ *   aggregate: [
+ *     { type: 'SUM', column: 'amount', alias: 'total_amount', round: true, precision: 2 }
+ *   ],
+ *   where: { status: { $eq: 'active' } },
+ *   groupBy: ['category_id'],
+ *   having: [
+ *     { columnName: 'total_amount', condition: { $gte: 1000 } }
+ *   ],
+ *   orderBy: [{ total_amount: SortOrder.DESC }],
+ *   currentPage: 1,
+ *   pageSize: 20
+ * };
+ *
+ * // 或使用字符串
+ * const aggregateParams2: AggregateParams = {
+ *   orderBy: [{ total_amount: "desc" }]
+ * };
+ * ```
+ */
+interface AggregateParams {
+    /** 选择返回的字段列表 */
+    select?: string[];
+    /** 聚合字段配置 */
+    aggregate?: AggregateField[];
+    /** Where 条件 */
+    where?: WhereCondition;
+    /** Group By 字段列表 */
+    groupBy?: string[];
+    /** Having 条件 */
+    having?: HavingCondition[];
+    /** Join 配置 */
+    join?: JoinConfig[];
+    /** 排序规则 */
+    orderBy?: SortList;
+    /** 当前页码，从 1 开始 */
+    currentPage?: number;
+    /** 每页数量 */
+    pageSize?: number;
+}
+/**
+ * 下拉选项接口
+ * @description 用于 Select 组件的选项数据格式
+ */
+interface SelectOption {
+    /** 显示文本 */
+    label: string;
+    /** 选项值 */
+    value: string;
+}
+/**
+ * 获取下拉选项的参数接口
+ * @description 指定用于生成下拉选项的字段映射
+ * @example
+ * ```typescript
+ * // 获取用户列表的下拉选项
+ * const options = await model.getSelectOptions({
+ *   code: 'user_id',   // 将 user_id 字段作为 value
+ *   label: 'user_name' // 将 user_name 字段作为 label
+ * });
+ * // 返回: [{ label: '张三', value: 'user001' }, ...]
+ * ```
+ */
+interface SelectOptionsParams {
+    /** 用作选项值的字段名 */
+    code: string;
+    /** 用作显示文本的字段名 */
+    label: string;
+}
+/**
+ * 单个模型配置接口
+ * @description 定义数据模型的基本配置信息
+ */
+interface ModelConfig {
+    /** 数据表名称 */
+    tableName: string;
+    /** 数据集代码（唯一标识） */
+    datasetCode: string;
+    /** 数据集名称 */
+    name?: string;
+    /** 别名，用于人类友好的访问方式（可选） */
+    alias?: string;
+    /** 数据库名称（可选，用于区分不同数据库中的同名表） */
+    dbName?: string;
+}
+/**
+ * 模型配置集合接口
+ * @description 包含应用代码和所有模型配置的集合
+ *
+ * 支持两种格式：
+ * 1. 数组格式（推荐）：ModelConfig[]
+ * 2. 对象格式（向下兼容）：Record<string, ModelConfig>，key 作为默认 alias
+ *
+ * @example
+ * ```typescript
+ * // 新格式（数组）
+ * const config: ModelsConfig = {
+ *   appCode: 'my-app',
+ *   models: [
+ *     { tableName: 'users', datasetCode: 'dataset_abc', alias: 'users' },
+ *     { tableName: 'posts', datasetCode: 'dataset_def' }
+ *   ]
+ * };
+ *
+ * // 老格式（对象，向下兼容）
+ * const config: ModelsConfig = {
+ *   appCode: 'my-app',
+ *   models: {
+ *     Users: { tableName: 'users', datasetCode: 'user-dataset-code' },
+ *     Posts: { tableName: 'posts', datasetCode: 'post-dataset-code' }
+ *   }
+ * };
+ * ```
+ */
+interface ModelsConfig {
+    /** 应用代码，用于标识不同的应用 */
+    appCode: string;
+    /**
+     * 模型配置
+     * - 数组格式（推荐）：直接使用 datasetCode 访问
+     * - 对象格式（兼容）：key 作为默认 alias
+     */
+    models: ModelConfig[] | Record<string, ModelConfig>;
+}
+/**
+ * 客户端配置接口
+ * @description Lovrabet 客户端的完整配置选项
+ * @example
+ * ```typescript
+ * // 基本配置（推荐使用 production）
+ * const config: ClientConfig = {
+ *   appCode: 'my-app',
+ *   env: 'production',
+ *   token: 'your-token'
+ * };
+ *
+ * // 向下兼容（online 等同于 production）
+ * const config: ClientConfig = {
+ *   appCode: 'my-app',
+ *   env: 'online',
+ *   token: 'your-token'
+ * };
+ *
+ * // 引用预注册配置
+ * const config: ClientConfig = {
+ *   apiConfigName: 'prod',
+ *   token: 'override-token'
+ * };
+ * ```
+ */
+/**
+ * 鉴权模式类型
+ * - "openapi": OpenAPI 签名模式（accessKey + secretKey），走 /openapi/ 前缀
+ * - "client-ak": Client AK 模式（仅 accessKey），走 /client/ 前缀，X-User-AK 鉴权
+ * - "cookie": Cookie 模式，走 /api/ 前缀
+ */
+type AuthMode = "openapi" | "client-ak" | "cookie";
+interface ClientConfig {
+    /** 应用代码，用于标识不同的应用 */
+    appCode?: string;
+    /**
+     * 运行态 API 域名，优先级最高，可覆盖环境默认端点与部署配置注入的地址。
+     * 适用于私有化部署或本地联调。
+     *
+     * 与 rabetbase-cli/.rabetbase.json 中的 `runtimeDomain` 字段命名对齐。
+     *
+     * @example 'https://runtime.my-company.com'
+     */
+    runtimeDomain?: string;
+    /**
+     * @deprecated 请使用 `runtimeDomain` 替代。
+     * 为向下兼容而保留，优先级低于 `runtimeDomain`；
+     * 两者均设置时以 `runtimeDomain` 为准。
+     * 下一个大版本将移除此字段。
+     */
+    serverUrl?: string;
+    /** 运行环境，默认为 'production'（向下兼容 'online'） */
+    env?: Environment$1;
+    /** 官方运行节点，默认为 'cn'；显式 runtimeDomain 的优先级更高。 */
+    region?: Region;
+    /** 预计算 OpenAPI token，配合 timestamp 通过 X-Token / X-Time-Stamp 传递，不是 Authorization: Bearer */
+    token?: string;
+    /** 与 token 配对的时间戳（OpenAPI 模式必需） */
+    timestamp?: number;
+    /** API 访问密钥，用于签名认证 */
+    accessKey?: string;
+    /** API 密钥，用于签名认证 */
+    secretKey?: string;
+    /** Cookie 字符串，用于 Cookie 认证（Node.js 环境专用） */
+    cookie?: string;
+    /**
+     * 显式要求当前 authMode 下的凭据已经齐全时设为 true。
+     * 未设置时不做强制检查（没有默认 true）。
+     * 校验按 authMode：client-ak 需要 accessKey；openapi 需要 accessKey，或 token + timestamp；
+     * cookie / 缺省不能把 token、accessKey 当成已生效的 Cookie 认证。
+     */
+    requiresAuth?: boolean;
+    /**
+     * 显式声明鉴权模式。**未设置时固定回退到 cookie 模式**，不会根据 accessKey / token 等字段自动推断；
+     * 需要 Client AK / OpenAPI 鉴权时必须显式设置（`"client-ak"` 或 `"openapi"`）。
+     */
+    authMode?: AuthMode;
+    /**
+     * 模型配置
+     * - 数组格式（推荐）：直接使用 datasetCode 访问
+     * - 对象格式（兼容）：key 作为默认 alias
+     */
+    models?: ModelConfig[] | Record<string, ModelConfig>;
+    /**
+     * 引用已注册的 API 配置名称
+     * @description 当指定此字段时，会从配置注册表中获取对应的模型配置
+     * @example 'default', 'prod', 'dev'
+     */
+    apiConfigName?: string;
+    /** 额外配置选项 */
+    options?: {
+        /** 请求超时时间（毫秒），包含响应体读取；未配置时保留原行为（PUT/DELETE 默认 30000，其他不限时）。 */
+        timeout?: number;
+        /** Fetch 重定向策略；未配置时沿用 Fetch 默认行为。 */
+        redirect?: RequestRedirect;
+        /** 重试次数 */
+        retryCount?: number;
+        /** 错误处理回调函数 */
+        onError?: (error: any) => void;
+        /** 需要重新登录时的回调函数 */
+        onRedirectToLogin?: () => void;
+        /** 是否启用调试日志（打印请求 URL、Headers 和 Body） */
+        debug?: boolean;
+        /** 附加到每个请求的自定义 HTTP 请求头 */
+        headers?: Record<string, string>;
+    };
+}
+/**
+ * 基础模型方法接口
+ * @description 定义所有模型实例的标准 CRUD 操作方法
+ * @template T 数据类型，默认为 any
+ * @example
+ * ```typescript
+ * // 使用示例
+ * const users: BaseModelMethods = client.models.Users;
+ * const userList = await users.getList({ currentPage: 1, pageSize: 10 });
+ * const user = await users.getOne('123');
+ * const newUser = await users.create({ name: 'John', email: 'john@example.com' });
+ * ```
+ */
+interface BaseModelMethods {
+    /**
+     * 获取数据列表
+     * @template T 返回数据的类型
+     * @param params 查询参数，包含分页等信息
+     * @param sortList 排序配置列表，可选参数
+     * @returns 返回分页数据
+     */
+    getList<T = any>(params?: ListParams, sortList?: SortList): Promise<ListResponse<T>>;
+    /**
+     * 高级过滤查询（推荐使用）
+     * @template T 返回数据的类型
+     * @param params Filter 查询参数，支持复杂条件、字段选择、排序和分页
+     * @returns 返回分页数据
+     * @description 提供比 getList 更强大的查询能力，支持复杂的 where 条件、字段选择等（filter 在 WebAPI / OpenAPI / Client AK 模式均支持；delete、excelExport、getSelectOptions 当前不支持 OpenAPI 模式，WebAPI 与 Client AK 均支持）
+     * @example
+     * ```typescript
+     * // 使用枚举
+     * const result1 = await model.filter({
+     *   where: {
+     *     $and: [
+     *       { age: { $gte: 18, $lte: 45 } },
+     *       { country: { $in: ['中国', '美国', '日本'] } },
+     *       { name: { $contain: 'hello' } }
+     *     ]
+     *   },
+     *   select: ['id', 'name', 'age', 'country'],
+     *   orderBy: [{ lastLoginAt: SortOrder.DESC }],
+     *   currentPage: 1,
+     *   pageSize: 20
+     * });
+     *
+     * // 或使用字符串（更简洁）
+     * const result2 = await model.filter({
+     *   orderBy: [{ lastLoginAt: "desc" }]
+     * });
+     * ```
+     */
+    filter<T = any>(params?: FilterParams): Promise<ListResponse<T>>;
+    /**
+     * 获取单条数据
+     * @template T 返回数据的类型
+     * @param idOrParams 数据 ID（字符串或数字），或包含 id 字段的对象
+     * @returns 返回单条数据
+     * @example
+     * ```typescript
+     * // 直接传 ID
+     * const user = await model.getOne(123);
+     * const user = await model.getOne('abc');
+     *
+     * // 传对象（兼容格式）
+     * const user = await model.getOne({ id: 123 });
+     * const user = await model.getOne({ id: String(id) });
+     * ```
+     */
+    getOne<T = any>(idOrParams: string | number | {
+        id: string | number;
+    }): Promise<T>;
+    /**
+     * 创建新数据
+     * @template T 返回数据的类型
+     * @param data 要创建的数据对象
+     * @returns 返回创建后的数据
+     */
+    create<T = any>(data: Record<string, any>): Promise<T>;
+    /**
+     * 批量创建数据
+     * @template T 返回数据的类型
+     * @param items 要创建的数据对象数组，最多 1000 条
+     * @returns 返回创建后的数据
+     */
+    batchCreate<T = any>(items: Record<string, any>[]): Promise<T>;
+    /**
+     * 更新数据，支持单条和批量
+     * @template T 返回数据的类型
+     *
+     * **推荐写法（对象合并）**：将 id 与更新字段合并为一个对象传入：
+     * ```typescript
+     * await model.update({ id: 1001, name: '张三' });
+     * await model.update({ id: [1001, 1002], status: 'active' });
+     * ```
+     *
+     * **兼容写法（id 分离）**：
+     * ```typescript
+     * await model.update(1001, { name: '张三' });
+     * await model.update([1001, 1002], { status: 'active' });
+     * ```
+     */
+    update<T = any>(dataWithId: {
+        id: string | number | (string | number)[];
+        [key: string]: any;
+    }): Promise<T>;
+    update<T = any>(id: string | number | (string | number)[], data: Record<string, any>): Promise<T>;
+    /**
+     * 删除数据，支持单条和批量
+     * @throws Error OpenAPI 模式暂不支持此操作；WebAPI 与 Client AK 模式均可用
+     *
+     * **推荐写法（对象传入）**：
+     * ```typescript
+     * await model.delete({ id: 1001 });
+     * await model.delete({ id: [1001, 1002, 1003] });
+     * ```
+     *
+     * **兼容写法（直接传 id）**：
+     * ```typescript
+     * await model.delete(1001);
+     * await model.delete([1001, 1002, 1003]);
+     * ```
+     */
+    delete(params: {
+        id: string | number | (string | number)[];
+    }): Promise<void>;
+    delete(id: string | number | (string | number)[]): Promise<void>;
+    /**
+     * 获取下拉选项
+     * @param params 字段映射参数，指定用作 value 和 label 的字段名
+     * @returns 返回下拉选项数组
+     * @description 用于获取数据表的下拉选项数据，适用于 Select 组件（WebAPI 与 Client AK 模式支持，OpenAPI 模式不支持）
+     * @example
+     * ```typescript
+     * // 获取用户下拉选项
+     * const options = await model.getSelectOptions({
+     *   code: 'user_id',
+     *   label: 'user_name'
+     * });
+     * // 返回: [{ label: '张三', value: 'user001' }, { label: '李四', value: 'user002' }]
+     * ```
+     */
+    getSelectOptions(params: SelectOptionsParams): Promise<SelectOption[]>;
+    /**
+     * 导出数据为 Excel 文件
+     * @param params 查询参数（可选），与 getList 参数一致，用于按条件筛选导出数据
+     * @returns 返回导出文件的 URL 地址（字符串），可直接用于下载
+     * @description 导出当前数据集的数据为 Excel 文件（WebAPI 与 Client AK 模式支持，OpenAPI 模式不支持）
+     * @example
+     * ```typescript
+     * // 导出所有数据
+     * const fileUrl = await model.excelExport();
+     * // fileUrl: "https://yuntoo-export-import.oss-cn-hangzhou.aliyuncs.com/xxx.xlsx?..."
+     * window.open(fileUrl, '_blank');
+     *
+     * // 按条件筛选导出
+     * const fileUrl = await model.excelExport({
+     *   status: 'active',
+     *   createTime: '2025-01-01'
+     * });
+     * window.open(fileUrl, '_blank');
+     * ```
+     */
+    excelExport<T = string>(params?: ListParams): Promise<T>;
+    /**
+     * 聚合查询
+     * @template T 返回数据的类型
+     * @param params 聚合查询参数，支持 SUM、COUNT、AVG、MIN、MAX 等聚合函数，以及 GROUP BY、HAVING、JOIN
+     * @returns 返回分页数据
+     * @example
+     * ```typescript
+     * // 使用枚举
+     * const result1 = await model.aggregate({
+     *   select: ['category_id'],
+     *   aggregate: [
+     *     { type: 'SUM', column: 'amount', alias: 'total_amount', round: true, precision: 2 }
+     *   ],
+     *   groupBy: ['category_id'],
+     *   having: [{ columnName: 'total_amount', condition: { $gte: 1000 } }],
+     *   orderBy: [{ total_amount: SortOrder.DESC }]
+     * });
+     *
+     * // 或使用字符串
+     * const result2 = await model.aggregate({
+     *   orderBy: [{ total_amount: "desc" }]
+     * });
+     * ```
+     */
+    aggregate<T = any>(params?: AggregateParams): Promise<ListResponse<T>>;
+}
+/**
+ * 认证请求头接口
+ * @description 包含认证信息的 HTTP 请求头。实际字段由 authMode 决定，不是 Authorization: Bearer。
+ * @example
+ * ```typescript
+ * // OpenAPI：预计算 token 或 accessKey 签名
+ * { "X-Token": "…", "X-Time-Stamp": "…", "X-App-Code": "app-xxx", "X-Dataset-Code": "…" }
+ *
+ * // Client AK
+ * { "X-User-AK": "your-access-key" }
+ * ```
+ */
+interface AuthHeaders {
+    /** 请求头键值对 */
+    [key: string]: string;
+}
+/**
+ * 认证管理器接口
+ * @description 按显式 authMode 选择认证策略；未设置 authMode 时固定为 cookie，不会按 token / accessKey 自动升级。
+ * @example
+ * ```typescript
+ * // OpenAPI 预计算 token 必须配对 timestamp
+ * authManager.setToken('your-token', Date.now());
+ *
+ * const headers = await authManager.getAuthHeaders(appCode, datasetCode);
+ * // 返回: { "X-Token": "…", "X-Time-Stamp": "…" }
+ * ```
+ */
+interface AuthManager$1 {
+    /**
+     * 获取认证请求头
+     * @description 根据当前配置的认证方式生成对应的请求头
+     * @param appCode 应用代码（OpenAPI 认证时必需）
+     * @param datasetCode 数据集代码（OpenAPI 认证时必需）
+     * @returns 包含认证信息的请求头对象
+     */
+    getAuthHeaders(appCode?: string, datasetCode?: string): Promise<AuthHeaders>;
+    /** 为绑定应用和操作人的审批 Flow OpenAPI 生成签名上下文。 */
+    getFlowAuthContext(appCode: string, operatorUserId: string): Promise<OpenApiAuthContext>;
+    /**
+     * 验证当前认证是否有效
+     * @returns 认证是否有效
+     */
+    validateAuth(): Promise<boolean>;
+    /**
+     * 设置用户 Token
+     * @param token 用户认证 Token
+     * @param timestamp 与 token 配对的时间戳（OpenAPI 模式必需）
+     */
+    setToken(token: string, timestamp?: number): void;
+    /**
+     * 检查是否使用 Cookie 认证
+     * @description 当没有 Token 和 API 密钥时，会降级到 Cookie 认证
+     * @returns 是否使用 Cookie 认证
+     */
+    isCookieAuth(): boolean;
+    /**
+     * 检查是否提供了显式的 Cookie 字符串
+     * @description 用于区分浏览器自动 Cookie (credentials: 'include') 和用户显式提供的 Cookie 字符串
+     * @returns 是否提供了显式 Cookie
+     */
+    hasExplicitCookie(): boolean;
+}
+/**
+ * Lovrabet 客户端接口
+ * @description SDK 的主要客户端接口，提供模型访问和配置管理功能
+ * @example
+ * ```typescript
+ * // 创建客户端
+ * const client = createClient();
+ *
+ * // 使用模型
+ * const users = await client.models.Users.getList();
+ *
+ * // 设置认证
+ * client.setToken('new-token');
+ *
+ * // 获取配置
+ * const config = client.getConfig();
+ * ```
+ */
+interface LovrabetClient$1 {
+    /** 运行态通用服务，如文件与 OCR。 */
+    readonly services: LovrabetServices;
+    /** 创建使用当前登录用户身份的独立流程自定义页面客户端。 */
+    flow(): LovrabetFlowClient;
+    /**
+     * 当前用户拥有的资源，如个人 BFF。
+     *
+     * 该公共接口允许兼容旧版或外部注入的 client；createClient() 返回的
+     * 具体 LovrabetClient 实例始终提供 personal。
+     */
+    readonly personal?: LovrabetPersonal;
+    /**
+     * SQL 执行客户端，按认证模式自动选择实现。
+     *
+     * `query()` 仅 `ClientAkSqlClient` 提供，使用前需 `instanceof` 收窄。
+     */
+    readonly sql: SqlClient | OpenApiSqlClient | ClientAkSqlClient;
+    /**
+     * BFF 端点客户端，按认证模式自动选择实现。
+     *
+     * `getEndpoint()` 仅 `ClientAkBffClient` 提供，使用前需 `instanceof` 收窄。
+     */
+    readonly bff: BffClient | ClientAkBffClient;
+    /**
+     * 权限、角色与成员能力（cookie / client-ak 双模式）。
+     *
+     * 对应后端成对存在的 `/api/permit/*` 与 `/client/permit/*`；
+     * OpenAPI 模式调用时会抛出 `API_AUTH_MODE_UNSUPPORTED`。
+     */
+    readonly permit: PermitClient;
+    /** Artifact 产物管理（仅 client-ak）。 */
+    readonly artifact: ArtifactClient;
+    /** 审批任务（仅 client-ak）。 */
+    readonly approval: ApprovalClient;
+    /** 应用、登录用户、应用配置与通知渠道（仅 client-ak）。 */
+    readonly app: AppClient;
+    /** 数据集元信息与驱动配置（仅 client-ak）。 */
+    readonly datasetMeta: DatasetMetaClient;
+    /** 脚本缓存与日志诊断（仅 cookie）。 */
+    readonly management: ManagementClient;
+    /**
+     * 模型访问接口 - 纯粹的语法糖，支持 client.models.ModelName 访问
+     * @description 内部调用 client.getModel() 方法，提供更简洁的访问方式
+     * @example
+     * ```typescript
+     * // 两种方式等价：
+     * const model1 = client.getModel('Requirements');
+     * const model2 = client.models.Requirements;
+     *
+     * // 推荐的简洁用法：
+     * const data = await client.models.Requirements.getList();
+     * ```
+     */
+    models: {
+        [modelName: string]: BaseModelMethods;
+    };
+    /**
+     * 设置用户认证 Token
+     * @param token 用户认证 Token
+     * @param timestamp 与 token 配对的时间戳（OpenAPI 模式必需）
+     * @description 设置后所有 API 请求将使用此 Token 进行认证
+     */
+    setToken(token: string, timestamp?: number): void;
+    /**
+     * 获取客户端配置
+     * @returns 当前客户端的完整配置信息
+     */
+    getConfig(): ClientConfig;
+    /**
+     * 获取所有可用模型列表
+     * @returns 返回已配置的所有模型名称数组
+     * @example
+     * ```typescript
+     * const models = client.getModelList();
+     * console.log('可用模型:', models); // ['Requirements', 'Projects', 'Users']
+     *
+     * // 使用第一个模型
+     * if (models.length > 0) {
+     *   const firstModel = client.getModel(0);
+     *   const data = await firstModel.getList();
+     * }
+     * ```
+     */
+    getModelList(): string[];
+    /**
+     * 根据索引或名称获取模型实例
+     * @param indexOrName 模型索引（数字）或模型名称（字符串）
+     * @returns 返回对应的模型实例，可直接调用 getList(), getOne() 等方法
+     * @throws 当索引超出范围或模型名称不存在时抛出错误
+     * @example
+     * ```typescript
+     * // 通过索引获取模型
+     * const firstModel = client.getModel(0);
+     * const data = await firstModel.getList();
+     *
+     * // 通过名称获取模型
+     * const usersModel = client.getModel('Users');
+     * const user = await usersModel.getOne(123);
+     *
+     * // 错误处理
+     * try {
+     *   const model = client.getModel(999); // 索引超出范围
+     * } catch (error) {
+     *   console.error('Model not found:', error.message);
+     * }
+     * ```
+     */
+    getModel(indexOrName: number | string): BaseModelMethods;
+    /**
+     * 检查当前是否为 OpenAPI 模式
+     * @returns 如果配置了 accessKey 或 token 则返回 true，否则返回 false
+     * @description OpenAPI 模式会使用不同的 URL 路径和认证方式
+     * @example
+     * ```typescript
+     * const client = createClient({ accessKey: 'ak-xxx' });
+     * console.log(client.isOpenApiMode()); // true
+     *
+     * const cookieClient = createClient({});
+     * console.log(cookieClient.isOpenApiMode()); // false
+     * ```
+     */
+    isOpenApiMode(): boolean;
+}
+
+/**
+ * User 客户端 - 用户信息相关 API
+ *
+ * @example
+ * ```typescript
+ * const userList = await client.user.getList();
+ * console.log(userList);
+ * ```
+ */
+declare class UserClient {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * 获取用户列表
+     *
+     * @returns 用户列表数组
+     */
+    getList: () => Promise<User[]>;
+}
+
+/**
+ * API 命名空间 - 别名入口
+ *
+ * 推荐使用客户端方式：
+ * - SQL: `client.sql.execute()`
+ * - BFF: `client.bff.execute()`
+ * - User: `client.user.getList()`
+ *
+ * 此命名空间提供向后兼容的别名：
+ * - `client.api.sql()` → `client.sql.execute()`
+ * - `client.api.bff()` → `client.bff.execute()`
+ * - `client.api.getUserList()` → `client.user.getList()`
+ */
+declare class ApiNamespace {
+    private httpClient;
+    private appCode;
+    constructor(httpClient: HttpClient, appCode: string);
+    /**
+     * SQL 客户端实例
+     */
+    private _sql?;
+    /**
+     * SQL 查询别名 - 推荐使用 `client.sql.execute()`
+     *
+     * @example
+     * ```typescript
+     * // 推荐用法（对象参数）
+     * const data = await client.sql.execute({
+     *   sqlCode: 'fc8e7777-06e3847d',
+     *   params: { userId: '123' }
+     * });
+     *
+     * // 别名用法（兼容）
+     * const data = await client.api.sql({
+     *   sqlCode: 'fc8e7777-06e3847d',
+     *   params: { userId: '123' }
+     * });
+     * ```
+     */
+    get sql(): SqlClient["execute"];
+    /**
+     * SQL 查询别名（旧名称）- 向后兼容
+     *
+     * @deprecated 使用 `client.sql.execute()` 或 `client.api.sql()`
+     */
+    get executeSql(): SqlClient["execute"];
+    /**
+     * BFF 客户端实例
+     */
+    private _bff?;
+    /**
+     * BFF 查询别名 - 推荐使用 `client.bff.execute()`
+     *
+     * @example
+     * ```typescript
+     * // 推荐用法（对象参数）
+     * const result = await client.bff.execute({
+     *   scriptName: 'getBundleTemplates'
+     * });
+     *
+     * // 别名用法（兼容）
+     * const result = await client.api.bff({
+     *   scriptName: 'getBundleTemplates'
+     * });
+     * ```
+     */
+    get bff(): BffClient["execute"];
+    /**
+     * User 客户端实例
+     */
+    private _user?;
+    /**
+     * User 查询别名 - 推荐使用 `client.user.getList()`
+     *
+     * @example
+     * ```typescript
+     * // 推荐用法
+     * const userList = await client.user.getList();
+     *
+     * // 别名用法（兼容）
+     * const userList = await client.api.getUserList();
+     * ```
+     */
+    get getUserList(): UserClient["getList"];
+    /**
+     * User 客户端别名 - 推荐使用 `client.user.getList()`
+     *
+     * @deprecated 使用 `client.user.getList()`
+     */
+    get user(): {
+        getList: UserClient["getList"];
+    };
+}
+
+/**
+ * Runtime OCR service.
+ *
+ * The public method is stable while the transport follows the configured auth mode:
+ * - cookie: GET /api/ocr/recognize-text
+ * - client-ak: POST /client/ocr
+ */
+declare class OcrClient implements OcrService {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    recognize(request: OcrRecognizeRequest): Promise<OcrRecognizeResponse>;
+}
+
+/** Runtime file upload and URL service. */
+declare class FileClient implements FileService {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    upload(request: FileUploadRequest): Promise<FileUploadResponse>;
+    queryUrl(request: FileQueryUrlRequest): Promise<FileUrlResponse>;
+    private assertSupportedAuthMode;
+}
+
+/** Namespace for runtime services. */
+declare class ServicesNamespace implements LovrabetServices {
+    readonly ocr: OcrClient;
+    readonly file: FileClient;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+}
+
+/** Personal BFF execution client exposed under `client.personal.bff`. */
+declare class PersonalBffClient implements PersonalBffService {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    execute<T = unknown>(request: PersonalBffExecuteRequest): Promise<T>;
+    /** 列出当前用户的 Personal BFF（`GET {prefix}/runtime-bff/personal/list`） */
+    list(): Promise<PersonalBffScript[]>;
+    /** 获取 Personal BFF 详情（`GET {prefix}/runtime-bff/personal/{id}`） */
+    get<T = PersonalBffScript>(scriptId: number): Promise<T>;
+    /** 创建 Personal BFF（`POST {prefix}/runtime-bff/personal/create`） */
+    create<T = PersonalBffScript>(request: PersonalBffUpsertRequest): Promise<T>;
+    /** 更新 Personal BFF（`POST {prefix}/runtime-bff/personal/{id}/update`） */
+    update<T = PersonalBffScript>(scriptId: number, request: PersonalBffUpsertRequest): Promise<T>;
+    private path;
+}
+
+/** Namespace for resources owned by the current user. */
+declare class PersonalNamespace implements LovrabetPersonal {
+    readonly bff: PersonalBffClient;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+}
+
+/**
+ * Lovrabet SDK 核心客户端类
+ *
+ * 设计原则：
+ * 1. 实例化设计 - 避免全局状态，支持多项目并存
+ * 2. 依赖注入 - 通过构造函数注入依赖，便于测试和扩展
+ * 3. 配置不可变 - 创建后配置基本不可变，提高安全性
+ * 4. 职责分离 - 认证、HTTP、模型管理各司其职
+ */
+declare class LovrabetClient implements LovrabetClient$1 {
+    private config;
+    private authManager;
+    private httpClient;
+    /**
+     * 模型管理器 - 提供管理方法
+     */
+    private modelManager;
+    /**
+     * 模型访问 Proxy - 纯粹的语法糖，支持 client.models.ModelName 访问
+     * 内部调用 client.getModel() 方法，避免命名冲突
+     */
+    models: {
+        [modelName: string]: BaseModelMethods;
+    };
+    /**
+     * SQL 客户端 - 执行自定义 SQL 查询
+     * 根据认证模式自动选择：
+     * - OpenAPI 模式：使用 OpenApiSqlClient（/openapi/data/custom-sql）
+     * - WebAPI 模式：使用 SqlClient（/api/custom/executeSql）
+     */
+    readonly sql: SqlClient | OpenApiSqlClient | ClientAkSqlClient;
+    /**
+     * BFF 客户端 - 调用 Backend For Frontend 端点
+     */
+    readonly bff: BffClient | ClientAkBffClient;
+    /**
+     * User 客户端 - 用户信息相关 API
+     */
+    readonly user: UserClient;
+    /**
+     * 平台服务命名空间 - OCR 等不绑定数据集或 BFF 的通用运行态能力
+     */
+    readonly services: ServicesNamespace;
+    /**
+     * 当前用户拥有的资源，如个人 BFF。
+     */
+    readonly personal: PersonalNamespace;
+    /**
+     * 权限、角色与成员（cookie / client-ak 双模式）。
+     *
+     * 后端同时提供 `/api/permit/*` 与 `/client/permit/*` 镜像。
+     */
+    readonly permit: PermitClient;
+    /**
+     * Artifact 产物管理（仅 client-ak）。
+     */
+    readonly artifact: ArtifactClient;
+    /**
+     * 审批任务（仅 client-ak）。
+     */
+    readonly approval: ApprovalClient;
+    /**
+     * 应用、登录用户、应用配置与通知渠道（仅 client-ak）。
+     */
+    readonly app: AppClient;
+    /**
+     * 数据集元信息与驱动配置（仅 client-ak）。
+     */
+    readonly datasetMeta: DatasetMetaClient;
+    /**
+     * 脚本缓存与日志诊断（仅 cookie）。
+     */
+    readonly management: ManagementClient;
+    /**
+     * API 命名空间 - 别名入口（向后兼容）
+     *
+     * 推荐使用命名空间方式：
+     * - `client.sql.execute()` 而非 `client.api.sql()`
+     * - `client.bff.execute()` 而非 `client.api.bff()`
+     * - `client.user.getList()` 而非 `client.api.getUserList()`
+     */
+    readonly api: ApiNamespace;
+    constructor(config: ClientConfig);
+    private validateConfig;
+    /**
+     * 运行时动态设置 token
+     * 为什么需要这个方法：
+     * 1. 用户登录后可能需要更新 token
+     * 2. token 可能会过期需要刷新
+     * 3. 支持动态认证切换（比如用户切换账号）
+     *
+     * @param token - 认证 token
+     * @param timestamp - 与 token 配对的时间戳（OpenAPI 模式必需）
+     */
+    setToken(token: string, timestamp?: number): void;
+    /**
+     * 获取当前配置的副本
+     * 为什么返回副本而不是原始对象：
+     * 1. 防止外部代码意外修改内部配置
+     * 2. 遵循不可变性原则，保证配置稳定性
+     */
+    getConfig(): ClientConfig;
+    /**
+     * 获取当前环境的 API 基础地址
+     * 为什么需要这个方法：
+     * 1. 用户可能需要知道当前使用的 API 地址用于调试
+     * 2. 某些场景可能需要直接使用基础地址构造 URL
+     * 3. 支持自定义服务器地址的覆盖逻辑
+     *
+     * 透传调用 HttpClient.getBaseUrl()，确保单一数据源
+     */
+    getBaseUrl(): string;
+    /**
+     * 动态切换环境
+     * 为什么允许运行时切换环境：
+     * 1. 开发调试时可能需要在不同环境间切换
+     * 2. 某些应用场景需要动态环境选择
+     * 注意：这不会影响已缓存的模型实例
+     */
+    setEnvironment(env: Environment$1): void;
+    /**
+     * 获取当前环境
+     * 为什么提供这个方法：用户可能需要根据当前环境执行不同的逻辑
+     */
+    getEnvironment(): Environment$1;
+    /**
+     * 获取所有可用模型列表
+     * 为什么提供这个方法：
+     * 1. 提供简单直接的模型发现方式
+     * 2. 支持动态获取配置中的所有模型
+     */
+    getModelList(): string[];
+    /**
+     * 获取所有模型的详细信息，包含别名和名称
+     * 用于 UI 展示人类友好的模型列表
+     *
+     * @returns 模型详情数组，每个元素包含：
+     *   - value: 用于访问的 dataset_xxx 格式
+     *   - label: 人类友好的显示名称，格式为 "alias[name]" 或 "dataset_xxx"
+     *   - alias: 别名（如果有）
+     *   - name: 模型名称（如果有）
+     *   - datasetCode: 原始 datasetCode
+     */
+    getModelListDetails(): Array<{
+        value: string;
+        label: string;
+        alias?: string;
+        name?: string;
+        datasetCode: string;
+    }>;
+    /**
+     * 根据索引或名称获取模型实例
+     * 为什么提供这个方法：
+     * 1. 提供统一的错误处理和类型安全
+     * 2. 支持按索引快速获取第一个模型，便于演示和快速开发
+     * 3. 作为 models.xxx 语法糖的底层实现
+     */
+    getModel(indexOrName: number | string): BaseModelMethods;
+    /**
+     * 检查当前是否为 OpenAPI 模式
+     */
+    isOpenApiMode(): boolean;
+    /**
+     * 创建使用当前登录用户身份的独立流程自定义页面客户端。
+     */
+    flow(): LovrabetFlowClient;
+    /**
+     * 解析鉴权模式。无 authMode → cookie；有则严格遵循。
+     */
+    private resolveAuthMode;
+}
+
+/**
+ * 创建 Lovrabet 客户端实例 - SDK 的主要入口函数
+ *
+ * 设计理念：
+ * 1. 多重载设计 - 支持 4 种不同的调用方式，满足各种使用场景
+ * 2. 智能类型推断 - 根据参数类型自动选择不同的处理逻辑
+ * 3. 配置优先级 - 明确的配置合并和覆盖规则
+ * 4. 错误优先 - 在客户端创建阶段就发现配置问题
+ *
+ * 四种调用方式：
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * 方式 1：字符串 — 引用预注册的配置名称
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ *   适用场景：已在启动时通过 registerModels() 注册过配置，直接按名引用。
+ *   示例：
+ *     registerModels({ appCode: 'my-app', models: [...] }, 'prod');
+ *     const client = createClient('prod');
+ *   省略参数时等价于 createClient('default')。
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * 方式 2：ModelsConfig — 纯模型配置对象（仅 appCode + models）
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ *   适用场景：一次性创建客户端，无需预注册；传入最少字段即可。
+ *   判断依据：对象同时包含 appCode 和 models，且不包含 env 等 ClientConfig 字段。
+ *   示例：
+ *     const client = createClient({
+ *       appCode: 'my-app',
+ *       models: { chat: { modelId: 'gpt-4o' } },
+ *     });
+ *   额外字段（如 runtimeDomain、token）会被透传到最终配置。
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * 方式 3：ClientConfig & { apiConfigName } — 引用注册配置 + 覆盖选项
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ *   适用场景：想复用预注册的模型定义，但需要自定义环境、认证等。
+ *   合并策略：注册配置提供 appCode + models；其余字段由传入对象覆盖。
+ *   示例：
+ *     registerModels({ appCode: 'my-app', models: [...] }, 'prod');
+ *     const client = createClient({
+ *       apiConfigName: 'prod',   // 从注册表取模型
+ *       env: 'staging',          // 覆盖为 staging 环境
+ *       token: 'xxx',            // 附加认证信息
+ *     });
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * 方式 4：ClientConfig — 完整配置对象
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ *   适用场景：不依赖任何预注册配置，显式传入全部所需字段。
+ *   示例：
+ *     const client = createClient({
+ *       appCode: 'my-app',
+ *       env: 'production',
+ *       models: { chat: { modelId: 'gpt-4o' } },
+ *       token: 'xxx',
+ *     });
+ *   env 缺省时自动填充 DEFAULTS.ENV；models 缺省时为 {}。
+ *
+ * @param config - 客户端配置，支持以下类型：
+ *   - string: 注册的配置名称（如 'default', 'prod'）
+ *   - ModelsConfig: 纯模型配置对象
+ *   - ClientConfig: 完整的客户端配置对象
+ *   - ClientConfig & {apiConfigName}: 引用注册配置 + 额外选项
+ * @returns Lovrabet client instance
+ */
+declare function createClient(config?: Partial<ClientConfig> | ModelsConfig | string): LovrabetClient;
+
+/**
+ * 模型配置注册器 - 全局配置管理中心
+ *
+ * 设计目的：
+ * 1. 配置复用 - 避免在多处重复定义相同的模型配置
+ * 2. 多项目支持 - 在同一应用中管理多个项目的配置
+ * 3. 简化 API - 让 createClient() 可以无参数调用
+ * 4. 类型安全 - 通过命名常量避免字符串拼写错误
+ */
+
+/**
+ * 注册模型配置
+ *
+ * 为什么需要这个函数：
+ * 1. CLI 自动生成 - CLI 工具会调用此函数自动注册配置
+ * 2. 手动配置场景 - 用户可以手动注册多个环境或项目的配置
+ * 3. 配置集中管理 - 统一的地方管理所有模型配置
+ *
+ * @param config 模型配置对象
+ * @param name 配置名称，默认为 'default'
+ */
+declare function registerModels(config: ModelsConfig, name?: string): void;
+/**
+ * 获取已注册的模型配置
+ * @param name 配置名称
+ * @returns 模型配置对象
+ */
+declare function getRegisteredModels(name: string): ModelsConfig | undefined;
+/**
+ * 获取所有已注册的配置名称
+ * @returns 配置名称数组
+ */
+declare function getRegisteredConfigNames(): string[];
+/**
+ * 清除指定配置
+ * @param name 配置名称
+ */
+declare function unregisterModels(name: string): boolean;
+/**
+ * 清除所有配置
+ */
+declare function clearAllRegistrations(): void;
+
+/** Mainland China endpoints retained as the backward-compatible public export. */
+declare const API_ENDPOINTS: {
+    readonly production: "https://runtime.lovrabet.com";
+    readonly online: "https://runtime.lovrabet.com";
+    readonly development: "https://dev.lovrabet.com";
+    readonly daily: "https://daily-runtime.lovrabet.com";
+};
+type Environment = keyof typeof API_ENDPOINTS;
+/**
+ * 获取指定环境的 API 端点（支持向下兼容）
+ * @param env - 环境名称（支持 "production", "online", "daily", "dev", "development"）
+ * @param region - 官方节点；支持值来自生成的节点目录，省略时使用目录默认节点
+ * @returns API 端点 URL
+ */
+declare function getApiEndpoint(env: Environment | string, region?: Region | string): string;
+/** Returns official regions supported by the SDK's built-in Runtime mapping. */
+declare function getAvailableRegions(): Region[];
+/**
+ * 获取所有可用的环境
+ * @returns 环境列表（返回标准化的环境名）
+ */
+declare function getAvailableEnvironments(): string[];
+
+/**
+ * 默认配置名称常量
+ */
+declare const CONFIG_NAMES: {
+    /** 默认配置名称 */
+    readonly DEFAULT: "default";
+    /** 生产环境配置 */
+    readonly PROD: "prod";
+    /** 开发环境配置 */
+    readonly DEV: "dev";
+    /** 测试环境配置 */
+    readonly TEST: "test";
+};
+/**
+ * 环境常量
+ */
+declare const ENVIRONMENTS: {
+    /** 线上环境（推荐使用 production） */
+    readonly ONLINE: "online";
+    /** 线上环境（新版推荐） */
+    readonly PRODUCTION: "production";
+    /** 日常环境 */
+    readonly DAILY: "daily";
+    /** 开发环境 */
+    readonly DEVELOPMENT: "development";
+};
+/**
+ * Lovrabet official deployment regions.
+ */
+declare const REGIONS: {
+    readonly CN: "cn";
+    readonly ID: "id";
+};
+/**
+ * HTTP 状态码常量
+ */
+declare const HTTP_STATUS: {
+    readonly OK: 200;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly INTERNAL_ERROR: 500;
+};
+/**
+ * 默认配置值
+ */
+declare const DEFAULTS: {
+    /** 默认环境（向下兼容 online，推荐使用 production） */
+    readonly ENV: "production";
+    /** 默认超时时间（毫秒） */
+    readonly TIMEOUT: 30000;
+    /** 默认重试次数 */
+    readonly RETRY_COUNT: 3;
+    /** 默认页大小 */
+    readonly PAGE_SIZE: 20;
+    /** 默认当前页 */
+    readonly CURRENT_PAGE: 1;
+};
+/**
+ * 错误消息常量
+ */
+declare const ERROR_MESSAGES: {
+    readonly APP_CODE_REQUIRED: "appCode is required. Please provide it in the config or register models first.";
+    readonly CONFIG_NOT_FOUND: (name: string) => string;
+    readonly INVALID_ENV: "Invalid environment. Must be \"production\", \"online\" (deprecated), \"daily\", or \"development\".";
+    readonly NETWORK_ERROR: "Network request failed";
+    readonly UNAUTHORIZED: "Unauthorized access";
+    readonly FORBIDDEN: "Access forbidden";
+    readonly NOT_FOUND: "Resource not found";
+    readonly SERVER_ERROR: "Internal server error";
+};
+/**
+ * API 路径模板
+ */
+declare const API_PATHS: {
+    /** 基础 API 路径模板 */
+    readonly BASE: "/api/{appCode}/{datasetCode}";
+    /** 列表查询路径 */
+    readonly LIST: "";
+    /** 单条记录路径 */
+    readonly DETAIL: "/{id}";
+};
+
+type ErrorDescription = string | Record<string, unknown> | unknown[];
+declare class LovrabetError extends Error {
+    readonly name = "LovrabetError";
+    readonly status?: number;
+    readonly code?: string;
+    readonly response?: any;
+    readonly retryAfter?: string;
+    readonly description?: ErrorDescription;
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        response?: any;
+        retryAfter?: string;
+        description?: ErrorDescription;
+        cause?: unknown;
+    });
+    toJSON(): {
+        description: ErrorDescription;
+        cause: unknown;
+        retryAfter?: string;
+        name: string;
+        message: string;
+        status: number;
+        code: string;
+        response: any;
+    };
+}
+
+/**
+ * 安全执行结果类型
+ *
+ * @example
+ * ```typescript
+ * const { data, error } = await safe(client.models.customer.filter({ ... }));
+ * if (error) {
+ *   console.error(error.message, error.description);
+ *   return;
+ * }
+ * // 使用 data
+ * ```
+ */
+interface SafeResult<T> {
+    /** 成功时的数据，失败时为 null */
+    data: T | null;
+    /** 失败时的错误对象，成功时为 null */
+    error: LovrabetError | null;
+}
+/**
+ * Promise 或返回 Promise 的函数类型
+ */
+type PromiseLike<T> = Promise<T> | (() => Promise<T>);
+/**
+ * 安全执行 Promise，将异常转换为返回值
+ *
+ * @param fn - Promise 或返回 Promise 的函数
+ * @returns 包含 data 和 error 的结果对象
+ *
+ * @example
+ * ```typescript
+ * // 直接传入 Promise
+ * const { data, error } = await safe(client.models.customer.filter({ where: { status: 'active' } }));
+ * if (error) {
+ *   console.error(error.message);
+ *   return;
+ * }
+ * console.log(data);
+ *
+ * // 传入函数（延迟执行）
+ * const { data, error } = await safe(() => client.models.customer.filter({ ... }));
+ *
+ * // 旧代码继续工作（抛异常模式）
+ * try {
+ *   const data = await client.models.customer.filter({ ... });
+ *   console.log(data);
+ * } catch (error) {
+ *   console.error(error);
+ * }
+ * ```
+ */
+declare function safe<T>(fn: PromiseLike<T>): Promise<SafeResult<T>>;
+
+/**
+ * sqlSafe 执行结果类型
+ *
+ * @example
+ * ```typescript
+ * const { data, error } = await sqlSafe(() => client.sql.execute(...));
+ * if (error) {
+ *   console.error(error.message, error.code, error.cause);
+ *   return;
+ * }
+ * // data 直接是查询结果数组
+ * data.forEach(row => console.log(row));
+ * ```
+ */
+interface SqlSafeResult<T> {
+    /** 成功时的查询结果数组，失败时为 null */
+    data: T[] | null;
+    /** 失败时的错误对象，成功时为 null */
+    error: LovrabetError | null;
+}
+/**
+ * Promise 或返回 Promise 的函数类型
+ */
+type SqlPromiseLike<T> = Promise<SqlExecuteResult<T>> | (() => Promise<SqlExecuteResult<T>>);
+/**
+ * 安全执行 SQL 查询，统一处理 HTTP 错误和业务逻辑错误
+ *
+ * @param fn - 返回 SqlExecuteResult 的 Promise 或函数
+ * @returns 包含 data（查询结果数组）和 error 的结果对象
+ *
+ * @example
+ * ```typescript
+ * // 基础用法
+ * const { data, error } = await sqlSafe(() =>
+ *   client.sql.execute({ sqlCode: 'fc8e7777-06e3847d' })
+ * );
+ *
+ * if (error) {
+ *   console.error('查询失败:', error.message);
+ *   return;
+ * }
+ *
+ * // data 直接是查询结果数组
+ * console.log(`查询到 ${data.length} 条记录`);
+ * data.forEach(row => console.log(row));
+ *
+ * // 带类型提示
+ * interface UserStat {
+ *   id: number;
+ *   name: string;
+ *   login_count: number;
+ * }
+ *
+ * const { data, error } = await sqlSafe<UserStat>(() =>
+ *   client.sql.execute({ sqlCode: 'user-stats' })
+ * );
+ *
+ * if (error) {
+ *   if (error.code === 'SQL_ERROR') {
+ *     // 业务逻辑失败（execSuccess = false）
+ *     console.error('SQL 执行失败:', error.cause);
+ *   } else {
+ *     // HTTP 错误（404、500 等）
+ *     console.error('请求失败:', error.status, error.message);
+ *   }
+ *   return;
+ * }
+ *
+ * // data 是 UserStat[]
+ * data.forEach(stat => {
+ *   console.log(`${stat.name}: ${stat.login_count} 次登录`);
+ * });
+ * ```
+ */
+declare function sqlSafe<T>(fn: SqlPromiseLike<T>): Promise<SqlSafeResult<T>>;
+
+/**
+ * 抽象基础模型类
+ * 定义所有模型的通用接口和基础实现
+ */
+declare abstract class AbstractBaseModel implements BaseModelMethods {
+    /** 数据集代码（用于 API 调用） */
+    protected datasetCode: string;
+    /**
+     * 模型名称，对应 ModelConfig.alias（人类可读别名）
+     * @deprecated 直接使用 config.alias 或 datasetCode
+     */
+    protected modelName: string;
+    protected httpClient: HttpClient;
+    protected config: ModelConfig;
+    protected appCode: string;
+    protected globalConfig: ClientConfig;
+    /**
+     * 构造函数
+     * @param datasetCode 数据集代码
+     * @param httpClient HTTP 客户端
+     * @param globalConfig 全局配置
+     * @param modelConfig 模型配置（直接传入，不再从 globalConfig 中查找）
+     */
+    constructor(datasetCode: string, httpClient: HttpClient, globalConfig: ClientConfig, modelConfig: ModelConfig);
+    protected abstract getApiPath(method: string): string;
+    protected abstract buildRequestBody(method: string, data: any, sortList?: SortList): any;
+    /**
+     * 规范化列表响应：确保 paging 字段存在（兜底空对象）
+     */
+    private normalizeListResponse;
+    private normalizeAggregateParams;
+    getList<T = any>(params?: ListParams, sortList?: SortList): Promise<ListResponse<T>>;
+    filter<T = any>(params?: FilterParams): Promise<ListResponse<T>>;
+    getOne<T = any>(idOrParams: string | number | {
+        id: string | number;
+    }): Promise<T>;
+    create<T = any>(data: Record<string, any>): Promise<T>;
+    batchCreate<T = any>(items: Record<string, any>[]): Promise<T>;
+    /**
+     * 更新记录，支持单条和批量。
+     *
+     * **推荐写法（对象合并）**：将 id 与更新字段合并为一个对象传入：
+     * ```typescript
+     * await model.update({ id: 1001, name: '张三' });
+     * await model.update({ id: [1001, 1002], status: 'active' });
+     * ```
+     *
+     * **兼容写法（id 分离）**：
+     * ```typescript
+     * await model.update(1001, { name: '张三' });
+     * await model.update([1001, 1002, 1003], { status: 'active' });
+     * ```
+     */
+    update<T = any>(idOrData: string | number | (string | number)[] | {
+        id: string | number | (string | number)[];
+        [key: string]: any;
+    }, data?: Record<string, any>): Promise<T>;
+    /**
+     * 删除记录，支持单条和批量。
+     *
+     * **推荐写法（对象传入）**：
+     * ```typescript
+     * await model.delete({ id: 1001 });
+     * await model.delete({ id: [1001, 1002, 1003] });
+     * ```
+     *
+     * **兼容写法（直接传 id）**：
+     * ```typescript
+     * await model.delete(1001);
+     * await model.delete([1001, 1002, 1003]);
+     * ```
+     */
+    delete(idOrParams: string | number | (string | number)[] | {
+        id: string | number | (string | number)[];
+    }): Promise<void>;
+    getSelectOptions(params: SelectOptionsParams): Promise<SelectOption[]>;
+    excelExport<T = any>(params?: ListParams): Promise<T>;
+    aggregate<T = any>(params?: AggregateParams): Promise<ListResponse<T>>;
+    getConfig(): ModelConfig;
+    /**
+     * 获取模型名称（alias 优先，降级为 datasetCode）
+     * @deprecated 建议直接使用 getConfig().alias 或 getConfig().datasetCode
+     */
+    getModelName(): string;
+}
+
+/**
+ * OpenAPI 模型实现
+ * 处理 OpenAPI 模式下的 URL 生成和请求体构建
+ */
+declare class OpenApiModel extends AbstractBaseModel {
+    /**
+     * OpenAPI 模式的 URL 生成策略
+     */
+    protected getApiPath(sdkMethod: string): string;
+    /**
+     * OpenAPI 模式的请求体构建策略
+     * 认证信息（token、timeStamp）由 HttpClient 自动添加到请求头（Header）中
+     * 请求体格式：{ appCode, datasetCode, paramMap }；batchCreate 为数组体，使用 paramList（与 paramMap 互斥语义）
+     */
+    protected buildRequestBody(method: string, data: any, sortList?: SortList): any;
+    /**
+     * OpenAPI 模式暂不支持 delete 操作
+     * @throws LovrabetError 当尝试调用 delete 时抛出错误
+     */
+    delete(): Promise<void>;
+    /**
+     * OpenAPI 模式暂不支持 excelExport 操作
+     * @throws LovrabetError 当尝试调用 excelExport 时抛出错误
+     */
+    excelExport(params?: any): Promise<any>;
+}
+
+/**
+ * WebAPI 模型实现
+ * 处理 WebAPI 模式下的 URL 生成和请求体构建
+ */
+declare class WebApiModel extends AbstractBaseModel {
+    /**
+     * WebAPI 模式的 URL 生成策略
+     */
+    protected getApiPath(sdkMethod: string): string;
+    /**
+     * WebAPI 模式的请求体构建策略
+     */
+    protected buildRequestBody(method: string, data: any, sortList?: SortList): any;
+}
+
+/** 导入协商结果（后端 DatasetImportService.contract）。 */
+interface DatasetImportContract {
+    schemaVersion: number;
+    strategy: string;
+    source: string;
+    appCode: string;
+    datasetCode: string;
+    actorId: string;
+    schemaFingerprint: string;
+    maxBatchSize: number;
+    maxBatchBytes: number;
+    imageImport?: {
+        version: number;
+        maxFileBytes: number;
+        maxPixels: number;
+        types: string[];
+        uploadId: string;
+    };
+}
+/**
+ * 可恢复导入的批次请求体（后端 `import-batch`）。
+ *
+ * 请求体必须包含 `schemaFingerprint` 与 `items`（1~500 条）；
+ * 传入 `taskId` 时走 auto-id 分支。
+ */
+interface DatasetImportBatchRequest {
+    schemaFingerprint: string;
+    items: Record<string, unknown>[];
+    /** 正安全整数，以 JSON 数字发送。 */
+    taskId?: number;
+}
+/**
+ * 可恢复导入的批次响应（后端返回 `{ ids, count }`）。
+ */
+interface DatasetImportBatchResult {
+    ids: number[];
+    count: number;
+}
+/** 回读请求只允许 ids 或 taskId；ID 均须为安全整数。 */
+type DatasetImportReadbackRequest = {
+    ids: number[];
+    taskId?: never;
+} | {
+    taskId: number;
+    ids?: never;
+};
+/** 导入回读结果。 */
+interface DatasetImportReadbackResult<T = Record<string, unknown>> {
+    items: T[];
+}
+/**
+ * 图片上传参数（`import-image` 为 multipart/form-data）。
+ */
+interface DatasetImportImageRequest {
+    importId: string;
+    contentHash: string;
+    file: Blob;
+    fileName?: string;
+}
+/**
+ * 图片回读参数（`import-image-readback` 的 body 必须恰好包含这四个字段）。
+ */
+interface DatasetImportImageReadbackRequest {
+    importId: string;
+    contentHash: string;
+    type: string;
+    size: number;
+}
+/** 图片上传及回读结果；missing 时仅返回 status 和 contentHash。 */
+interface DatasetImportImageResult {
+    status: 'succeeded' | 'missing';
+    contentHash: string;
+    filePath?: string;
+    fileName?: string;
+    type?: string;
+    size?: number;
+}
+/**
+ * Client AK 模型实现
+ *
+ * 路由到 /client/{appCode}/{datasetCode}/ 前缀，
+ * 鉴权使用 X-User-AK（由 AuthManager 在 HttpClient 层自动注入）。
+ *
+ * 请求体策略：直接透传（不包装 paramMap）。
+ *
+ * 除标准 CRUD 外，本类还承载 `import-*` 可恢复导入能力。
+ * 这些方法只在 client-ak 模式可用，因此没有放进 `AbstractBaseModel`。
+ * 通过 `client.models.X` 访问时需要显式收窄类型：
+ * `client.getModel('X') as ClientAkModel`。
+ */
+declare class ClientAkModel extends AbstractBaseModel {
+    protected getApiPath(sdkMethod: string): string;
+    protected buildRequestBody(method: string, data: any, sortList?: SortList): any;
+    /** 导入契约（`GET /client/{appCode}/{datasetCode}/import-contract`） */
+    importContract<T = DatasetImportContract>(): Promise<T>;
+    /** 批量导入（`POST /client/{appCode}/{datasetCode}/import-batch`） */
+    importBatch(request: DatasetImportBatchRequest): Promise<DatasetImportBatchResult>;
+    /** 回读导入结果（`POST /client/{appCode}/{datasetCode}/import-readback`） */
+    importReadback<T = Record<string, unknown>>(request: number[] | DatasetImportReadbackRequest): Promise<DatasetImportReadbackResult<T>>;
+    /** 上传导入图片（`POST /client/{appCode}/{datasetCode}/import-image`，multipart） */
+    importImage<T = DatasetImportImageResult>(request: DatasetImportImageRequest): Promise<T>;
+    /** 回读导入图片（`POST /client/{appCode}/{datasetCode}/import-image-readback`） */
+    importImageReadback<T = DatasetImportImageResult>(request: DatasetImportImageReadbackRequest): Promise<T>;
+    private importPath;
+}
+
+/**
+ * 模型工厂类
+ * 根据配置决定创建 OpenAPI、WebAPI 或 ClientAK 模型实例
+ *
+ * 规则：无 authMode → cookie(即 webapi)；有 authMode 则严格遵循。
+ */
+declare class ModelFactory {
+    static createModel(datasetCode: string, httpClient: HttpClient, globalConfig: ClientConfig, modelConfig: ModelConfig): BaseModelMethods;
+    /**
+     * 无 authMode → cookie(webapi)；有 authMode 则严格遵循
+     */
+    private static resolveAuthMode;
+    static getModeName(config: ClientConfig): 'OpenAPI' | 'WebAPI' | 'ClientAK';
+}
+
+declare class AuthManager {
+    private config;
+    private openApiAuth?;
+    private cookieAuth?;
+    private clientAkAuth?;
+    constructor(config: ClientConfig);
+    private initAuthMethods;
+    getAuthHeaders(appCode?: string, datasetCode?: string): Promise<AuthHeaders>;
+    getFlowAuthContext(appCode: string, operatorUserId: string): Promise<OpenApiAuthContext>;
+    validateAuth(): Promise<boolean>;
+    isCookieAuth(): boolean;
+    isClientAkAuth(): boolean;
+    hasExplicitCookie(): boolean;
+    setToken(token: string, timestamp?: number): void;
+}
+
+/**
+ * 检查 Token 是否即将过期
+ *
+ * @param timestamp Token 的时间戳
+ * @param bufferMinutes 提前多少分钟认为过期（默认1分钟）
+ * @returns 是否即将过期
+ */
+declare function isTokenExpiring$1(timestamp: number, bufferMinutes?: number): boolean;
+/**
+ * 计算 Token 剩余有效时间
+ *
+ * @param timestamp Token 的时间戳
+ * @returns 剩余有效时间（毫秒），如果已过期返回 0
+ */
+declare function getTokenRemainingTime$1(timestamp: number): number;
+
+/**
+ * OpenAPI Token 生成工具
+ *
+ * 为 Node.js 服务端提供 token 生成功能，用于：
+ * 1. 后端生成 token 和 timestamp 配对
+ * 2. 返回给前端使用，避免前端存储 accessKey
+ * 3. 保证 token 和 timestamp 的正确配对
+ */
+
+/**
+ * Token 生成参数
+ */
+interface GenerateTokenParams {
+    /** 应用代码 */
+    appCode: string;
+    /** 数据集代码 */
+    datasetCode: string;
+    /** API 访问密钥 */
+    accessKey: string;
+    /** API 密钥（可选，有默认值） */
+    secretKey?: string;
+    /** 自定义时间戳（可选，默认为当前时间） */
+    timestamp?: number;
+}
+/** Flow OpenAPI Token 生成参数。 */
+interface GenerateFlowTokenParams {
+    /** 应用代码 */
+    appCode: string;
+    /** 本次 Flow 调用绑定的操作人用户 ID */
+    operatorUserId: string;
+    /** API 访问密钥 */
+    accessKey: string;
+    /** API 密钥（可选，有默认值） */
+    secretKey?: string;
+    /** 自定义时间戳（可选，默认为当前时间） */
+    timestamp?: number;
+}
+/**
+ * Token 生成结果
+ */
+interface TokenResult {
+    /** 生成的 token */
+    token: string;
+    /** 配对的时间戳 */
+    timestamp: number;
+    /** Token 过期时间（10分钟后） */
+    expiresAt: number;
+}
+/**
+ * 生成 OpenAPI 认证 Token
+ *
+ * @description
+ * 用于后端生成 token 和 timestamp 配对，返回给前端使用。
+ * Token 有效期为 10 分钟，由服务端验证。
+ *
+ * @example
+ * ```typescript
+ * // Node.js 后端代码
+ * import { generateOpenApiToken } from '@lovrabet/sdk';
+ *
+ * // 生成 token
+ * const result = await generateOpenApiToken({
+ *   appCode: 'app-123',
+ *   datasetCode: 'dataset-456',
+ *   accessKey: process.env.ACCESS_KEY,
+ *   secretKey: process.env.SECRET_KEY // 可选
+ * });
+ *
+ * // 返回给前端
+ * res.json({
+ *   token: result.token,
+ *   timestamp: result.timestamp,
+ *   expiresAt: result.expiresAt
+ * });
+ * ```
+ *
+ * @param params Token 生成参数
+ * @returns Token 和配对的 timestamp
+ */
+declare function generateOpenApiToken(params: GenerateTokenParams): Promise<TokenResult>;
+/**
+ * 为浏览器或其他不保存 accessKey 的调用方生成 Flow OpenAPI Token。
+ * Token 与 appCode、operatorUserId、timestamp 绑定，三者必须原样用于请求。
+ */
+declare function generateFlowOpenApiToken(params: GenerateFlowTokenParams): Promise<TokenResult>;
+/**
+ * Token 生成器类（可选的面向对象接口）
+ *
+ * @example
+ * ```typescript
+ * const generator = new TokenGenerator({
+ *   accessKey: 'ak-xxx',
+ *   secretKey: 'sk-xxx'
+ * });
+ *
+ * const result = await generator.generate({
+ *   appCode: 'app-123',
+ *   datasetCode: 'dataset-456'
+ * });
+ * ```
+ */
+declare class TokenGenerator {
+    private accessKey;
+    private secretKey;
+    constructor(config: {
+        accessKey: string;
+        secretKey?: string;
+    });
+    /**
+     * 生成 Token
+     */
+    generate(params: {
+        appCode: string;
+        datasetCode: string;
+        timestamp?: number;
+    }): Promise<TokenResult>;
+    /** 为指定操作人生成 Flow OpenAPI Token。 */
+    generateFlow(params: {
+        appCode: string;
+        operatorUserId: string;
+        timestamp?: number;
+    }): Promise<TokenResult>;
+    /**
+     * 批量生成 Token（为多个数据集生成 token）
+     */
+    generateBatch(params: {
+        appCode: string;
+        datasetCodes: string[];
+        timestamp?: number;
+    }): Promise<Map<string, TokenResult>>;
+}
+/**
+ * 验证 Token 是否即将过期
+ * @description 重新导出共享工具函数
+ */
+declare const isTokenExpiring: typeof isTokenExpiring$1;
+/**
+ * 计算 Token 剩余有效时间
+ * @description 重新导出共享工具函数
+ */
+declare const getTokenRemainingTime: typeof getTokenRemainingTime$1;
+
+export { API_PATHS, AbstractBaseModel, ApiNamespace, AppClient, ApprovalClient, ArtifactClient, AuthManager, CONFIG_NAMES, ClientAkBffClient, ClientAkModel, ClientAkSqlClient, DEFAULTS, DatasetMetaClient, ENVIRONMENTS, ERROR_MESSAGES, FileClient, HTTP_STATUS, LovrabetError, LovrabetFlowClient, ManagementClient, ModelFactory, OCR_TYPES, OcrClient, OcrType, OpenApiModel, PermitClient, PersonalBffClient, PersonalNamespace, REGIONS, ServicesNamespace, SortOrder, TokenGenerator, WebApiModel, clearAllRegistrations, createAppClient, createClient, generateFlowOpenApiToken, generateOpenApiToken, getApiEndpoint, getAvailableEnvironments, getAvailableRegions, getRegisteredConfigNames, getRegisteredModels, getTokenRemainingTime, isTokenExpiring, registerModels, safe, sqlSafe, unregisterModels };
+export type { AggregateField, AggregateParams, AppClientConfig, AppDatasetActionRolePermitVO, AppDatasetPermitVO, AppDatasetRolePermitVO, AppEmployee, AppMenuPermitVO, AppPermitBaseVO, AppResourceMenuParam, AppRoleCreateParam, AppRolePermitQueryParam, AppRoleRequest, AppRoleUpdateParam, AppRoleUserVO, AppRoleVO, AppUserBaseVO, ApprovalFlowApproveRequest, ApprovalFlowIdentityLink, ApprovalFlowTaskDetail, ApprovalFlowTaskItem, ApprovalFlowTransferCandidate, ApprovalFlowTransferRequest, ApprovalTodoQuery, ArtifactListQuery, ArtifactUpsertRequest, AuthMode, BaseModelMethods, BaseRoleVO, ClientAkBffExecuteRequest, ClientConfig, ConditionOperator, CustomSqlQueryRequest, DataList, DatasetDrivenDataQuery, DatasetImportBatchRequest, DatasetImportBatchResult, DatasetImportContract, DatasetImportImageReadbackRequest, DatasetImportImageRequest, DatasetImportImageResult, DatasetImportReadbackRequest, DatasetImportReadbackResult, DatasetMeta, DatasetPermitListVO, DatasetRequest, DatasetRolePermitListVO, EndpointScriptSummary, Environment$1 as Environment, FieldCondition, FileQueryUrlRequest, FileService, FileUploadRequest, FileUploadResponse, FileUrlResponse, FilterParams, FlowBatchTaskActionRequest, FlowBatchTransferRequest, FlowCcQuery, FlowCcRequest, FlowCustomPageCcDetail, FlowCustomPageDefinition, FlowCustomPageStartResponse, FlowCustomPageSubmittedProcess, FlowCustomPageTaskDetail, FlowCustomPageTaskItem, FlowCustomPageTimeline, FlowDefinitionQuery, FlowPage, FlowPageQuery, FlowProcessReasonRequest, FlowRecord, FlowResubmitRequest, FlowReturnRequest, FlowReturnTarget, FlowStartRequest, FlowSubmittedQuery, FlowTaskActionRequest, FlowTransferRequest, FlowUpdateVariablesRequest, FlowVariableProjectionQuery, FlowVariableQuery, GenerateFlowTokenParams, GenerateTokenParams, HavingCondition, ListParams, ListResponse, LoginUserInfo, LovrabetClient$1 as LovrabetClient, LovrabetPersonal, LovrabetServices, MenuPermitDTO, MenuRolePermitListVO, MenuRolePermitNodeVO, ModelConfig, ModelsConfig, NotificationChannelConfig, OcrRecognizeRequest, OcrRecognizeResponse, OcrService, PageResult, Paging$1 as Paging, PersonalBffExecuteRequest, PersonalBffScript, PersonalBffService, PersonalBffUpsertRequest, PersonalRequestOptions, Region, ResourcePermitDTO, ResourcePermitParam, RoleUserUpdateParam, RuntimeArtifactDTO, RuntimeIdentityPermission, SafeResult, ScriptDefinition, ScriptLogQuery, SelectOption, SelectOptionsParams, ServiceRequestOptions, SmartApp, SortList, SqlExecuteRequest, SqlExecuteResult, SqlSafeResult, TokenResult, UserAccountBindRequest, UserAppRelation, UserAppRelationQueryParam, UserCustomSqlDTO, WhereCondition };