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

package/dist/index.d.ts

@@ -20,6 +20,8 @@ declare class HttpClient {
      * 通用的错误处理包装器
      */
     private executeWithErrorHandling;
+    /** Apply the request deadline until response parsing finishes, preserving caller cancellation. */
+    private withTimeout;
     /**
      * 通用的fetch请求方法（用于PUT/DELETE等没有专门优化函数的方法）
      */
@@ -257,12 +259,14 @@ declare class DatasetMetaClient {
 }
 
 /**
- * 登录用户信息（后端 `UserSessionHolder.getUser()`，字段随租户扩展）
+ * 登录用户信息（后端 `UserSessionHolder.getUser()` 返回的 `User`）。
  */
 interface LoginUserInfo {
-    userId?: string;
-    userName?: string;
-    nickName?: string;
+    id?: string;
+    userId?: number;
+    username?: string;
+    nickname?: string;
+    name?: string | null;
     mobile?: string;
     email?: string;
     avatar?: string;
@@ -308,6 +312,12 @@ interface NotificationChannelConfig {
     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 模式）。
  *
@@ -318,7 +328,7 @@ declare class AppClient {
     private readonly httpClient;
     private readonly appCode;
     private readonly authMode;
-    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    constructor(httpClient: HttpClient, appCode: string | undefined, authMode: AuthMode);
     /** 当前用户可见的应用（`GET /client/app/my-apps`） */
     myApps(): Promise<SmartApp[]>;
     /** 当前登录用户信息（`GET /client/user/loginUserInfo`） */
@@ -330,6 +340,7 @@ declare class AppClient {
     /** 查询通知渠道配置（`GET /client/notification/channel-config/list`） */
     listNotificationChannels(channelType?: string): Promise<NotificationChannelConfig[]>;
     private assertMode;
+    private requireAppCode;
 }
 
 /**
@@ -2026,8 +2037,10 @@ interface ClientConfig {
     apiConfigName?: string;
     /** 额外配置选项 */
     options?: {
-        /** 请求超时时间（毫秒） */
+        /** 请求超时时间（毫秒），包含响应体读取；未配置时保留原行为（PUT/DELETE 默认 30000，其他不限时）。 */
         timeout?: number;
+        /** Fetch 重定向策略；未配置时沿用 Fetch 默认行为。 */
+        redirect?: RequestRedirect;
         /** 重试次数 */
         retryCount?: number;
         /** 错误处理回调函数 */
@@ -3000,23 +3013,26 @@ declare class LovrabetError extends Error {
     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;
-        description: ErrorDescription;
-        cause: unknown;
     };
 }
 
@@ -3277,6 +3293,25 @@ declare class WebApiModel extends AbstractBaseModel {
     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`）。
  *
@@ -3284,20 +3319,27 @@ declare class WebApiModel extends AbstractBaseModel {
  * 传入 `taskId` 时走 auto-id 分支。
  */
 interface DatasetImportBatchRequest {
-    schemaFingerprint?: string;
+    schemaFingerprint: string;
     items: Record<string, unknown>[];
-    taskId?: string;
+    /** 正安全整数，以 JSON 数字发送。 */
+    taskId?: number;
 }
 /**
  * 可恢复导入的批次响应（后端返回 `{ ids, count }`）。
  */
 interface DatasetImportBatchResult {
-    ids: Array<string | number>;
+    ids: number[];
     count: number;
 }
-/**
- * 导入回读参数（`import-readback` 的 body 只允许包含 `ids`）。
- */
+/** 回读请求只允许 ids 或 taskId；ID 均须为安全整数。 */
+type DatasetImportReadbackRequest = {
+    ids: number[];
+    taskId?: never;
+} | {
+    taskId: number;
+    ids?: never;
+};
+/** 导入回读结果。 */
 interface DatasetImportReadbackResult<T = Record<string, unknown>> {
     items: T[];
 }
@@ -3319,6 +3361,15 @@ interface DatasetImportImageReadbackRequest {
     type: string;
     size: number;
 }
+/** 图片上传及回读结果；missing 时仅返回 status 和 contentHash。 */
+interface DatasetImportImageResult {
+    status: 'succeeded' | 'missing';
+    contentHash: string;
+    filePath?: string;
+    fileName?: string;
+    type?: string;
+    size?: number;
+}
 /**
  * Client AK 模型实现
  *
@@ -3336,15 +3387,15 @@ 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 = unknown>(): Promise<T>;
+    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>>(ids: Array<string | number>): Promise<DatasetImportReadbackResult<T>>;
+    importReadback<T = Record<string, unknown>>(request: number[] | DatasetImportReadbackRequest): Promise<DatasetImportReadbackResult<T>>;
     /** 上传导入图片（`POST /client/{appCode}/{datasetCode}/import-image`，multipart） */
-    importImage<T = unknown>(request: DatasetImportImageRequest): Promise<T>;
+    importImage<T = DatasetImportImageResult>(request: DatasetImportImageRequest): Promise<T>;
     /** 回读导入图片（`POST /client/{appCode}/{datasetCode}/import-image-readback`） */
-    importImageReadback<T = unknown>(request: DatasetImportImageReadbackRequest): Promise<T>;
+    importImageReadback<T = DatasetImportImageResult>(request: DatasetImportImageReadbackRequest): Promise<T>;
     private importPath;
 }
 
@@ -3537,5 +3588,5 @@ declare const isTokenExpiring: typeof isTokenExpiring$1;
  */
 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, createClient, generateFlowOpenApiToken, generateOpenApiToken, getApiEndpoint, getAvailableEnvironments, getAvailableRegions, getRegisteredConfigNames, getRegisteredModels, getTokenRemainingTime, isTokenExpiring, registerModels, safe, sqlSafe, unregisterModels };
-export type { AggregateField, AggregateParams, 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, DatasetImportImageReadbackRequest, DatasetImportImageRequest, 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 };
+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 };