@jctrans-materials/shared 1.0.40-beta.11 → 1.0.40-beta.13

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { Emitter } from 'mitt';
 
 declare type ActionKeys = (typeof MODAL_ACTION)[keyof typeof MODAL_ACTION];
 
+/** 通用 API 响应结构 (最外层) */
 export declare interface ApiResponse<T = any> {
     code: number;
     msg: string;
@@ -14,8 +15,16 @@ export declare interface AppointSearch {
     val: string;
 }
 
+/** baseSearch 的 appointSearch 条目 */
 export declare type AppointSearchName = "continentId" | "countryId" | "cityId" | "provinceId" | "seaportId" | "airportId" | "allCityByCountryId";
 
+/** 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;
@@ -23,6 +32,7 @@ export declare function autoLoginByTGC(data: {
     tokenId?: string;
 }): Promise<any>;
 
+/** 分页响应结构 */
 export declare interface BaseResponse<T = any> {
     records: T[];
     total: number;
@@ -41,16 +51,7 @@ export declare function bindThirdPartyByCodeApi(data: any): Promise<any>;
 
 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 declare function checkAccountExistsFPApi(data: any): Promise<any>;
+export declare function checkAccountExistsFPApi(data: ForgotPasswordAccountData): Promise<any>;
 
 export declare function checkEmailCodeApi(data: {
     uuid: string;
@@ -78,9 +79,6 @@ export declare interface ClientIdPluginOptions {
     headerName?: string;
 }
 
-/**
- * 2. 可配置的常量定义
- */
 export declare interface CommonKeysConfig {
     TokenKey: string;
     HasLoginKey: string;
@@ -94,6 +92,7 @@ export declare interface CommonKeysConfig {
     RememberMePasswordKey: string;
 }
 
+/** baseSearch 的通用请求参数 */
 export declare interface CommonParams {
     current?: number;
     size?: number;
@@ -149,28 +148,31 @@ export declare const currentConfig: {
     readonly appId: string | undefined;
 };
 
+/** 兼容旧名 */
+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" | "Region" | "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: string;
 
@@ -191,26 +193,30 @@ export declare interface FetchClientIdOptions {
     injectRequest?: boolean;
 }
 
-/**
- * 获取字典列表
- * @param data
- * @returns
- */
 export declare function findDictApi(data?: {
     size: number;
 }): Promise<any>;
 
 export declare function findListByMobileEmailApi(data: any): Promise<any>;
 
-/**
- * 查询区号列表
- * @param data
- * @returns
- */
 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 管理工具
  * 用于生成和管理唯一的客户端标识符
@@ -223,30 +229,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;
 
-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>;
@@ -266,50 +261,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;
 
-export declare function getGioSessionItems(): {
-    registerEntry: string | null;
-};
+export declare function getGioSessionItems(): GioSessionData;
 
 /**
  * 兼容全环境的语言判断方法
@@ -319,22 +312,13 @@ export declare const getIsEn: () => boolean;
 
 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>;
 
 export declare function getLoginQrCode(data?: {}): Promise<any>;
 
-export declare function getMEVCodeApi(data: any): Promise<any>;
+export declare function getMEVCodeApi(data: ForgotPasswordVerifyData): Promise<any>;
 
 export declare function getMobileEmailApi(data: {
     id: string;
@@ -346,45 +330,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>>;
 
 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;
 
@@ -401,9 +376,6 @@ export declare const getSharedConfig: () => {
     readonly appId: string | undefined;
 };
 
-/**
- * 获取当前的 Access Token
- */
 export declare function getToken(): string | undefined;
 
 /**
@@ -425,10 +397,16 @@ export declare function getToken(): string | undefined;
  */
 export declare function getTracker<T extends GioTracker>(trackerInstance?: T): T | null;
 
-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 属性对象
  */
@@ -528,6 +506,8 @@ export declare interface GioInitOptions {
     ignoreFields?: string[];
     /** 曝光比例（0-1），与曝光插件结合使用，默认 0 */
     impressionScale?: number;
+    /** 性能采集插件配置。集成后默认开启首屏加载监控和错误监控，默认关闭网络监控 */
+    performance?: GioPerformanceOptions;
     /** 与小程序打通时的配置项，SDK >= 4.3.0 支持 */
     embeddedAdapter?: {
         /** 圈选服务器地址，SaaS 客户不需要配置 */
@@ -547,52 +527,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 {
@@ -810,9 +784,6 @@ export declare interface GioUserAttributes {
 
 export declare const HasLoginKey: string;
 
-/**
- * 全局初始化方法，在项目入口调用
- */
 export declare const initCommonKeys: (newKeys: Partial<CommonKeysConfig>) => void;
 
 /**
@@ -846,15 +817,11 @@ export declare function installFetchClientId(options?: FetchClientIdOptions): vo
 
 export declare function inviteJoinGetCompApi(data: any): Promise<any>;
 
-export declare interface IResponse<T> {
+/** 简化响应结构（仅 data 字段）— 兼容旧名 IResponse */
+export declare type IResponse<T> = {
     data: T;
-}
+};
 
-/**
- * 检查值是否为空
- * @param value 要检查的值
- * @returns 是否为空
- */
 export declare function isEmpty(value: any): boolean;
 
 /**
@@ -869,238 +836,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;
@@ -1126,9 +923,9 @@ export declare function loginApi(loginData: LoginDataParams): Promise<IResponse<
 
 export declare function loginByEmailOrMobileCodeApi(data: any): Promise<IResponse<ApiResponse<LoginResponseData>>>;
 
-export declare function loginByFacebookApi(data: any): Promise<IResponse<ApiResponse<ThirdResponseData>>>;
+export declare const loginByFacebookApi: (data: any) => Promise<IResponse<ApiResponse<ThirdResponseData>>>;
 
-export declare function loginByLinkedinApi(data: any): Promise<IResponse<ApiResponse<ThirdResponseData>>>;
+export declare const loginByLinkedinApi: (data: any) => Promise<IResponse<ApiResponse<ThirdResponseData>>>;
 
 export declare function loginByQrCode(data: {
     uniqueCode: string;
@@ -1141,6 +938,7 @@ export declare function loginByQrCode(data: {
 
 export declare function loginCodeBindWechatApi(data: any): Promise<any>;
 
+/** 登录请求参数 */
 export declare interface LoginDataParams {
     username: string;
     password: string;
@@ -1155,6 +953,7 @@ export declare interface LoginDataParams {
 
 export declare function loginPwdBindWechatApi(data: any): Promise<any>;
 
+/** 登录响应的 data 层 */
 export declare interface LoginResponseData {
     redirect: boolean;
     redirectPath?: string;
@@ -1163,6 +962,7 @@ export declare interface LoginResponseData {
     hasLogon?: boolean;
 }
 
+/** 登录结果中的 Token 信息 */
 export declare interface LoginResult {
     accessToken: string;
     expireIn: number;
@@ -1194,6 +994,7 @@ export declare const normalizeClickPageAttrs: (eventName: string, attrs?: GioTra
  */
 export declare type PageListenerCallback = (pageProps: GioPageProps) => void;
 
+/** 分页参数 */
 export declare interface PageParams {
     current?: number;
     size?: number;
@@ -1223,13 +1024,13 @@ export declare const RememberMeAccountKey: string;
 
 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";
 
@@ -1256,7 +1057,14 @@ export declare function resetAuthSessionItems(): void;
 
 export declare function resetGioSessionItems(): void;
 
-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
@@ -1270,8 +1078,6 @@ export declare function saveClientIdToSessionStorage(clientId: string): void;
 
 /**
  * 统一搜索接口
- * - 支持 keyword（模糊）, displayInfo（数组）, ids（按 type）, scope（countryId/cityId/provinceId）
- * - 返回扁平化的 UnifiedItem 列表 + 分页信息
  */
 export declare function search(params: {
     keyword?: string;
@@ -1296,7 +1102,7 @@ export declare function searchAirportByName(keyword: string, opts?: {
     page?: number;
     size?: number;
     cityId?: number;
-}): Promise<BaseResponse<UnifiedItem>>;
+}): Promise<BaseResponse<LocationUnifiedItem>>;
 
 /**
  * 按名称搜索指定类型
@@ -1310,6 +1116,7 @@ export declare function searchByName(params: {
     sort?: string;
 }): Promise<BaseResponse<UnifiedItem>>;
 
+/** 按名称搜索参数 */
 export declare interface SearchByNameParams extends PageParams {
     keyword: string;
     searchMode?: "0" | "1" | "2";
@@ -1319,13 +1126,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[];
 }
@@ -1334,8 +1142,9 @@ 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;
@@ -1356,30 +1165,12 @@ export declare function sendMobileCodeApi(data: {
     uuid?: string;
 }): Promise<any>;
 
-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 setGioSessionItems(data: {
-    registerEntry?: string | null;
-}): void;
+export declare function setAuthSessionItems(data: AuthSessionData): 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 {
@@ -1393,21 +1184,11 @@ export declare interface SharedConfig {
     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;
@@ -1421,6 +1202,7 @@ export declare interface ThirdPartyInfo {
     [property: string]: any;
 }
 
+/** 第三方登录响应 */
 export declare interface ThirdResponse {
     code: number;
     data: ThirdResponseData;
@@ -1429,25 +1211,10 @@ export declare interface ThirdResponse {
 }
 
 export declare interface ThirdResponseData {
-    /**
-     * 手机邮箱匹配列表 (修正为数组)
-     */
     mobileEmailList: ThirdResponseMobileEmailList[];
-    /**
-     * 是否跳转, true跳转 false不跳转
-     */
     redirect: boolean;
-    /**
-     * 跳转路径
-     */
     redirectPath: string;
-    /**
-     * tgc
-     */
     tgc: string;
-    /**
-     * 三方信息
-     */
     thirdPartyInfo: ThirdPartyInfo;
     [property: string]: any;
 }
@@ -1472,9 +1239,6 @@ export declare interface ThirdResponseMobileEmailList {
 
 export declare const TOKEN_ENDPOINTS: Set<string>;
 
-/**
- * 3. 类型定义
- */
 export declare interface TokenData {
     accessToken?: string;
     expireIn?: number;
@@ -1488,21 +1252,10 @@ 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;
 
-export declare function userCompPermsApi(data: any): Promise<any>;
+export declare function userCompPermsApi(data: Record<string, any>): Promise<any>;
 
 export declare function validateAccountExistApi(data: {
     target: string;