@lovrabet/rabetbase-cli 2.3.16-beta.4 → 2.3.16-beta.6

package/lib/core/api-client.d.ts

@@ -0,0 +1,1018 @@
+/**
+ * 分域 API 客户端
+ *
+ * 按业务域组织（bff / sql / dataset / dblink / db-analysis），与研发态 OpenAPI 路径前缀自然对齐。
+ * 统一认证、超时、错误处理；命令层通过导出函数调用。
+ */
+import type { Paging } from "../framework/response.js";
+import type { FetchDocOptions, FetchModelListResult } from "../types/index.js";
+export declare function setActiveCookie(cookie: string): void;
+export declare function clearActiveCookie(): void;
+export declare function isPlatformTransportFailure(error: unknown): boolean;
+export declare function getPlatformErrorCode(error: unknown): string | undefined;
+export interface DevelopmentFileUploadResponse {
+    fileName?: string | null;
+    filePath?: string | null;
+    fileUrl?: string | null;
+    downloadFlag?: boolean;
+    fileType?: string | null;
+    size?: number | null;
+    sourceDir?: string | null;
+    [key: string]: unknown;
+}
+export interface DevelopmentFileUrlResponse {
+    fileName?: string | null;
+    filePath?: string | null;
+    fileUrl?: string | null;
+    downloadFlag?: boolean;
+    longTerm?: boolean;
+    expiresInDays?: number | null;
+    [key: string]: unknown;
+}
+export interface DevelopmentOcrResponse {
+    text?: string | null;
+    lines?: string[];
+    type?: string | null;
+    width?: number | null;
+    height?: number | null;
+    pageNo?: number | null;
+    subImageCount?: number | null;
+    algoVersion?: string | null;
+    kvExcelUrl?: string | null;
+    xmlResult?: string | null;
+    rawData?: string | null;
+    kvData?: Record<string, string>;
+    requestId?: string | null;
+    [key: string]: unknown;
+}
+export declare function uploadDevelopmentFile(appCode: string, filePath: string): Promise<DevelopmentFileUploadResponse>;
+export declare function queryDevelopmentFileUrl(filePath: string, options?: {
+    download?: boolean;
+    longTerm?: boolean;
+}): Promise<DevelopmentFileUrlResponse>;
+export declare function recognizeDevelopmentOcr(appCode: string, input: {
+    url: string;
+    type: string;
+}): Promise<DevelopmentOcrResponse>;
+export interface PlatformFetchOptions {
+    method?: "GET" | "POST";
+    body?: Record<string, any>;
+    cookie: string;
+    /** 用于错误消息的操作标签 */
+    label: string;
+}
+/**
+ * 平台 API 统一 Fetch。
+ * 封装 Cookie / Content-Type / 401 → CliErrors.authRequired / !success 检查。
+ * 适用于不走 _activeCookie 管道、而由调用方显式传入 cookie 的场景。
+ */
+export declare function platformFetch<T = any>(url: string, opts: PlatformFetchOptions): Promise<T>;
+/**
+ * 平台 API path-based 请求入口。
+ *
+ * 新增服务端接口 wrapper 优先使用该函数，把 API 域名拼接收敛在 core 层。
+ * platformFetch 保留给历史调用与少数确需绝对 URL 的场景。
+ */
+export declare function platformRequest<T = any>(path: string, opts: PlatformFetchOptions): Promise<T>;
+export interface KnowledgeBaseRecord {
+    id: number;
+    scope: "company" | "personal";
+    appCode: string;
+    title: string;
+    version: number;
+    content: string;
+    createTime?: string | number | null;
+    updateTime?: string | number | null;
+}
+export interface KnowledgeBaseListFilters {
+    currentPage?: number;
+    pageSize?: number;
+    appCode?: string;
+    title?: string;
+}
+export declare function listEnterpriseKnowledgeBases(cookie: string, filters?: KnowledgeBaseListFilters): Promise<{
+    items: KnowledgeBaseRecord[];
+    paging?: Paging;
+}>;
+export declare function getEnterpriseKnowledgeBase(cookie: string, id: number): Promise<KnowledgeBaseRecord>;
+export declare function createEnterpriseKnowledgeBase(cookie: string, input: {
+    appCode: string;
+    title: string;
+    content: string;
+}): Promise<KnowledgeBaseRecord>;
+export declare function updateEnterpriseKnowledgeBase(cookie: string, input: {
+    id: number;
+    title?: string;
+    content?: string;
+}): Promise<KnowledgeBaseRecord>;
+export declare function deleteEnterpriseKnowledgeBase(cookie: string, id: number): Promise<void>;
+/**
+ * 获取研发态数据集模型列表。
+ */
+export declare function fetchModelList(appCode: string, cookie: string): Promise<FetchModelListResult>;
+/**
+ * 获取单个数据集的 Markdown 文档。
+ */
+export declare function fetchDatasetDoc(options: FetchDocOptions): Promise<string>;
+/**
+ * 获取在线菜单树。
+ */
+export interface MenuTreeRecord {
+    id: number;
+    appCode?: string | null;
+    parentId?: number | null;
+    path?: string | null;
+    url?: string | null;
+    label?: string | null;
+    type?: string | null;
+    visible?: boolean | null;
+    sort?: number | null;
+    pageId?: number | null;
+    pageType?: string | null;
+    modelType?: string | null;
+    datasetId?: number | null;
+    datasetCode?: string | null;
+    extend?: Record<string, unknown> | null;
+    createTime?: string | number | null;
+    updateTime?: string | number | null;
+    createUserId?: string | null;
+    createUserName?: string | null;
+    updateUserId?: string | null;
+    updateUserName?: string | null;
+    children?: MenuTreeRecord[];
+}
+export interface MenuCreateRecordInput {
+    appCode: string;
+    parentId?: number | null;
+    label: string;
+    path?: string;
+    url?: string;
+    type: string;
+    sort?: number;
+    visible?: boolean;
+    extend?: Record<string, unknown> | null;
+}
+export interface MenuUpdateRecordInput {
+    id: number;
+    appCode: string;
+    parentId?: number;
+    path?: string;
+    url?: string;
+    label?: string;
+    type?: string;
+    visible?: boolean;
+    sort?: number;
+    extend?: Record<string, unknown> | null;
+}
+export interface MenuMutationRecord extends Omit<MenuTreeRecord, "label" | "children"> {
+    label: string;
+    key?: string;
+    order?: number;
+    url?: string;
+    i18nKey?: string;
+    visibleType?: string | null;
+    mobileVisibleType?: string | null;
+    visibleScope?: unknown[];
+    externalDatasourceIds?: unknown[] | null;
+    formPath?: string | null;
+    materialDraftInfo?: unknown;
+    materialFormalInfo?: unknown;
+    deleted?: boolean;
+    children?: MenuMutationRecord[];
+}
+export interface MenuRegroupChildInput {
+    id: number;
+    label: string;
+}
+export interface MenuRegroupGroupInput {
+    label: string;
+    type: "folder";
+    description?: string;
+    children: MenuRegroupChildInput[];
+}
+export interface MenuRegroupInput {
+    appCode: string;
+    menuGroups: MenuRegroupGroupInput[];
+}
+export interface AsyncTaskStatusRecord {
+    taskId: string;
+    status: string;
+    errorMessage?: string | null;
+}
+export declare function getMenuTree(appCode: string, cookie: string): Promise<MenuTreeRecord[]>;
+/**
+ * 创建菜单记录。
+ */
+export declare function createMenuRecord(body: MenuCreateRecordInput, cookie: string, label: string): Promise<MenuMutationRecord>;
+/**
+ * 更新菜单记录。
+ */
+export declare function updateMenuRecord(body: MenuUpdateRecordInput, cookie: string, label: string): Promise<MenuMutationRecord>;
+/**
+ * 按 ID 删除菜单记录。
+ */
+export declare function deleteMenuRecord(id: number, cookie: string, label: string): Promise<boolean>;
+/**
+ * 按已审阅的 ID 列表批量删除菜单记录。
+ */
+export declare function batchDeleteMenuRecords(ids: number[], cookie: string, label: string): Promise<number>;
+/**
+ * 创建一个菜单重新分组任务。
+ *
+ * 返回的 taskId 跟踪后台执行的菜单重新分组任务。
+ */
+export declare function startMenuRegroup(body: MenuRegroupInput, cookie: string, label: string): Promise<AsyncTaskStatusRecord>;
+/**
+ * 查询一个应用范围内的通用异步任务状态。
+ */
+export declare function getAsyncTaskStatus(taskId: string, appCode: string, cookie: string): Promise<AsyncTaskStatusRecord>;
+export interface BffScript {
+    id: number;
+    appCode: string;
+    functionName?: string;
+    functionNode?: string;
+    description: string;
+    scriptType: string;
+    scriptContent?: string;
+    version?: number;
+    dependencyRefs?: string;
+    enableTransaction?: boolean;
+    datasetId?: number | null;
+    operationType?: string | null;
+    createdTime?: string;
+    updatedTime?: string;
+}
+export interface BffSaveResult {
+    id?: number;
+    action?: "created" | "updated";
+    cacheCleared?: boolean;
+    blocked?: boolean;
+    errorCode?: string;
+    message?: string;
+}
+/**
+ * Normalized save result for BFF script mutations.
+ *
+ * Why:
+ * the backend is in a compatibility window where `/scripts/save` may return
+ * either a legacy numeric id or the full saved script object. Callers should
+ * consume a stable shape and not guess which contract is active.
+ */
+export interface BffSavedScript {
+    id: number;
+    script?: BffScript;
+}
+export interface BffScriptStatistics {
+    datasetCode: string;
+    operationType: string;
+    beforeScriptId: number | null;
+    afterScriptId: number | null;
+}
+export declare function listBffScripts(appCode: string, type?: string, options?: {
+    scriptName?: string;
+}): Promise<BffScript[]>;
+export declare function getBffScriptInfo(id: number): Promise<BffScript>;
+export declare function saveBffScript(params: {
+    appCode: string;
+    functionName: string;
+    scriptType: string;
+    scriptContent: string;
+    id?: number;
+    version?: number;
+    description?: string;
+    functionNode?: string;
+    datasetId?: number;
+    operationType?: string;
+}): Promise<BffSavedScript>;
+export declare function deleteBffScript(id: number): Promise<void>;
+export declare function getBffScriptStatistics(appCode: string): Promise<BffScriptStatistics[]>;
+export declare function clearBffScriptCache(): Promise<string>;
+export declare function listBffDatasetOperations(appCode: string, datasetId: number): Promise<Record<string, unknown> | null>;
+export interface SqlQuery {
+    id: number;
+    tenantCode?: string;
+    appCode: string;
+    sqlCode: string;
+    sqlName: string;
+    description?: string;
+    dbId?: number;
+    version?: number;
+    sqlContent?: string;
+    sqlConfig?: string | null;
+    params?: string | null;
+}
+export interface SqlListResult {
+    tableData: SqlQuery[];
+    paging: Paging;
+}
+export interface SqlSaveResult {
+    id?: number;
+    sqlCode?: string;
+    sqlName?: string;
+    action?: "created" | "updated";
+    blocked?: boolean;
+    errorCode?: string;
+    message?: string;
+}
+export declare function listSqlQueries(appCode: string, options?: {
+    currentPage?: number;
+    pageSize?: number;
+    sqlCode?: string;
+    sqlName?: string;
+}): Promise<SqlListResult>;
+export declare function getSqlQueryInfo(appCode: string, sqlCode: string): Promise<SqlQuery>;
+export declare function getSqlQueryDetail(sqlCode: string): Promise<SqlQuery>;
+export declare function getSqlQueryDetailById(id: number): Promise<SqlQuery>;
+export declare function createSqlQuery(params: {
+    appCode: string;
+    sqlName: string;
+    dbId: number;
+    sqlContent: string;
+    sqlConfig?: string;
+}): Promise<SqlQuery>;
+export declare function updateSqlQuery(params: {
+    id: number;
+    appCode: string;
+    sqlCode?: string;
+    sqlName: string;
+    dbId: number;
+    version?: number;
+    sqlContent: string;
+    sqlConfig?: string;
+}): Promise<SqlQuery>;
+export declare function deleteSqlQuery(params: {
+    id?: number;
+    sqlCode?: string;
+}): Promise<void>;
+export declare function saveSqlQuery(params: {
+    appCode: string;
+    sqlCode?: string;
+    sqlName?: string;
+    dbId?: number;
+    sqlContent: string;
+    description?: string;
+}): Promise<SqlSaveResult>;
+export declare function executeSql(appCode: string, sqlCode: string, params?: Record<string, string | number>): Promise<any>;
+/**
+ * Read-only runtime data operations supported by rabetbase-cli.
+ *
+ * The command surface intentionally stays narrow for now: users mainly need
+ * `filter` and `getOne` to inspect real records while designing pages.
+ */
+export type DatasetDataReadOperation = "filter" | "getOne";
+/**
+ * Executes a read-only dataset data operation against the runtime WebAPI.
+ *
+ * The runtime dataset metadata already exposes concrete paths such as
+ * `/api/{appCode}/{datasetCode}/filter` and `/getOne`. Calling those paths
+ * directly keeps rabetbase aligned with the platform's cookie-authenticated
+ * runtime behavior without pulling in the runtime CLI's SDK stack.
+ *
+ * @param appCode - Resolved app code.
+ * @param datasetCode - Target dataset code.
+ * @param operation - Read-only operation name.
+ * @param params - Request body sent to the runtime API.
+ * @returns Raw runtime response payload.
+ */
+export declare function executeDatasetDataOperation(appCode: string, datasetCode: string, operation: DatasetDataReadOperation, params?: Record<string, any>): Promise<any>;
+export interface DatasetItem {
+    id: number;
+    name: string;
+    code: string;
+    source?: string;
+    description?: string;
+    dbtableConfig?: {
+        tableName?: string;
+        dbId?: number;
+        dbName?: string;
+        dbType?: string;
+        datasetKey?: string;
+        pkField?: string;
+        allFields?: string;
+    };
+    [key: string]: any;
+}
+export declare function listDatasets(appCode: string, options?: {
+    code?: string;
+    name?: string;
+    deleted?: boolean;
+}): Promise<DatasetItem[]>;
+export declare function deleteDataset(appCode: string, datasetId: number): Promise<void>;
+export declare function restoreDataset(appCode: string, datasetId: number): Promise<void>;
+export interface TextGeneratedDatasetPreviewInput {
+    datasetName: string;
+    requirementDescription: string;
+}
+export declare function previewTextGeneratedDataset(appCode: string, input: TextGeneratedDatasetPreviewInput): Promise<any>;
+export interface TextGeneratedDatasetJobStartResult {
+    operationId?: string;
+    clientOperationId?: string;
+    status?: string;
+    progressRate?: number;
+    currentStep?: string;
+    reused?: boolean;
+    warnings?: string[];
+    result?: any;
+    [key: string]: any;
+}
+export interface TextGeneratedDatasetJobStatus {
+    operationId?: string;
+    clientOperationId?: string;
+    status?: string;
+    progressRate?: number;
+    currentStep?: string;
+    errorMsg?: string;
+    warnings?: string[];
+    result?: any;
+    [key: string]: any;
+}
+export declare function startTextGeneratedDataset(appCode: string, design: Record<string, any>, options?: {
+    clientOperationId?: string;
+}): Promise<TextGeneratedDatasetJobStartResult>;
+export declare function getTextGeneratedDatasetStatus(appCode: string, options: {
+    operationId?: string;
+    clientOperationId?: string;
+}): Promise<TextGeneratedDatasetJobStatus>;
+/**
+ * 优先服务端过滤（name），再客户端补充匹配 code / tableName / description。
+ * 如果 keyword 恰好是 datasetCode 格式，同时发起 code 精确查询合并结果。
+ */
+export declare function searchDatasets(appCode: string, keyword: string): Promise<DatasetItem[]>;
+/**
+ * API 可能返回 operations 为数组，或按名称索引的对象。
+ */
+export declare function normalizeDatasetOperations(raw: unknown): any[];
+export declare function getDatasetDetail(datasetIdOrCode: string): Promise<any>;
+export declare function updateDrivenData(drivenData: Record<string, any>): Promise<any>;
+export interface OperationInfo {
+    name: string;
+    displayName?: string;
+    type?: string;
+    method?: string;
+    path?: string;
+    enabled?: boolean;
+    requestFields?: any[];
+    responseFields?: any[];
+    [key: string]: any;
+}
+export declare function getDatasetOperations(datasetIdOrCode: string): Promise<{
+    dataset: any;
+    operations: OperationInfo[];
+}>;
+export declare function getOperationDetail(appCode: string, datasetIdOrCode: string, operationName: string): Promise<{
+    dataset: any;
+    operation: any;
+}>;
+export interface GenerateStandardPagesResultItem {
+    datasetCode?: string;
+    datasetName?: string;
+    success?: boolean;
+    errorMsg?: string | null;
+    listPageId?: number | null;
+    createPageId?: number | null;
+    editPageId?: number | null;
+    detailPageId?: number | null;
+    [key: string]: any;
+}
+export interface GenerateStandardPagesResult {
+    successCount: number;
+    failCount: number;
+    results: GenerateStandardPagesResultItem[];
+    [key: string]: any;
+}
+export interface StandardPageGenerateJobStartResult {
+    operationId?: string;
+    status?: string;
+    progressRate?: number | null;
+    currentStep?: string | null;
+    reused?: boolean;
+    [key: string]: any;
+}
+export interface StandardPageGenerateResultSummaryItem {
+    datasetCode?: string;
+    datasetName?: string;
+    success?: boolean;
+    errorMsg?: string | null;
+    listPageId?: number | null;
+    createPageId?: number | null;
+    editPageId?: number | null;
+    detailPageId?: number | null;
+    [key: string]: any;
+}
+export interface StandardPageGenerateResultSummary {
+    datasetCode?: string;
+    successCount?: number;
+    failCount?: number;
+    results?: StandardPageGenerateResultSummaryItem[];
+    [key: string]: any;
+}
+export interface StandardPageGenerateJobStatus {
+    operationId?: string;
+    status?: string;
+    progressRate?: number | null;
+    currentStep?: string | null;
+    datasetCode?: string;
+    appCode?: string;
+    clientOperationId?: string | null;
+    errorMsg?: string | null;
+    result?: StandardPageGenerateResultSummary | null;
+    [key: string]: any;
+}
+export interface StandardPageStatusPageFact {
+    pageId?: number | null;
+    title?: string;
+    type?: string;
+    deleted?: boolean;
+    hasMenu?: boolean;
+    menuVisible?: boolean | null;
+    menuPath?: string | null;
+    [key: string]: any;
+}
+export interface StandardPageStatusPageSet {
+    versionTag?: string | null;
+    complete?: boolean;
+    pages?: StandardPageStatusPageFact[];
+    [key: string]: any;
+}
+export interface StandardPageStatus {
+    datasetId?: number | null;
+    datasetCode?: string;
+    pageSets?: StandardPageStatusPageSet[];
+    totalSets?: number;
+    completeSets?: number;
+    incompleteSets?: number;
+    residualPages?: StandardPageStatusPageFact[];
+    menuPages?: StandardPageStatusPageFact[];
+    [key: string]: any;
+}
+export interface PageSyncResultItem {
+    pageId?: number | null;
+    title?: string;
+    errorMsg?: string | null;
+    [key: string]: any;
+}
+export interface DatasetSyncToPagesResult {
+    totalPages?: number;
+    successPages: PageSyncResultItem[];
+    failedPages: PageSyncResultItem[];
+    [key: string]: any;
+}
+export interface PageDetailConfig {
+    pageVersion?: number | null;
+    versionTag?: string | null;
+    [key: string]: any;
+}
+export interface RelatedPageInfo {
+    id?: number;
+    type?: string;
+    code?: string;
+    title?: string;
+    deleted?: boolean;
+}
+export interface PageDetail {
+    pageId: number;
+    pageCode?: string;
+    name: string;
+    code: string;
+    appCode?: string;
+    datasetIds?: number[];
+    type?: string;
+    config?: PageDetailConfig | null;
+    relatedPageInfoList?: RelatedPageInfo[];
+    [key: string]: any;
+}
+export type DeletedPageType = "STANDARD" | "JSX";
+export interface DeletedPageItem {
+    pageType: DeletedPageType;
+    id: number;
+    appCode: string;
+    name: string;
+    type?: string | null;
+    datasetIds?: number[] | null;
+    createTime?: number | null;
+    createUserName?: string | null;
+    updateTime?: number | null;
+    updateUserName?: string | null;
+}
+export interface DeletedPageListResult {
+    tableData: DeletedPageItem[];
+    paging: {
+        currentPage: number;
+        totalCount: number;
+        pageSize: number;
+    };
+    tableColumns?: unknown[];
+}
+export declare function startGenerateStandardPages(appCode: string, datasetCode: string, options?: {
+    clientOperationId?: string;
+}): Promise<StandardPageGenerateJobStartResult>;
+export declare function getGenerateStandardPagesStatus(appCode: string, datasetCode: string, options: {
+    operationId?: string;
+    clientOperationId?: string;
+}): Promise<StandardPageGenerateJobStatus>;
+export declare function getStandardPageStatus(appCode: string, datasetCode: string): Promise<StandardPageStatus>;
+export declare function tryGetStandardPageStatus(appCode: string, datasetCode: string): Promise<StandardPageStatus | null>;
+export declare function syncStandardPages(appCode: string, datasetCode: string): Promise<DatasetSyncToPagesResult>;
+export declare function getPageDetail(pageId: number): Promise<PageDetail>;
+export declare function listDeletedPages(appCode: string, pageType: DeletedPageType, options: {
+    currentPage: number;
+    pageSize: number;
+}): Promise<DeletedPageListResult>;
+export declare function restoreStandardPage(pageId: number): Promise<void>;
+export declare function restoreJsxPage(appCode: string, pageId: number): Promise<boolean>;
+export declare function updatePage(appCode: string, pageId: number, code: string, datasetIds: number[]): Promise<boolean>;
+export declare function generateSdkCode(dataset: {
+    name: string;
+    code: string;
+    tableName?: string;
+}, operation: any, options?: {
+    includeImports?: boolean;
+}): string;
+export declare function generateSqlCodeTemplate(sql: SqlQuery, options?: {
+    target?: "sdk" | "bff";
+    includeImports?: boolean;
+}): string;
+export interface ErDataset {
+    datasetId: number;
+    datasetCode: string;
+    datasetName: string;
+    tableName: string;
+    tableComment: string;
+    sourceType: string;
+    businessGroup?: string;
+    fields: Array<{
+        name: string;
+        displayName: string;
+        dbType: string;
+        isPrimaryKey: boolean;
+        isForeignKey: boolean;
+    }>;
+    relations: Array<{
+        fromField: string;
+        toDataset: string;
+        toDatasetName: string;
+        toField: string;
+        joinType: string;
+        condition: string | null;
+    }>;
+}
+export interface ErConfig {
+    meta: {
+        appCode: string;
+        appName: string;
+        dbId: number | null;
+        dbName: string | null;
+    };
+    datasets: ErDataset[];
+    relationships: any[];
+}
+export declare function getErConfig(appCode: string, dblinkId: number | null): Promise<ErConfig>;
+export type ErRelationCardinality = "ONE_TO_ONE" | "ONE_TO_MANY" | "MANY_TO_ONE" | "MANY_TO_MANY";
+export type ErRelationSourceType = "DB_TABLE" | "METADATA";
+export interface ErRelationDetail {
+    relationId: number;
+    fromDatasetCode: string | null;
+    fromDatasetName: string | null;
+    fromSourceType: ErRelationSourceType;
+    fromTableName: string | null;
+    fromField: string | null;
+    toDatasetCode: string | null;
+    toDatasetName: string | null;
+    toSourceType: ErRelationSourceType;
+    toTableName: string | null;
+    toField: string | null;
+    refTableLabelName: string | null;
+    cardinality: ErRelationCardinality | null;
+    bizRelationType: "main_sub" | null;
+    condition: string | null;
+}
+export interface ErRelationMutation {
+    relationId?: number;
+    fromDatasetCode: string;
+    fromField: string;
+    toDatasetCode: string;
+    toField: string;
+    refTableLabelName?: string;
+    cardinality?: ErRelationCardinality;
+    bizRelationType?: "main_sub" | null;
+}
+export interface ErRelationMutationPayload {
+    appCode: string;
+    relation: ErRelationMutation;
+}
+export interface ErRelationDeletePayload {
+    appCode: string;
+    relation: {
+        relationId: number;
+    };
+}
+export interface ErBusinessGroupUpdatePayload {
+    appCode: string;
+    datasetCode: string;
+    businessGroup?: string;
+}
+export declare function getErRelationDetail(appCode: string, relationId: number): Promise<ErRelationDetail | null>;
+export declare function createErRelation(payload: ErRelationMutationPayload): Promise<boolean>;
+export declare function updateErRelation(payload: ErRelationMutationPayload): Promise<boolean>;
+export declare function deleteErRelation(payload: ErRelationDeletePayload): Promise<boolean>;
+export declare function updateErBusinessGroup(payload: ErBusinessGroupUpdatePayload): Promise<boolean>;
+export interface DbLinkInfo {
+    id: number;
+    appCode: string;
+    dbName: string;
+    dbDesc?: string;
+    dbType: string;
+    dbVersion: string;
+    dbUrl: string;
+    dbParam?: string;
+    username: string;
+    password?: string;
+    gmtModified?: string;
+    latestAnalysisStatus?: string | null;
+    latestAnalysisTraceId?: string;
+    latestAnalysisSuccessTime?: string;
+    [key: string]: unknown;
+}
+export interface DbTableInfo {
+    tableName: string;
+    tableComment?: string;
+    tagList: string[];
+}
+export interface DbTableDiffInfo {
+    tableName: string;
+    tableComment?: string;
+    diffType: string;
+    fieldDiff?: {
+        addedColumns?: string[];
+        deletedColumns?: string[];
+        modifiedColumns?: string[];
+    };
+}
+export interface DbTableDiffResult {
+    totalCount: number;
+    physicalTableCount: number;
+    datasetTableCount: number;
+    summary?: string;
+    tableList: DbTableDiffInfo[];
+}
+export interface DbAnalysisStatus {
+    status?: string | null;
+    inputParams?: string | null;
+    jobContext?: string | null;
+    costTimeMs?: number | null;
+    firstStartTime?: number | string | null;
+    startTime?: number | string | null;
+    endTime?: number | string | null;
+    [key: string]: unknown;
+}
+export type NotificationChannelType = "EMAIL" | "FEISHU" | "DINGTALK" | "WECOM" | "WEBHOOK";
+export interface NotificationChannelConfigItem {
+    id?: number | null;
+    appCode?: string | null;
+    configName?: string | null;
+    configCode?: string | null;
+    channelType?: string | null;
+    endpointUrl?: string | null;
+    channelConfig?: string | null;
+    description?: string | null;
+    connectTimeout?: number | null;
+    readTimeout?: number | null;
+    createTime?: string | null;
+    updateTime?: string | null;
+    [key: string]: unknown;
+}
+/**
+ * GET /notification/channel-config/list：查询当前应用的应用级通知渠道配置。
+ *
+ * 返回对象包含服务端脱敏后的完整配置；命令层仍必须做安全投影，
+ * 只输出 configCode 和用于人工选择的描述字段。
+ */
+export declare function listNotificationChannelConfigs(appCode: string, channelType: NotificationChannelType): Promise<NotificationChannelConfigItem[]>;
+export interface AppConfigItem {
+    id?: number;
+    appCode: string;
+    key: string;
+    value?: string | null;
+    tags?: string | null;
+    encrypted?: number | null;
+    operatorId?: number | null;
+    gmtCreate?: string;
+    gmtModified?: string;
+}
+export interface AppConfigWriteInput {
+    id?: number;
+    appCode: string;
+    key: string;
+    value: string;
+    tags?: string;
+}
+export declare function listAppConfigs(appCode: string, filters?: {
+    key?: string;
+    tags?: string;
+}): Promise<AppConfigItem[]>;
+export declare function getAppConfigByKey(appCode: string, key: string): Promise<AppConfigItem | null>;
+export declare function createAppConfig(input: AppConfigWriteInput): Promise<unknown>;
+export declare function updateAppConfig(input: AppConfigWriteInput & {
+    id: number;
+}): Promise<void>;
+export declare function deleteAppConfig(params: {
+    appCode: string;
+    id: number;
+}): Promise<void>;
+export declare function listDbLinks(appCode: string, options?: {
+    currentPage?: number;
+    pageSize?: number;
+}): Promise<{
+    items: DbLinkInfo[];
+    paging?: Paging;
+}>;
+export declare function getDbLinkInfo(id: number): Promise<DbLinkInfo>;
+export declare function createDbLink(data: DbLinkInfo): Promise<DbLinkInfo>;
+export declare function updateDbLink(data: DbLinkInfo): Promise<DbLinkInfo>;
+export declare function deleteDbLink(id: number): Promise<void>;
+/** @returns 后端返回的连通性结果（多为 boolean） */
+export declare function testDbLinkConnect(id: number): Promise<unknown>;
+export interface DbAnalysisStartResult {
+    planId: string;
+    estimatedMinutes: number;
+    estimatedDurationDesc: string;
+}
+export declare function startDbAnalysis(dbLinkId: number, tableNames?: string[]): Promise<DbAnalysisStartResult>;
+export declare function cancelDbAnalysis(planId: string): Promise<void>;
+export declare function getDbAnalysisStatus(planId: string): Promise<DbAnalysisStatus>;
+export declare function getDbAllTableList(appCode: string, dbLinkId: number): Promise<DbTableInfo[]>;
+export declare function getDbTableDiff(appCode: string, dbLinkId: number, opts?: {
+    pageIndex?: number;
+    pageSize?: number;
+    tableName?: string;
+}): Promise<DbTableDiffResult>;
+export interface RemoteApp {
+    id?: number | string;
+    appCode: string;
+    appName: string;
+    appDesc?: string;
+    [key: string]: any;
+}
+export declare function listRemoteApps(): Promise<RemoteApp[]>;
+/** 角色/用户组类型；ALL(-1)/SELF(0) 为特殊组，仅来自 get-permit-list */
+export type AppRoleType = "ADMIN" | "DEV" | "USER" | "CUSTOM" | "ALL" | "SELF";
+/** 资源权限动作枚举（工作台 checkbox 值） */
+export type PermitAction = "0" | "access" | "default";
+export interface AppRole {
+    id: number;
+    roleName: string;
+    remark?: string;
+    roleType: AppRoleType;
+    userCount: number;
+    permitCount: number;
+}
+export interface RoleUserRef {
+    userId: number;
+    username: string;
+    nickname?: string;
+    avatar?: string;
+    email?: string;
+    mobile?: string;
+}
+export interface RoleUsers {
+    id: number;
+    roleName: string;
+    roleType: "ADMIN" | "DEV" | "USER" | "CUSTOM";
+    userList: RoleUserRef[];
+    applyUserList?: RoleUserRef[];
+}
+export interface MenuResource {
+    resourceType: "MENU" | "NODE";
+    resourceCode: string;
+    resourceName: string;
+    allowed?: boolean;
+    allowedActions: PermitAction[];
+    menuType: "folder" | "lowcode";
+    pageId: number | null;
+    pageNodeList: MenuResource[] | null;
+}
+export interface ApiResource {
+    resourceType: "API";
+    resourceName: string;
+    datasetCode: string;
+    apiType: "DATASET" | "OTHER";
+    apiList?: Record<string, PermitAction[]>;
+}
+export interface PagePermitResourceSlot {
+    resourceCode: string;
+    resourceType: "MENU" | "DATA_CREATE" | "DATA_UPDATE" | "DATA_DELETE" | "DATA_DETAIL" | "DATA_EXPORT" | "DATA_ROW";
+    rolePermit: AppRole[];
+}
+export interface PagePermit {
+    menuId: number;
+    appCode: string;
+    menuPermit: PagePermitResourceSlot;
+    dataCreate?: PagePermitResourceSlot;
+    dataUpdate?: PagePermitResourceSlot;
+    dataDelete?: PagePermitResourceSlot;
+    dataDetail?: PagePermitResourceSlot;
+    dataExport?: PagePermitResourceSlot;
+    dataPermit?: PagePermitResourceSlot;
+}
+/** 租户成员（查人：nickname/username → userId） */
+export interface TenantMember {
+    userId: number;
+    username?: string;
+    nickname?: string;
+    status?: string;
+    email?: string;
+    mobile?: string;
+    avatar?: string;
+}
+/** 当前登录账号的一条租户成员关系 */
+export interface TenantMembership {
+    id?: number;
+    tenantCode: string;
+    tenantName?: string;
+    userId?: number;
+    status?: string;
+}
+/** 租户目录原始成员；公开命令必须在命令层做脱敏投影 */
+export interface TenantDirectoryMember {
+    id?: number;
+    tenantCode?: string;
+    userId?: number;
+    username?: string;
+    nickname?: string;
+    status?: string;
+    adminFlag?: boolean;
+    email?: string;
+    mobile?: string;
+    avatar?: string;
+}
+/** POST /smartapi/permit/role/get-list：应用下所有用户组（不含 ALL/SELF 特殊组） */
+export declare function listAppRoles(appCode: string, options?: {
+    currentPage?: number;
+    pageSize?: number;
+}): Promise<{
+    items: AppRole[];
+    paging?: Paging;
+}>;
+/** GET /smartapi/permit/role/get-one?id=：按主键读取单个用户组 */
+export declare function getAppRole(id: number): Promise<AppRole | null>;
+/**
+ * POST /smartapi/permit/role/create：创建自定义用户组（服务端固定 roleType=CUSTOM）。
+ * 服务端返回创建后的完整角色对象。
+ */
+export declare function createAppRole(input: {
+    appCode: string;
+    roleName: string;
+    remark?: string;
+}): Promise<AppRole>;
+/**
+ * POST /smartapi/permit/role/update：更新用户组。
+ * - 改名/备注：传 roleName / remark（不传 roleType / permits）。
+ * - 保存菜单权限：roleType="PAGE" + permits（resourceCode → actions）。
+ * - 保存 API 权限：roleType="API" + permits（resourceCode → actions）。
+ */
+export declare function updateAppRole(input: {
+    id: number;
+    appCode: string;
+    roleType?: "PAGE" | "API";
+    roleName?: string;
+    remark?: string;
+    permits?: Record<string, PermitAction[]>;
+}): Promise<unknown>;
+/** POST /smartapi/permit/role/delete：删除用户组 */
+export declare function deleteAppRole(id: number): Promise<void>;
+/**
+ * POST /smartapi/permit/role/get-permit-list：应用下所有用户组 + 特殊组
+ * （{id:-1, roleType:"ALL"}, {id:0, roleType:"SELF"}）。用于解析 SELF/ALL 字面量。
+ */
+export declare function listPermitRoles(appCode: string, options?: {
+    needSelf?: boolean;
+    needPublic?: boolean;
+}): Promise<AppRole[]>;
+/** POST /smartapi/permit/resource/get-menu-list：角色当前菜单资源矩阵 */
+export declare function getRoleMenuResources(appCode: string, roleId: number): Promise<MenuResource[]>;
+/**
+ * POST /smartapi/permit/resource/get-api-list：角色当前 API 资源矩阵。
+ * 服务端标 @Deprecated，但为 datasetCode→resourceCode 映射与全量状态的唯一来源；
+ * 仅供 permit service 内部读取，不做公开命令（见 spec §3.2）。
+ */
+export declare function getRoleApiResources(appCode: string, roleId: number): Promise<ApiResource[]>;
+/** POST /smartapi/permit/user-role/get-user-list：应用下所有用户组的成员（全量） */
+export declare function listRoleUsers(appCode: string): Promise<RoleUsers[]>;
+/**
+ * POST /smartapi/permit/user-role/update-user-list：全量回写所有用户组成员。
+ * 命令层必须 read-merge-write，只改目标组，其余组原样带回（见 spec §5.3-3）。
+ */
+export declare function updateRoleUsers(appCode: string, roleList: RoleUsers[]): Promise<void>;
+/** GET /smartapi/permit/page/get-one?menuId=：菜单页面权限快照 */
+export declare function getPagePermit(menuId: number): Promise<PagePermit>;
+/** POST /smartapi/permit/page/save：回写完整菜单页面权限配置 */
+export declare function savePagePermit(data: PagePermit): Promise<PagePermit>;
+/** GET /userTenant/queryBelongsTenants：当前登录账号所属的启用租户关系 */
+export declare function listCurrentUserTenantMemberships(): Promise<TenantMembership[]>;
+/** GET /userTenant/getByTenantCode?code=：保留全部成员状态的租户目录 */
+export declare function listTenantDirectoryMembers(tenantCode: string): Promise<TenantDirectoryMember[]>;
+/**
+ * 租户成员目录（查人）兼容 wrapper。
+ * 只返回 status=ENABLE 的成员，供现有 role user-* 流程继续使用。
+ */
+export declare function getTenantMembers(tenantCode: string): Promise<TenantMember[]>;