@jctrans-materials/shared 1.0.40-beta.9 → 1.0.40

package/dist/index.d.ts

@@ -1,9 +1,14 @@
 import { AxiosInstance } from 'axios';
+import { BoardQueryResult } from '@jctrans/dw-sdk';
+import { DateType } from '@jctrans/dw-sdk';
 import { Emitter } from 'mitt';
+import { GraphQLClientError } from '@jctrans/dw-sdk';
+import { OpportunityBoardParams } from '@jctrans/dw-sdk';
 
 declare type ActionKeys = (typeof MODAL_ACTION)[keyof typeof MODAL_ACTION];
 
-declare interface ApiResponse<T = any> {
+/** 通用 API 响应结构 (最外层) */
+export declare interface ApiResponse<T = any> {
     code: number;
     msg: string;
     data: T;
@@ -14,12 +19,16 @@ export declare interface AppointSearch {
     val: string;
 }
 
+/** baseSearch 的 appointSearch 条目 */
 export declare type AppointSearchName = "continentId" | "countryId" | "cityId" | "provinceId" | "seaportId" | "airportId" | "allCityByCountryId";
 
-/**
- * 1-1-2.TGC自动登录
- * @returns
- */
+/** Auth session key 映射表 */
+declare const AUTH_SESSION_KEYS: Record<string, string>;
+
+declare type AuthSessionData = {
+    [K in keyof typeof AUTH_SESSION_KEYS]?: string | null;
+};
+
 export declare function autoLoginByTGC(data: {
     toSys: string;
     path: string;
@@ -27,6 +36,7 @@ export declare function autoLoginByTGC(data: {
     tokenId?: string;
 }): Promise<any>;
 
+/** 分页响应结构 */
 export declare interface BaseResponse<T = any> {
     records: T[];
     total: number;
@@ -41,52 +51,20 @@ export declare interface BaseResponse<T = any> {
  */
 export declare type BeforeSendCallback = (event: GioEvent) => GioEvent;
 
-/**
- * 验证验证码绑定第三方应用
- * @param data
- * @returns
- */
 export declare function bindThirdPartyByCodeApi(data: any): Promise<any>;
 
-/**
- * 验证密码绑定第三方应用
- * @param data
- * @returns
- */
 export declare function bindThirdPartyByPwdApi(data: any): Promise<any>;
 
-declare interface CarrierRequestPayload {
-    current: number;
-    size: number;
-    lineType: "air" | "shipping";
-    searchkey?: string;
-    ids?: number[];
-    [key: string]: any;
-}
+export { BoardQueryResult }
 
-/**
- * 检查账号是否存在(忘记密码专用)
- * @param data
- * @returns
- */
-export declare function checkAccountExistsFPApi(data: any): Promise<any>;
+export declare function checkAccountExistsFPApi(data: ForgotPasswordAccountData): Promise<any>;
 
-/**
- * 验证邮件验证码
- * @param data
- * @returns
- */
 export declare function checkEmailCodeApi(data: {
     uuid: string;
     code: string;
     target: string;
 }): Promise<any>;
 
-/**
- * 验证手机验证码
- * @param data
- * @returns
- */
 export declare function checkMobileCodeApi(data: {
     code: string;
     uuid: string;
@@ -107,6 +85,20 @@ export declare interface ClientIdPluginOptions {
     headerName?: string;
 }
 
+export declare interface CommonKeysConfig {
+    TokenKey: string;
+    HasLoginKey: string;
+    PrjId: string;
+    ExpiresInKey: string;
+    ExpiresInTimeKey: string;
+    RefreshTokenKey: string;
+    RefreshExpiresInKey: string;
+    RefreshExpiresInTimeKey: string;
+    RememberMeAccountKey: string;
+    RememberMePasswordKey: string;
+}
+
+/** baseSearch 的通用请求参数 */
 export declare interface CommonParams {
     current?: number;
     size?: number;
@@ -124,18 +116,8 @@ export declare interface CompanyOption {
     compName: string;
 }
 
-/**
- * 完善公司信息跳转
- * @param {*} data
- * @returns
- */
 export declare function completeCompRedirectApi(data: any): Promise<any>;
 
-/**
- * 完善信息加入公司
- * @param data
- * @returns
- */
 export declare function completeJoinCompanyRedirectApi(data: any): Promise<any>;
 
 /**
@@ -169,34 +151,40 @@ export declare const currentConfig: {
     readonly allLinePath: string;
     readonly oldBasePath: string;
     readonly prefixPath: string;
+    readonly appId: string | undefined;
 };
 
+export { DateType }
+
+/** 兼容旧名 */
+export declare const Decrypt: typeof decrypt;
+
 /**
- * 解密方法
- * @param word
- * @returns
+ * 解密
  */
-export declare function Decrypt(word: string): string;
+export declare function decrypt(word: string): string;
 
 /**
  * 设备 ID 回调
  */
 export declare type DeviceIdCallback = (deviceId: string) => void;
 
-export declare type DisplayInfo = "Continent" | "Country" | "Province" | "City" | "Seaport" | "Airport";
+/** 兼容旧名：baseSearch.DisplayInfo */
+export declare type DisplayInfo = LocationType;
 
 export declare const emitter: Emitter<ModalEvents>;
 
+/** 兼容旧名 */
+export declare const Encrypt: typeof encrypt;
+
 /**
- * 加密方法
- * @param word
- * @returns
+ * 加密
  */
-export declare function Encrypt(word: string): string;
+export declare function encrypt(word: string): string;
 
-export declare const ExpiresInKey = "JC-Expires-In";
+export declare const ExpiresInKey: string;
 
-export declare const ExpiresInTimeKey = "JC-Expires-Time-In";
+export declare const ExpiresInTimeKey: string;
 
 /**
  * Fetch API ClientId 拦截器
@@ -213,31 +201,30 @@ export declare interface FetchClientIdOptions {
     injectRequest?: boolean;
 }
 
-/**
- * 获取字典列表
- * @param data
- * @returns
- */
-export declare function findDictAPi(data?: {
+export declare function findDictApi(data?: {
     size: number;
 }): Promise<any>;
 
-/**
- * 根据手机邮箱获取重复列表
- * @param data
- * @returns
- */
 export declare function findListByMobileEmailApi(data: any): Promise<any>;
 
-/**
- * 查询区号列表
- * @param data
- * @returns
- */
-export declare function findPAreaCodeAPi(data?: {
+export declare function findPAreaCodeApi(data?: {
     size: number;
 }): Promise<any>;
 
+declare interface ForgotPasswordAccountData {
+    account?: string;
+    email?: string;
+    mobile?: string;
+    [key: string]: any;
+}
+
+declare interface ForgotPasswordVerifyData {
+    account?: string;
+    code?: string;
+    uuid?: string;
+    [key: string]: any;
+}
+
 /**
  * ClientId 管理工具
  * 用于生成和管理唯一的客户端标识符
@@ -250,34 +237,19 @@ export declare function findPAreaCodeAPi(data?: {
  */
 export declare function generateClientId(): string;
 
-export declare function getAirport(params?: {
+export declare const getAirport: (params?: {
     page?: number;
     size?: number;
     ids?: number[];
-    cityId?: number;
     countryId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+    cityId?: number;
+}) => Promise<BaseResponse<UnifiedItem>>;
+
+export declare function getAirportByNameEnShow(nameEnShow: string): Promise<any>;
 
-/**
- * 跨环境获取 AppId (兼容 Vite, Webpack, Nuxt)
- */
 export declare function getAppId(): string;
 
-/**
- * 全局获取 session
- * @returns
- */
-export declare function getAuthSessionItems(): {
-    activityCode: string | null;
-    referenceUserId: string | null;
-    empNo: string | null;
-    uniqueCode: string | null;
-    path: string | null;
-    clickSource: string | null;
-    registerEvent?: string | null;
-    registerType?: string | null;
-    compKey?: string | null;
-};
+export declare function getAuthSessionItems(): AuthSessionData;
 
 /** 单 id 版本 */
 export declare function getById(type: DisplayInfo, id: number): Promise<UnifiedItem | null>;
@@ -297,49 +269,48 @@ export declare function getCitiesByCountry(countryId: number, opts?: {
     size?: number;
 }): Promise<BaseResponse<UnifiedItem>>;
 
-export declare function getCity(params?: {
+export declare const getCity: (params?: {
     page?: number;
     size?: number;
     ids?: number[];
     countryId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+    cityId?: number;
+}) => Promise<BaseResponse<UnifiedItem>>;
+
+export declare function getCityByNameEnShow(nameEnShow: string): Promise<any>;
+
+export declare const getCommonKeys: () => CommonKeysConfig;
 
 export declare const getCompanyOptionApi: (data: CompanyOption) => Promise<any>;
 
-/** 保留对外兼容函数：getContinent/getCountry/getCity/getProvince/getSeaport/getAirport */
-export declare function getContinent(params?: {
+export declare const getContinent: (params?: {
     page?: number;
     size?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+    ids?: number[];
+    countryId?: number;
+    cityId?: number;
+}) => Promise<BaseResponse<UnifiedItem>>;
 
-export declare function getCountry(params?: {
+export declare const getCountry: (params?: {
     page?: number;
     size?: number;
     ids?: number[];
-}): Promise<BaseResponse<UnifiedItem>>;
+    countryId?: number;
+    cityId?: number;
+}) => Promise<BaseResponse<UnifiedItem>>;
+
+export declare function getCountryByNameEnShow(nameEnShow: string): Promise<any>;
 
 /**
  * 获取当前的 clientId（不会创建新的）
  */
 export declare function getCurrentClientId(): string | null;
 
-/**
- * 🚀 补全：获取 Access Token 的过期时间戳 (用于判断是否需要刷新)
- */
 export declare function getExpiresTimeIn(): number;
 
-/**
- * 获取一级域名 (用于 Cookie 跨域共享)
- */
 export declare function getFirstDomain(): string | undefined;
 
-/**
- * 全局获取 GIO 相关 session
- * @returns
- */
-export declare function getGioSessionItems(): {
-    registerEntry: string | null;
-};
+export declare function getGioSessionItems(): GioSessionData;
 
 /**
  * 兼容全环境的语言判断方法
@@ -347,45 +318,16 @@ export declare function getGioSessionItems(): {
  */
 export declare const getIsEn: () => boolean;
 
-/**
- * 获取用户加入公司信息
- * @param data
- * @returns
- */
 export declare function getJoinCompanyApi(data: any): Promise<any>;
 
-/**
- * 获取当前语言
- * @returns
- */
 export declare function getLanguage(): string | undefined;
 
-/**
- * 获取本地 IP 数据
- * @param data
- * @returns
- */
-export declare function getLocalIpDataApi(data: any): Promise<any>;
+export declare function getLocalIpDataApi(data: Record<string, any>): Promise<any>;
 
-/**
- * 获取登录微信二维码
- * @param data
- * @returns
- */
 export declare function getLoginQrCode(data?: {}): Promise<any>;
 
-/**
- * 忘记密码发送验证码
- * @param data
- * @returns
- */
-export declare function getMEVCodeApi(data: any): Promise<any>;
+export declare function getMEVCodeApi(data: ForgotPasswordVerifyData): Promise<any>;
 
-/**
- * 根据用户 id 获取手机号
- * @param data
- * @returns
- */
 export declare function getMobileEmailApi(data: {
     id: string;
 }): Promise<any>;
@@ -396,51 +338,36 @@ export declare function getMobileEmailApi(data: {
  */
 export declare function getOrCreateClientId(): string;
 
-/**
- * 跨环境获取 Path
- */
 export declare function getPathFromConfig(config: any): string;
 
-/**
- * 4. 导出操作方法
- */
 export declare function getProjectId(): string | undefined;
 
-export declare function getProvince(params?: {
+export declare const getProvince: (params?: {
     page?: number;
     size?: number;
     ids?: number[];
     countryId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+    cityId?: number;
+}) => Promise<BaseResponse<UnifiedItem>>;
 
-/**
- * 跳转其他站
- * @param appId
- * @param path
- * @returns
- */
 export declare function getRedirectPathApi(appId: string, path: string): Promise<any>;
 
-/**
- * 🚀 补全：获取当前的 Refresh Token
- */
 export declare function getRefreshToken(): string | undefined;
 
-/**
- * 获取记住的账号
- */
 export declare function getRememberAccount(): {
     account?: string;
     password?: string;
 };
 
-export declare function getSeaport(params?: {
+export declare const getSeaport: (params?: {
     page?: number;
     size?: number;
     ids?: number[];
-    cityId?: number;
     countryId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+    cityId?: number;
+}) => Promise<BaseResponse<UnifiedItem>>;
+
+export declare function getSeaportByNameEnShow(nameEnShow: string): Promise<any>;
 
 export declare function getSessionHeaderValue(key: string): string;
 
@@ -454,11 +381,9 @@ export declare const getSharedConfig: () => {
     readonly allLinePath: string;
     readonly oldBasePath: string;
     readonly prefixPath: string;
+    readonly appId: string | undefined;
 };
 
-/**
- * 获取当前的 Access Token
- */
 export declare function getToken(): string | undefined;
 
 /**
@@ -480,15 +405,16 @@ export declare function getToken(): string | undefined;
  */
 export declare function getTracker<T extends GioTracker>(trackerInstance?: T): T | null;
 
-/**
- * 获取用户手机号邮箱信息
- * @param data
- * @returns
- */
-export declare function getUserInfoApi(data: any): Promise<any>;
+export declare function getUserInfoApi(data: Record<string, any>): Promise<any>;
 
 export declare const GIO_CLICK_PAGE_REQUIRED_FIELDS: readonly ["companyID_var", "contactPerson_var", "inquiryID_var", "modulePosition_var", "moduleType_var", "pageCode_var", "pageClickName_var", "moduleName_var"];
 
+/** clickPage 事件名常量 */
+export declare const GIO_EVENT_CLICK_PAGE = "clickPage";
+
+/** GIO session key 映射表 */
+declare const GIO_SESSION_KEYS: Record<string, string>;
+
 /**
  * GIO 属性对象
  */
@@ -588,6 +514,8 @@ export declare interface GioInitOptions {
     ignoreFields?: string[];
     /** 曝光比例（0-1），与曝光插件结合使用，默认 0 */
     impressionScale?: number;
+    /** 性能采集插件配置。集成后默认开启首屏加载监控和错误监控，默认关闭网络监控 */
+    performance?: GioPerformanceOptions;
     /** 与小程序打通时的配置项，SDK >= 4.3.0 支持 */
     embeddedAdapter?: {
         /** 圈选服务器地址，SaaS 客户不需要配置 */
@@ -607,52 +535,46 @@ export declare interface GioPageProps {
 }
 
 /**
- * 事件计时器 ID 类型
+ * 性能采集 - 网络监控排除配置
  */
-export declare type GioTimerId = string;
+declare interface GioPerformanceNetwork {
+    /**
+     * 请求监控排除名单
+     * 值可以是域名字符串、正则表达式，或由两者组成的数组
+     * 配置此项即视为开启请求监控
+     * 注意：使用纯字符串校验时应尽可能使用长且准确的字符，过短的字符串可能会误过滤其他请求
+     */
+    exclude?: string | RegExp | Array<string | RegExp>;
+}
 
 /**
- * GrowingIO SDK 封装模块
- * 基于 gio-webjs-sdk npm 包
- *
- * @module gio
- *
- * @example
- * ```typescript
- * import { tracker, type GioAttributes, type GioInitOptions } from '@jctrans-materials/shared';
- *
- * // 基础初始化
- * tracker.init('your-account-id', 'your-datasource-id', {
- *   debug: true,
- *   trackPage: false,
- * });
- *
- * // 微信公众号 H5（需要 appId 和 forceLogin）
- * tracker.init('accountId', 'dataSourceId', 'wx-app-id', {
- *   forceLogin: true,
- *   debug: true,
- * });
- *
- * // 设置登录用户 ID
- * tracker.setUserId('user-123');
- * tracker.setUserId('user-123', 'user_id', () => {
- *   console.log('set user id with userKey done');
- * });
- *
- * // 埋点事件
- * tracker.track('order_submit', {
- *   order_type: 'freight',
- *   price: 5000,
- *   services: ['ocean', 'customs']
- * });
- *
- * // 设置全局属性
- * tracker.setGeneralProps({
- *   platform: 'jctrans_web',
- *   locale: 'zh-CN'
- * });
- * ```
+ * 性能采集配置项
+ * 集成性能采集插件后，默认开启首屏加载监控和错误监控，默认关闭网络监控
+ */
+declare interface GioPerformanceOptions {
+    /** 是否开启首屏加载监控，默认 true */
+    monitor?: boolean;
+    /** 是否开启错误监控，默认 true */
+    exception?: boolean;
+    /**
+     * 网络监控配置
+     * - 不配置时默认关闭网络监控
+     * - 设为 true 开启网络监控
+     * - 设为对象时开启网络监控并配置排除名单
+     * 注意：请求监控强制过滤了 Gio 上报的请求
+     */
+    network?: boolean | GioPerformanceNetwork;
+}
+
+declare type GioSessionData = {
+    [K in keyof typeof GIO_SESSION_KEYS]?: string | null;
+};
+
+/**
+ * 事件计时器 ID 类型
  */
+export declare type GioTimerId = string;
+
 export declare type GioTrackAttrs = Record<string, string | number | Array<string | number> | null | undefined>;
 
 declare class GioTracker {
@@ -868,7 +790,11 @@ export declare interface GioUserAttributes {
     [key: string]: GioAttributeValue;
 }
 
-export declare const HasLoginKey = "hasLogin";
+export { GraphQLClientError }
+
+export declare const HasLoginKey: string;
+
+export declare const initCommonKeys: (newKeys: Partial<CommonKeysConfig>) => void;
 
 /**
  * 全局初始化方法，在项目入口调用
@@ -899,22 +825,13 @@ export declare function installClientIdPlugin(instance: AxiosInstance, options?:
  */
 export declare function installFetchClientId(options?: FetchClientIdOptions): void;
 
-/**
- * 获取邀请加入公司信息
- * @param data
- * @returns
- */
 export declare function inviteJoinGetCompApi(data: any): Promise<any>;
 
-declare interface IResponse<T> {
+/** 简化响应结构（仅 data 字段）— 兼容旧名 IResponse */
+export declare type IResponse<T> = {
     data: T;
-}
+};
 
-/**
- * 检查值是否为空
- * @param value 要检查的值
- * @returns 是否为空
- */
 export declare function isEmpty(value: any): boolean;
 
 /**
@@ -929,238 +846,68 @@ export declare function isEmpty(value: any): boolean;
  */
 export declare function isGioAvailable(trackerInstance?: typeof tracker): boolean;
 
-/**
- * 判断域名是否为 IP
- */
 export declare function isIpAddress(hostname: string): boolean;
 
-declare interface LineRequestPayload {
-    current: number;
-    size: number;
-    lineType: "air" | "shipping";
-    searchkey?: string;
-    ids?: number[];
-    [key: string]: any;
-}
-
 export declare const locationSearchV2: {
-    SEARCH_VERSION: string;
-    searchByName: (params: SearchGenericParams) => Promise<{
-        records: LocationUnifiedItem[];
-        total: number;
-        current: number;
-        size: number;
-    }>;
+    searchByName: (params: SearchGenericParams) => Promise<BaseResponse<LocationUnifiedItem>>;
     searchByIdWithType: (id: number | string | Array<number | string>, type: LocationType, extraParams?: {
         lineType?: "air" | "shipping";
-    }) => Promise<{
-        records: LocationUnifiedItem[];
-        total: number;
-        current: number;
-        size: number;
-    }>;
+    }) => any;
     country: {
-        searchByName: (params: SearchByNameParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        getByIds: (ids: number[]) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        searchRegionByName: (params: SearchByNameParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getRegionByIds: (ids: number[]) => Promise<BaseResponse<LocationUnifiedItem>>;
+        searchByName: (params: SearchWithScopeParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[] | string[]) => Promise<BaseResponse<LocationUnifiedItem>>;
     };
     region: {
-        searchByName: (params: SearchByNameParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        getByIds: (ids: number[]) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        searchByName: (params: SearchByNameParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[]) => Promise<BaseResponse<LocationUnifiedItem>>;
     };
     city: {
-        searchByName: (params: SearchWithScopeParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        getByIds: (ids: number[]) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        getCitiesByCountry: (countryId: number, params?: PageParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        getCitiesByCountry: (countryId: number, params?: PageParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        searchByName: (params: SearchWithScopeParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[] | string[]) => Promise<BaseResponse<LocationUnifiedItem>>;
     };
     seaport: {
-        searchByName: (params: SearchWithScopeParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        getByIds: (ids: number[]) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        searchByName: (params: SearchWithScopeParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[] | string[]) => Promise<BaseResponse<LocationUnifiedItem>>;
     };
     airport: {
-        searchByName: (params: SearchWithScopeParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        getByIds: (ids: number[]) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        searchByName: (params: SearchWithScopeParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[] | string[]) => Promise<BaseResponse<LocationUnifiedItem>>;
+    };
+    province: {
+        searchByName: (params: SearchWithScopeParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[] | string[]) => Promise<BaseResponse<LocationUnifiedItem>>;
+    };
+    continent: {
+        searchByName: (params: SearchWithScopeParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[] | string[]) => Promise<BaseResponse<LocationUnifiedItem>>;
     };
     wharf: {
-        getByIds: (ids: string[]) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        getByIds: (ids: string[]) => Promise<BaseResponse<LocationUnifiedItem>>;
     };
     carrier: {
-        /**
-         * 内部私有方法：构建符合 Carrier 接口要求的 payload
-         */
-        _buildPayload: (params: Partial<SearchByNameParams> & {
-            ids?: number[];
-        }, lineType: "air" | "shipping") => CarrierRequestPayload;
-        /**
-         * 搜索船公司 (Shipping Line)
-         */
-        searchShipping: (params: SearchByNameParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        /**
-         * 搜索航空公司 (Airline)
-         */
-        searchAir: (params: SearchByNameParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        /**
-         * 通用搜索 (需要手动传入 type)
-         * 场景：如果前端有一个下拉框让用户选类型，则调用此方法
-         */
-        search: (params: SearchByNameParams, lineType: "air" | "shipping") => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        /**
-         * 根据 ID 获取详情
-         * 注意：根据你的 Interface，ID 查询可能也需要传 lineType，
-         * 默认设为 shipping，或者你需要拆分成两个 ID 方法
-         */
-        getByIds: (ids: number[], lineType?: "air" | "shipping") => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        searchShipping: (params: SearchByNameParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        searchAir: (params: SearchByNameParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        search: (params: SearchByNameParams, lineType: "air" | "shipping") => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[], lineType?: "air" | "shipping") => Promise<BaseResponse<LocationUnifiedItem>>;
     };
     line: {
-        /**
-         * 内部私有方法：构建符合后端要求的 Payload
-         */
-        _buildPayload: (params: Partial<SearchByNameParams> & {
-            ids?: number[];
-        }, lineType: "air" | "shipping") => LineRequestPayload;
-        searchAllByCountry: (lineType: "air" | "shipping", countryId?: number) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        /**
-         * 搜索海运航线 (Shipping Line)
-         * 例如：AE1, TP9
-         */
-        searchShipping: (params: SearchByNameParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        /**
-         * 搜索空运航线 (Air Line)
-         * 业务上较少见，但接口支持
-         */
-        searchAir: (params: SearchByNameParams) => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        /**
-         * 通用搜索 (需要手动传 lineType)
-         */
-        search: (params: SearchByNameParams, lineType: "air" | "shipping") => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
-        /**
-         * 根据 ID 获取航线详情
-         * 默认默认为 shipping，如需查空运航线需显式传入
-         */
-        getByIds: (ids: number[], lineType?: "air" | "shipping") => Promise<{
-            records: LocationUnifiedItem[];
-            total: number;
-            current: number;
-            size: number;
-        }>;
+        searchAllByCountry: (lineType: "air" | "shipping", countryId?: number) => Promise<BaseResponse<LocationUnifiedItem>>;
+        searchShipping: (params: SearchByNameParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        searchAir: (params: SearchByNameParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+        search: (params: SearchByNameParams, lineType: "air" | "shipping") => Promise<BaseResponse<LocationUnifiedItem>>;
+        getByIds: (ids: number[], lineType?: "air" | "shipping") => Promise<BaseResponse<LocationUnifiedItem>>;
     };
-    /** 获取某个国家下的所有城市 */
-    getCitiesByCountry: (countryId: number, params?: PageParams) => Promise<{
-        records: LocationUnifiedItem[];
-        total: number;
-        current: number;
-        size: number;
-    }>;
-    /** 获取某个城市下的子实体 */
-    getChildrenByCity: (cityId: number, childTypes: Array<"Seaport" | "Airport" | "Wharf">, params?: PageParams) => Promise<{
-        records: LocationUnifiedItem[];
-        total: number;
-        current: number;
-        size: number;
-    }>;
+    getCitiesByCountry: (countryId: number, params?: PageParams) => Promise<BaseResponse<LocationUnifiedItem>>;
+    getChildrenByCity: (cityId: number, childTypes: Array<"Seaport" | "Airport" | "Wharf">, params?: PageParams) => Promise<BaseResponse<LocationUnifiedItem>>;
 };
 
+/** 所有支持的搜索实体类型（V1 + V2 的 superset） */
 export declare type LocationType = "Continent" | "Country" | "Region" | "Province" | "City" | "Seaport" | "Airport" | "Street" | "Town" | "Wharf" | "Carrier" | "Line";
 
+/** 标准化后的实体对象（V1 + V2 的 superset） */
 export declare interface LocationUnifiedItem {
     id: number | string;
     type: LocationType;
@@ -1182,39 +929,14 @@ export declare interface LocationUnifiedItem {
     [key: string]: unknown;
 }
 
-/**
- * 用户登录
- * @param loginData
- * @returns
- */
 export declare function loginApi(loginData: LoginDataParams): Promise<IResponse<ApiResponse<LoginResponseData>>>;
 
-/**
- * 验证码登录注册
- * @param data
- * @returns
- */
 export declare function loginByEmailOrMobileCodeApi(data: any): Promise<IResponse<ApiResponse<LoginResponseData>>>;
 
-/**
- * Facebook 登录
- * @param data
- * @returns
- */
-export declare function loginByFacebookApi(data: any): Promise<IResponse<ApiResponse<ThirdResponseData>>>;
+export declare const loginByFacebookApi: (data: any) => Promise<IResponse<ApiResponse<ThirdResponseData>>>;
 
-/**
- * LinkedIn 登录
- * @param data
- * @returns
- */
-export declare function loginByLinkedinApi(data: any): Promise<IResponse<ApiResponse<ThirdResponseData>>>;
+export declare const loginByLinkedinApi: (data: any) => Promise<IResponse<ApiResponse<ThirdResponseData>>>;
 
-/**
- * 微信二维码登录(1s轮询)
- * @param data
- * @returns
- */
 export declare function loginByQrCode(data: {
     uniqueCode: string;
     appId: string;
@@ -1224,14 +946,10 @@ export declare function loginByQrCode(data: {
     formEntry?: string;
 }): Promise<any>;
 
-/**
- * 微信二维码登录绑定用户(验证码)
- * @param data
- * @returns
- */
 export declare function loginCodeBindWechatApi(data: any): Promise<any>;
 
-declare interface LoginDataParams {
+/** 登录请求参数 */
+export declare interface LoginDataParams {
     username: string;
     password: string;
     appId: string;
@@ -1243,14 +961,10 @@ declare interface LoginDataParams {
     referenceUserId: string;
 }
 
-/**
- * 微信二维码登录绑定用户(账号密码)
- * @param data
- * @returns
- */
 export declare function loginPwdBindWechatApi(data: any): Promise<any>;
 
-declare interface LoginResponseData {
+/** 登录响应的 data 层 */
+export declare interface LoginResponseData {
     redirect: boolean;
     redirectPath?: string;
     tgc?: string;
@@ -1258,7 +972,8 @@ declare interface LoginResponseData {
     hasLogon?: boolean;
 }
 
-declare interface LoginResult {
+/** 登录结果中的 Token 信息 */
+export declare interface LoginResult {
     accessToken: string;
     expireIn: number;
     refreshToken: string;
@@ -1284,77 +999,72 @@ export declare const normalizeAttrs: (attrs?: GioTrackAttrs) => GioTrackAttrs;
 
 export declare const normalizeClickPageAttrs: (eventName: string, attrs?: GioTrackAttrs) => GioTrackAttrs;
 
+export { OpportunityBoardParams }
+
 /**
  * 页面变更回调
  */
 export declare type PageListenerCallback = (pageProps: GioPageProps) => void;
 
+/** 分页参数 */
 export declare interface PageParams {
     current?: number;
     size?: number;
 }
 
-export declare const PrjId = "prjId";
+export declare const PrjId: string;
+
+/**
+ * 查询商机有效看板数据（分页）。
+ *
+ * 【每次调用新建 SDK 实例，无状态污染】
+ *
+ * @example
+ * ```ts
+ * import { queryOpportunityBoard } from '@jctrans-materials/shared'
+ *
+ * const result = await queryOpportunityBoard({
+ *   compId: 12345,
+ *   dateType: 'QUARTER',
+ *   dateValue: '2026-Q2',
+ * })
+ *
+ * if (result.success) {
+ *   console.log(result.data.records)
+ * }
+ * ```
+ */
+export declare function queryOpportunityBoard(params: OpportunityBoardParams): Promise<BoardQueryResult>;
 
-export declare const RefreshExpiresInKey = "JC-Refresh-Expires-In";
+export declare const RefreshExpiresInKey: string;
 
-export declare const RefreshExpiresInTimeKey = "JC-Refresh-Expires-Time-In";
+export declare const RefreshExpiresInTimeKey: string;
 
-export declare const RefreshTokenKey = "JC-Refresh-Token";
+export declare const RefreshTokenKey: string;
 
-/**
- * 国际站峰会注册
- * @param data
- * @returns
- */
 export declare function registerApi(data: any): Promise<any>;
 
-/**
- * 使用第三方应用注册用户公司
- * @param data
- * @returns
- */
 export declare function registerByThirdPartyApi(data: any): Promise<any>;
 
-/**
- * 用户注册加入公司
- * @param data
- * @returns
- */
 export declare function registerJoinCompanyApi(data: any): Promise<any>;
 
-/**
- * 微信二维码登录用户注册加入公司 🍉
- * @param data
- * @returns
- */
 export declare function registerJoinCompanyBindWechatApi(data: any): Promise<any>;
 
-/**
- * 第三方应用注册加入公司
- * @param data
- * @returns
- */
 export declare function registerJoinCompByThirdPartyApi(data: any): Promise<any>;
 
-/**
- * 微信二维码登录注册用户公司
- * @param data
- * @returns
- */
 export declare function registerUserCompBindWechatApi(data: any): Promise<any>;
 
-export declare const RememberMeAccountKey = "JC-Remember-Account";
+export declare const RememberMeAccountKey: string;
 
-export declare const RememberMePasswordKey = "JC-Remember-Password";
+export declare const RememberMePasswordKey: string;
 
-export declare interface reportNewTypeData {
+export declare interface ReportNewTypeData {
     reportData: string;
     reportType: ReportType;
     countryId?: string | number;
 }
 
-export declare function reportNewTypeDataApi(payload: reportNewTypeData): Promise<{}>;
+export declare function reportNewTypeDataApi(payload: ReportNewTypeData): Promise<Record<string, any>>;
 
 export declare type ReportType = "City" | "Seaport" | "Airport" | "Line" | "Carrier" | "shipping_line" | "shipping_carrier" | "air_line" | "air_carrier";
 
@@ -1377,23 +1087,18 @@ declare interface RequestOptions {
     fetch?: typeof fetch;
 }
 
-/**
- * 重置 session
- */
 export declare function resetAuthSessionItems(): void;
 
-/**
- * 重置 GIO 相关 session
- * @returns
- */
 export declare function resetGioSessionItems(): void;
 
-/**
- * 重置密码
- * @param data
- * @returns
- */
-export declare function resetPasswordApi(data: any): Promise<any>;
+export declare function resetPasswordApi(data: ResetPasswordData): Promise<any>;
+
+declare interface ResetPasswordData {
+    account?: string;
+    password?: string;
+    code?: string;
+    [key: string]: any;
+}
 
 /**
  * 保存 clientId 到 localStorage
@@ -1407,8 +1112,6 @@ export declare function saveClientIdToSessionStorage(clientId: string): void;
 
 /**
  * 统一搜索接口
- * - 支持 keyword（模糊）, displayInfo（数组）, ids（按 type）, scope（countryId/cityId/provinceId）
- * - 返回扁平化的 UnifiedItem 列表 + 分页信息
  */
 export declare function search(params: {
     keyword?: string;
@@ -1433,7 +1136,7 @@ export declare function searchAirportByName(keyword: string, opts?: {
     page?: number;
     size?: number;
     cityId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+}): Promise<BaseResponse<LocationUnifiedItem>>;
 
 /**
  * 按名称搜索指定类型
@@ -1447,6 +1150,7 @@ export declare function searchByName(params: {
     sort?: string;
 }): Promise<BaseResponse<UnifiedItem>>;
 
+/** 按名称搜索参数 */
 export declare interface SearchByNameParams extends PageParams {
     keyword: string;
     searchMode?: "0" | "1" | "2";
@@ -1456,13 +1160,14 @@ export declare function searchCityByName(keyword: string, opts?: {
     page?: number;
     size?: number;
     countryId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+}): Promise<BaseResponse<LocationUnifiedItem>>;
 
 export declare function searchCountryByName(keyword: string, opts?: {
     page?: number;
     size?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+}): Promise<BaseResponse<LocationUnifiedItem>>;
 
+/** 通用搜索参数（需指定 displayInfo） */
 export declare interface SearchGenericParams extends SearchByNameParams {
     displayInfo: LocationType[];
 }
@@ -1471,19 +1176,15 @@ export declare function searchSeaportByName(keyword: string, opts?: {
     page?: number;
     size?: number;
     cityId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+}): Promise<BaseResponse<LocationUnifiedItem>>;
 
+/** 带范围约束的搜索参数 */
 export declare interface SearchWithScopeParams extends SearchByNameParams {
     countryId?: number;
     cityId?: number;
     provinceId?: number;
 }
 
-/**
- * 发送邮箱验证码
- * @param data
- * @returns
- */
 export declare function sendEmailCodeApi(data: {
     target: string;
     countryId?: number;
@@ -1491,11 +1192,6 @@ export declare function sendEmailCodeApi(data: {
     uuid?: string;
 }): Promise<any>;
 
-/**
- * 发送手机验证码
- * @param data
- * @returns
- */
 export declare function sendMobileCodeApi(data: {
     target: string;
     countryId?: number;
@@ -1503,38 +1199,12 @@ export declare function sendMobileCodeApi(data: {
     uuid?: string;
 }): Promise<any>;
 
-/**
- * 全局设置 session
- * @param data
- */
-export declare function setAuthSessionItems(data: {
-    activityCode?: string | null;
-    referenceUserId?: string | null;
-    empNo?: string | null;
-    uniqueCode?: string | null;
-    path?: string | null;
-    clickSource?: string | null;
-    registerEvent?: string | null;
-    registerType?: string | null;
-    compKey?: string | null;
-}): void;
+export declare function setAuthSessionItems(data: AuthSessionData): void;
 
-/**
- * 全局设置 GIO 相关 session
- * @param data
- */
-export declare function setGioSessionItems(data: {
-    registerEntry?: string | null;
-}): void;
+export declare function setGioSessionItems(data: GioSessionData): void;
 
-/**
- * 记住账号 (替代存密码)
- */
 export declare function setRememberMe(account: string, password: string, remember: boolean): void;
 
-/**
- * 整体设置所有凭证
- */
 export declare function setTokenAll(data: TokenData | null | undefined): void;
 
 export declare interface SharedConfig {
@@ -1545,29 +1215,20 @@ export declare interface SharedConfig {
     linePath: string;
     allLinePath: string;
     appId?: string;
+    commonKeys?: Partial<CommonKeysConfig>;
 }
 
-/**
- * 滑动或者点选验证
- * @param data
- * @returns
- */
 export declare function slideCheckApi(data: {
     pointJson: string;
     uuid: string;
 }): Promise<any>;
 
-/**
- * 获取验证图片  以及token
- * @param data
- * @returns
- */
 export declare function slideGetApi(data: {
     clientUid: string;
     ts: number;
 }): Promise<any>;
 
-declare interface ThirdPartyInfo {
+export declare interface ThirdPartyInfo {
     thirdPartyEmail: string;
     thirdPartyId: string;
     thirdPartyType: string;
@@ -1575,31 +1236,24 @@ declare interface ThirdPartyInfo {
     [property: string]: any;
 }
 
-declare interface ThirdResponseData {
-    /**
-     * 手机邮箱匹配列表 (修正为数组)
-     */
+/** 第三方登录响应 */
+export declare interface ThirdResponse {
+    code: number;
+    data: ThirdResponseData;
+    msg: string;
+    [property: string]: any;
+}
+
+export declare interface ThirdResponseData {
     mobileEmailList: ThirdResponseMobileEmailList[];
-    /**
-     * 是否跳转, true跳转 false不跳转
-     */
     redirect: boolean;
-    /**
-     * 跳转路径
-     */
     redirectPath: string;
-    /**
-     * tgc
-     */
     tgc: string;
-    /**
-     * 三方信息
-     */
     thirdPartyInfo: ThirdPartyInfo;
     [property: string]: any;
 }
 
-declare interface ThirdResponseMobileEmailList {
+export declare interface ThirdResponseMobileEmailList {
     account: string;
     cityId: number;
     cityNameCn: string;
@@ -1619,9 +1273,6 @@ declare interface ThirdResponseMobileEmailList {
 
 export declare const TOKEN_ENDPOINTS: Set<string>;
 
-/**
- * 3. 类型定义
- */
 export declare interface TokenData {
     accessToken?: string;
     expireIn?: number;
@@ -1629,50 +1280,21 @@ export declare interface TokenData {
     refreshTokenExpireIn?: number;
 }
 
-/**
- * 2. 常量定义 (补全所有业务 Key)
- */
-export declare const TokenKey = "JC-JAVA-Token-Root";
+export declare const TokenKey: string;
 
 export declare function toSafeHeaderValue(value: string): string;
 
 export declare const tracker: GioTracker;
 
-/** 归一化之后的实体 */
-export declare interface UnifiedItem {
-    id: number | string;
-    type: DisplayInfo;
-    nameCn?: string;
-    nameEn?: string;
-    display?: string;
-    continent?: Record<string, any>;
-    country?: Record<string, any>;
-    city?: Record<string, any>;
-    province?: Record<string, any>;
-    raw?: any;
-}
+/** 兼容旧名：baseSearch.UnifiedItem */
+export declare type UnifiedItem = LocationUnifiedItem;
 
-/**
- * 获取用户信息
- * @param data
- * @returns
- */
-export declare function userCompPermsApi(data: any): Promise<any>;
+export declare function userCompPermsApi(data: Record<string, any>): Promise<any>;
 
-/**
- * 验证账号是否存在 /auth/validateAccountExist
- * @param data
- * @returns
- */
 export declare function validateAccountExistApi(data: {
     target: string;
 }): Promise<any>;
 
-/**
- * 校验注册公司是否重名
- * @param data
- * @returns
- */
 export declare function validateCompanyApi(data: {
     countryId: number;
     cityId: number;