foggy-data-viewer 1.0.1-beta.46 → 1.0.1-beta.47

package/README.md

@@ -1,6 +1,8 @@
 # Foggy Data Viewer
 
-一个基于 Vue 3 + TypeScript + vxe-table 的企业级数据表格组件库。
+一个基于 Vue 3 + TypeScript + vxe-table 的企业级数据表格组件库。
+
+HTTP 鉴权接入（beta.47 起）：从公共入口导入 `configureDataViewerHttp`，在应用挂载前配置动态 `getHeaders` 和 `onUnauthorized`。允许先导入 SDK 再配置，无需 patch Axios，也无需修改 generated 文件。详见 [HTTP 接入与 TMS 迁移指南](./docs/http-auth.md)。
 
 ## 特性
 
@@ -99,31 +101,31 @@ function handlePageChange(page: number, pageSize: number) {
     :loading="false"
     @page-change="handlePageChange"
   />
-</template>
-```
-
-### 3. 展示“分”为“元”的金额字段
-
-金额单位必须由字段元数据显式声明；组件不会根据字段名、`MONEY` 类型或
-`semanticScaleFactor` 推断。模型定义可直接复用公共导出：
-
-```typescript
-import { MONEY_VIEWER } from 'foggy-data-viewer'
-
-const amountField = {
-  name: 'amount',
-  type: 'MONEY',
-  extData: {
-    viewer: MONEY_VIEWER
-  }
-}
-```
-
-此配置会把原始值 `3400` 展示为 `34.00`，并把筛选输入的 `34` 精确换算为
-提交给查询端的 `3400`。行数据、服务端汇总数据和排序值始终保持原始“分”值；
-已经返回“元”的字段不要配置 `MONEY_VIEWER`。
-
-## 组件列表
+</template>
+```
+
+### 3. 展示“分”为“元”的金额字段
+
+金额单位必须由字段元数据显式声明；组件不会根据字段名、`MONEY` 类型或
+`semanticScaleFactor` 推断。模型定义可直接复用公共导出：
+
+```typescript
+import { MONEY_VIEWER } from 'foggy-data-viewer'
+
+const amountField = {
+  name: 'amount',
+  type: 'MONEY',
+  extData: {
+    viewer: MONEY_VIEWER
+  }
+}
+```
+
+此配置会把原始值 `3400` 展示为 `34.00`，并把筛选输入的 `34` 精确换算为
+提交给查询端的 `3400`。行数据、服务端汇总数据和排序值始终保持原始“分”值；
+已经返回“元”的字段不要配置 `MONEY_VIEWER`。
+
+## 组件列表
 
 ### 核心组件
 

package/dist/api/http.d.ts

@@ -0,0 +1,20 @@
+import type { AxiosRequestConfig } from 'axios';
+export type DataViewerHttpHeaders = Record<string, string | null | undefined>;
+export interface DataViewerHttpRequestOptions {
+    headers?: DataViewerHttpHeaders;
+}
+export interface DataViewerUnauthorizedContext {
+    status: 401;
+    method: string;
+    /** Path only: excludes credentials, query, fragment, headers and body. */
+    path: string;
+}
+export interface DataViewerHttpConfig {
+    getHeaders?: () => DataViewerHttpHeaders | Promise<DataViewerHttpHeaders>;
+    onUnauthorized?: (context: DataViewerUnauthorizedContext) => void | Promise<void>;
+}
+/** Replace configuration for all SDK clients, including already-created clients. */
+export declare function configureDataViewerHttp(config: DataViewerHttpConfig): void;
+export declare function httpOptions(options?: DataViewerHttpRequestOptions): AxiosRequestConfig;
+/** Internal factory; response unwrapping remains owned by each existing API. */
+export declare function createDataViewerHttpClient(baseURL: string): import("axios").AxiosInstance;

package/dist/api/listPreset.d.ts

@@ -1,3 +1,4 @@
+import type { DataViewerHttpRequestOptions } from './http';
 import type { ColumnViewSetting, ListPresetDef, ListPresetVisibility, QueryConditionPreset } from '@/types';
 export interface ListPresetScope {
     userId: string;
@@ -19,32 +20,32 @@ export type UpdateListPresetRequest = Partial<SaveListPresetRequest>;
 /**
  * 查询当前用户在指定 model/businessKey 下的自定义列表方案。
  */
-export declare function listPresets(scope: ListPresetScope): Promise<ListPresetDef[]>;
+export declare function listPresets(scope: ListPresetScope, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef[]>;
 /**
  * 查询当前用户在指定 model/businessKey 下的默认自定义列表。
  */
-export declare function getDefaultListPreset(scope: ListPresetScope): Promise<ListPresetDef | null>;
+export declare function getDefaultListPreset(scope: ListPresetScope, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef | null>;
 /**
  * 保存新的自定义列表方案。
  */
-export declare function createListPreset(scope: ListPresetScope, request: SaveListPresetRequest): Promise<ListPresetDef>;
+export declare function createListPreset(scope: ListPresetScope, request: SaveListPresetRequest, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 获取单个自定义列表详情。
  */
-export declare function getListPreset(userId: string, presetId: string): Promise<ListPresetDef>;
+export declare function getListPreset(userId: string, presetId: string, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 更新自定义列表方案。
  */
-export declare function updateListPreset(userId: string, presetId: string, request: UpdateListPresetRequest): Promise<ListPresetDef>;
+export declare function updateListPreset(userId: string, presetId: string, request: UpdateListPresetRequest, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 删除自定义列表方案。
  */
-export declare function deleteListPreset(userId: string, presetId: string): Promise<void>;
+export declare function deleteListPreset(userId: string, presetId: string, options?: DataViewerHttpRequestOptions): Promise<void>;
 /**
  * 将某个自定义列表设为默认方案。
  */
-export declare function setDefaultListPreset(userId: string, presetId: string): Promise<ListPresetDef>;
+export declare function setDefaultListPreset(userId: string, presetId: string, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 清除当前 model/businessKey 下的默认方案。
  */
-export declare function clearDefaultListPreset(scope: ListPresetScope): Promise<void>;
+export declare function clearDefaultListPreset(scope: ListPresetScope, options?: DataViewerHttpRequestOptions): Promise<void>;

package/dist/api/tableDefaultQueryConfig.d.ts

@@ -1,2 +1,3 @@
+import type { DataViewerHttpRequestOptions } from './http';
 import type { TableDefaultQueryConfig, TableDefaultQueryConfigScope } from '@/types';
-export declare function getTableDefaultQueryConfig(scope: TableDefaultQueryConfigScope): Promise<TableDefaultQueryConfig | null>;
+export declare function getTableDefaultQueryConfig(scope: TableDefaultQueryConfigScope, options?: DataViewerHttpRequestOptions): Promise<TableDefaultQueryConfig | null>;

package/dist/api/viewer.d.ts

@@ -1,3 +1,4 @@
+import type { DataViewerHttpRequestOptions } from './http';
 import type { QueryMetaResponse, ViewerQueryRequest, ViewerDataResponse, FilterOptionsResponse, ColumnSchema, FrontendMeta, MemberQueryRequest, MemberQueryResponse, OrderRequestDef } from '@/types';
 /**
  * 查询 payload（与 dataset.query_model 格式一致）
@@ -41,40 +42,40 @@ export interface CreateQueryResponse {
 /**
  * 创建查询（从 DSL 输入）
  */
-export declare function createQuery(request: CreateQueryRequest): Promise<CreateQueryResponse>;
+export declare function createQuery(request: CreateQueryRequest, options?: DataViewerHttpRequestOptions): Promise<CreateQueryResponse>;
 /**
  * 获取查询元数据
  */
-export declare function fetchQueryMeta(model: string, queryId: string): Promise<QueryMetaResponse>;
+export declare function fetchQueryMeta(model: string, queryId: string, options?: DataViewerHttpRequestOptions): Promise<QueryMetaResponse>;
 /**
  * 查询数据
  */
-export declare function fetchQueryData(model: string, queryId: string, request: ViewerQueryRequest): Promise<ViewerDataResponse>;
+export declare function fetchQueryData(model: string, queryId: string, request: ViewerQueryRequest, options?: DataViewerHttpRequestOptions): Promise<ViewerDataResponse>;
 /**
  * 获取过滤选项（维度成员或字典项）
  */
-export declare function fetchFilterOptions(model: string, queryId: string, columnName: string): Promise<FilterOptionsResponse>;
+export declare function fetchFilterOptions(model: string, queryId: string, columnName: string, options?: DataViewerHttpRequestOptions): Promise<FilterOptionsResponse>;
 /**
  * 获取 QM Schema（查询模型的字段元数据）
  */
-export declare function fetchQmSchema(qmModel: string): Promise<ColumnSchema[]>;
+export declare function fetchQmSchema(qmModel: string, options?: DataViewerHttpRequestOptions): Promise<ColumnSchema[]>;
 /**
  * 直连查询数据（无需提前创建 queryId）
  *
  * 适用于生成组件的标准用法：只需 qmModel + 分页/筛选/排序/列集合即可查询。
  * 现有 fetchQueryData(model, queryId, request) 保留给 DataViewer / SavedQuery 场景。
  */
-export declare function fetchQueryDataDirect(qmModel: string, request: ViewerQueryRequest): Promise<ViewerDataResponse>;
+export declare function fetchQueryDataDirect(qmModel: string, request: ViewerQueryRequest, options?: DataViewerHttpRequestOptions): Promise<ViewerDataResponse>;
 /**
  * 获取前端元数据契约 (frontend-meta v1)
  *
  * 返回面向前端渲染的标准元数据：fields 为有序数组、包含 memberLookup/category/uiHints。
  */
-export declare function fetchFrontendMeta(qmModel: string): Promise<FrontendMeta>;
+export declare function fetchFrontendMeta(qmModel: string, options?: DataViewerHttpRequestOptions): Promise<FrontendMeta>;
 /**
  * 查询维度成员（远程搜索、分页、回填）
  *
  * 用于 SelectFilter 的 dimension 远程模式，替代旧的 fetchFilterOptions。
  * DSL slice 应使用返回的 selectionFieldName，而非 displayFieldName。
  */
-export declare function fetchMemberOptions(request: MemberQueryRequest): Promise<MemberQueryResponse>;
+export declare function fetchMemberOptions(request: MemberQueryRequest, options?: DataViewerHttpRequestOptions): Promise<MemberQueryResponse>;

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export { MONEY_VIEWER, formatViewerValue, getColumnMoneyViewer, resolveMoneyView
 export { buildPivotGridColumns, flattenPivotLeafNodes, validatePivotHeaderTree } from './utils/pivotHeaderTree';
 export { buildPivotCellField, toPivotViewModel } from './utils/pivotViewModelAdapter';
 export type { BuildPivotGridColumnsOptions, PivotGridColumn, PivotHeaderValidationResult } from './utils/pivotHeaderTree';
+export { configureDataViewerHttp } from './api/http';
+export type { DataViewerHttpConfig, DataViewerHttpHeaders, DataViewerHttpRequestOptions, DataViewerUnauthorizedContext } from './api/http';
 export { createQuery, fetchQueryMeta, fetchQueryData, fetchFilterOptions, fetchQmSchema, fetchQueryDataDirect, fetchFrontendMeta, fetchMemberOptions } from './api/viewer';
 export type { QueryPayload, CreateQueryRequest, CreateQueryResponse } from './api/viewer';
 export { listPresets, getDefaultListPreset, createListPreset, getListPreset, updateListPreset, deleteListPreset, setDefaultListPreset, clearDefaultListPreset } from './api/listPreset';