@jctrans-materials/shared 1.0.40-beta.6 → 1.0.40-beta.7

package/dist/index.d.ts

@@ -487,6 +487,8 @@ export declare function getTracker<T extends GioTracker>(trackerInstance?: T): T
  */
 export declare function getUserInfoApi(data: 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"];
+
 /**
  * GIO 属性对象
  */
@@ -609,6 +611,50 @@ export declare interface GioPageProps {
  */
 export declare type GioTimerId = string;
 
+/**
+ * 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'
+ * });
+ * ```
+ */
+export declare type GioTrackAttrs = Record<string, string | number | Array<string | number> | null | undefined>;
+
 declare class GioTracker {
     private hasInitCalled;
     private dispatcher;
@@ -864,6 +910,13 @@ declare interface IResponse<T> {
     data: T;
 }
 
+/**
+ * 检查值是否为空
+ * @param value 要检查的值
+ * @returns 是否为空
+ */
+export declare function isEmpty(value: any): boolean;
+
 /**
  * 检查 GIO 是否可用（浏览器环境且已初始化）
  *
@@ -1116,27 +1169,17 @@ export declare interface LocationUnifiedItem {
     display?: string;
     displayEn?: string;
     displayCn?: string;
-    /** * 通用代码字段 (自动取 scacCode 或 carrierCode)
-     * 适用于仅展示用途
-     */
     code?: string;
-    /** * SCAC 代码 (Standard Carrier Alpha Code) - 通常用于船司
-     */
     scacCode?: string;
-    /** * IATA 代码 - 通常用于航司
-     */
     iataCode?: string;
-    /** * 承运人通用代码
-     */
     carrierCode?: string;
-    /** * 承运人类型: 'air' | 'shipping'
-     */
     lineType?: string;
     continent?: Record<string, any>;
     country?: Record<string, any>;
     city?: Record<string, any>;
     province?: Record<string, any>;
     raw?: any;
+    [key: string]: unknown;
 }
 
 /**
@@ -1177,6 +1220,8 @@ export declare function loginByQrCode(data: {
     appId: string;
     redirectPath: string;
     kick: boolean;
+    prjId?: string;
+    formEntry?: string;
 }): Promise<any>;
 
 /**
@@ -1235,6 +1280,10 @@ export declare type ModalEvents = Record<ActionKeys, any> & {
 
 export declare type ModalOpenCallback = () => void;
 
+export declare const normalizeAttrs: (attrs?: GioTrackAttrs) => GioTrackAttrs;
+
+export declare const normalizeClickPageAttrs: (eventName: string, attrs?: GioTrackAttrs) => GioTrackAttrs;
+
 /**
  * 页面变更回调
  */
@@ -1307,7 +1356,7 @@ export declare interface reportNewTypeData {
 
 export declare function reportNewTypeDataApi(payload: reportNewTypeData): Promise<{}>;
 
-export declare type ReportType = "City" | "Seaport" | "Airport" | "Line";
+export declare type ReportType = "City" | "Seaport" | "Airport" | "Line" | "Carrier" | "shipping_line" | "shipping_carrier" | "air_line" | "air_carrier";
 
 declare interface RequestAdapter {
     get(url: string, config?: RequestConfig): Promise<any>;