@haluo/util 2.0.33 → 2.0.35

package/dist/modules/track/index.js

@@ -0,0 +1,421 @@
+/**
+ * Track 埋点模块
+ * 统一封装各项目的埋点上报逻辑
+ *
+ * @example
+ * // 最简初始化（所有配置都有默认值）
+ * import { createTracker } from '@haluo/util/dist/modules/track'
+ *
+ * const tracker = createTracker({})
+ * // 或指定 appName
+ * const tracker2 = createTracker({ appName: 'emoto' })
+ *
+ * // 使用
+ * tracker.track('EVENT_ID', { key: 'value' })
+ * tracker.trackError({ err: 'error message' })
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+export * from './types';
+/** 默认埋点上报URL */
+var DEFAULT_LOG_URL = 'https://log-center.58moto.com/am/log/v1/json';
+/** 默认应用名称 */
+var DEFAULT_APP_NAME = 'moto';
+/** 默认错误上报事件ID */
+var ERROR_EVENT_ID = 'S_00000000000082';
+/** 默认错误应用类型（H5异常） */
+var DEFAULT_ERROR_APPTYPE = '2012';
+/**
+ * 内置的简易 httpClient
+ * 使用 fetch 实现 POST 请求
+ */
+var defaultHttpClient = {
+    post: function (url, data) {
+        if (typeof window === 'undefined' || !window.fetch) {
+            console.warn('[Tracker] 当前环境不支持 fetch');
+            return Promise.resolve();
+        }
+        // 构建 form-urlencoded 格式的请求体
+        var formBody = Object.keys(data)
+            .map(function (key) { return encodeURIComponent(key) + '=' + encodeURIComponent(data[key]); })
+            .join('&');
+        return fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded'
+            },
+            body: formBody
+        }).then(function (res) { return res.json(); }).catch(function (err) {
+            console.error('[Tracker] 埋点请求失败:', err);
+        });
+    }
+};
+/**
+ * 从 localStorage 安全获取并解析 JSON
+ */
+function safeGetLocalStorage(key, defaultValue) {
+    try {
+        if (typeof window === 'undefined' || !window.localStorage) {
+            return defaultValue;
+        }
+        var value = window.localStorage.getItem(key);
+        if (!value || value === 'undefined') {
+            return defaultValue;
+        }
+        return JSON.parse(value);
+    }
+    catch (_a) {
+        return defaultValue;
+    }
+}
+/**
+ * 获取用户代理字符串
+ */
+function getUserAgent() {
+    if (typeof window === 'undefined' || !window.navigator) {
+        return '';
+    }
+    return window.navigator.userAgent.toLowerCase();
+}
+/**
+ * 检测平台类型
+ */
+function detectPlatform(ua) {
+    var isAndroid = ua.indexOf('android') > -1;
+    var isHarmonyos = ua.indexOf('harmonyos') > -1;
+    return isAndroid || isHarmonyos ? 'android' : 'ios';
+}
+/**
+ * 检测是否在客户端环境
+ */
+function isClientEnv() {
+    return typeof window !== 'undefined' && !!window.isClient;
+}
+/**
+ * 检测是否为开发环境
+ */
+function isDevelopment() {
+    return process.env.NODE_ENV === 'development';
+}
+/**
+ * 获取全局 AppCall 对象
+ */
+function getGlobalAppCall() {
+    if (typeof window === 'undefined')
+        return null;
+    return window.AppCall || null;
+}
+/**
+ * 内置的 getChannel 方法
+ * 根据 UA 检测渠道：微信、QQ、微博等
+ */
+function defaultGetChannel() {
+    var _a;
+    if (typeof window === 'undefined' || !window.navigator) {
+        return 'other';
+    }
+    var ua = window.navigator.userAgent.toLowerCase();
+    var isAndroid = ua.indexOf('android') > -1;
+    // 区分出微信、QQ、微博平台、其他
+    if (ua.indexOf('micromessenger') > -1) {
+        // 在微信中打开
+        return 'weixin';
+    }
+    else if (ua.indexOf('weibo') > -1) {
+        // 在新浪微博客户端打开
+        return 'weibo';
+    }
+    else if (ua.indexOf(' qq') > -1 && ua.indexOf('mqqbrowser') < 0 && !isAndroid) {
+        // ios在QQ空间打开
+        return 'qq';
+    }
+    else if (ua.indexOf(' qq') > -1 && ua.indexOf('mqqbrowser') > -1 && isAndroid) {
+        // 安卓在QQ空间打开
+        return 'qq';
+    }
+    else {
+        // 使用 AppCall 获取包名，或返回 other
+        var appCall = getGlobalAppCall();
+        return ((_a = appCall === null || appCall === void 0 ? void 0 : appCall.getAppPackage) === null || _a === void 0 ? void 0 : _a.call(appCall)) || 'other';
+    }
+}
+/**
+ * Track 类
+ * 提供埋点上报功能
+ */
+var Tracker = /** @class */ (function () {
+    function Tracker(config) {
+        this.config = config;
+    }
+    /**
+     * 获取当前版本号
+     * 优先级：window.AppCall.getAppVersion() > 传入的 appCall > config.version
+     */
+    Tracker.prototype.getVersion = function () {
+        var _a = this.config, version = _a.version, appCall = _a.appCall;
+        // 优先使用全局 window.AppCall 获取版本号
+        var globalAppCall = getGlobalAppCall();
+        if (globalAppCall === null || globalAppCall === void 0 ? void 0 : globalAppCall.getAppVersion) {
+            var appVersion = globalAppCall.getAppVersion();
+            if (appVersion)
+                return appVersion;
+        }
+        // 其次使用传入的 appCall
+        if (appCall === null || appCall === void 0 ? void 0 : appCall.getAppVersion) {
+            var appVersion = appCall.getAppVersion();
+            if (appVersion)
+                return appVersion;
+        }
+        return version || '';
+    };
+    /**
+     * 获取渠道号
+     * 优先使用自定义 getChannel，否则使用内置的默认方法
+     */
+    Tracker.prototype.getChannel = function () {
+        if (this.config.getChannel) {
+            return this.config.getChannel();
+        }
+        // 使用内置的 getChannel 方法
+        return defaultGetChannel();
+    };
+    /**
+     * 检查是否命中AB测试
+     */
+    Tracker.prototype.checkAbTest = function (eId) {
+        if (!this.config.enableAbTest || !this.config.getAbFlags) {
+            return undefined;
+        }
+        try {
+            var abFlags = this.config.getAbFlags();
+            // 支持数组和对象两种格式
+            var flagList = Array.isArray(abFlags) ? abFlags : Object.values(abFlags);
+            return flagList.find(function (item) { var _a; return (_a = item === null || item === void 0 ? void 0 : item.indexList) === null || _a === void 0 ? void 0 : _a.includes(eId); });
+        }
+        catch (_a) {
+            return undefined;
+        }
+    };
+    /**
+     * 构建埋点请求数据
+     */
+    Tracker.prototype.buildPostData = function (params) {
+        var eId = params.eId, eventContent = params.eventContent;
+        var deviceData = safeGetLocalStorage('deviceData', {});
+        var userData = safeGetLocalStorage('user', {});
+        var ua = getUserAgent();
+        var platform = detectPlatform(ua);
+        var isClient = isClientEnv();
+        return {
+            deviceid: deviceData.deviceId || '',
+            plateform: isClient ? platform : 'h5',
+            subplateform: 'h5',
+            version: this.getVersion(),
+            channel: this.getChannel(),
+            client: '',
+            os: '',
+            useragent: ua,
+            logs: [
+                {
+                    uid: String(userData.uid || '0'),
+                    eventid: eId,
+                    eventcontent: eventContent || '{}',
+                    begintime: Date.now(),
+                    pmenu: '',
+                    menu: '',
+                    net: deviceData.network || '',
+                    lon: '',
+                    lat: '',
+                    areacode: '',
+                    address: ''
+                }
+            ]
+        };
+    };
+    /**
+     * 发送埋点请求
+     */
+    Tracker.prototype.sendRequest = function (postData) {
+        var _a, _b;
+        var logUrl = this.config.logUrl || DEFAULT_LOG_URL;
+        var appName = this.config.appName || DEFAULT_APP_NAME;
+        // 优先使用传入的 httpClient，否则使用内置的默认实现
+        var httpClient = ((_b = (_a = this.config).httpClient) === null || _b === void 0 ? void 0 : _b.call(_a)) || defaultHttpClient;
+        return httpClient.post(logUrl, {
+            json: JSON.stringify(postData),
+            appName: appName
+        });
+    };
+    /**
+     * 核心埋点方法
+     * @param params 埋点参数
+     */
+    Tracker.prototype.trackUser = function (params) {
+        return __awaiter(this, void 0, void 0, function () {
+            var eId, eventContent, abFlag, globalAppCall, appCall, postData;
+            return __generator(this, function (_a) {
+                eId = params.eId, eventContent = params.eventContent;
+                // 开发环境不发送埋点
+                if (isDevelopment()) {
+                    console.log('[Tracker] 开发环境，跳过埋点:', { eId: eId, eventContent: eventContent });
+                    return [2 /*return*/, Promise.resolve()];
+                }
+                // 检查AB测试
+                if (this.config.enableAbTest) {
+                    abFlag = this.checkAbTest(eId);
+                    if (abFlag === null || abFlag === void 0 ? void 0 : abFlag.test) {
+                        globalAppCall = getGlobalAppCall();
+                        appCall = globalAppCall || this.config.appCall;
+                        if (appCall === null || appCall === void 0 ? void 0 : appCall.sendEventMsg) {
+                            return [2 /*return*/, appCall.sendEventMsg({ eId: eId, eventContent: eventContent || '{}' })];
+                        }
+                    }
+                }
+                postData = this.buildPostData(params);
+                return [2 /*return*/, this.sendRequest(postData)];
+            });
+        });
+    };
+    /**
+     * 埋点上报
+     * @param eId 事件ID
+     * @param contentObj 事件内容对象
+     * @param isAbTest 是否AB测试（已废弃，保留兼容）
+     */
+    Tracker.prototype.track = function (eId, contentObj, isAbTest) {
+        if (contentObj === void 0) { contentObj = {}; }
+        if (isAbTest === void 0) { isAbTest = false; }
+        return this.trackUser({
+            eId: eId,
+            eventContent: JSON.stringify(contentObj),
+            isAbTest: isAbTest
+        });
+    };
+    /**
+     * 错误上报
+     * @param contentObj 错误内容对象
+     */
+    Tracker.prototype.trackError = function (contentObj) {
+        var _a;
+        if (contentObj === void 0) { contentObj = {}; }
+        var errorContent = __assign({ err: contentObj.err || '', apptype: contentObj.apptype || DEFAULT_ERROR_APPTYPE, url: contentObj.url || (typeof window !== 'undefined' ? (_a = window.location) === null || _a === void 0 ? void 0 : _a.href : '') || '', platform: contentObj.platform || 'wap' }, contentObj);
+        return this.trackUser({
+            eId: ERROR_EVENT_ID,
+            eventContent: JSON.stringify(errorContent)
+        });
+    };
+    /**
+     * 更新配置
+     */
+    Tracker.prototype.updateConfig = function (config) {
+        this.config = __assign(__assign({}, this.config), config);
+    };
+    /**
+     * 获取当前配置
+     */
+    Tracker.prototype.getConfig = function () {
+        return __assign({}, this.config);
+    };
+    return Tracker;
+}());
+/**
+ * 创建 Tracker 实例
+ * @param config 配置项
+ * @returns Tracker 实例
+ *
+ * @example
+ * const tracker = createTracker({
+ *   appName: 'emoto'
+ *   // logUrl 可选，默认: https://log-center.58moto.com/am/log/v1/json
+ *   // httpClient 可选，默认使用内置 fetch 实现
+ * })
+ *
+ * // 普通埋点
+ * tracker.track('EVENT_001', { page: 'home' })
+ *
+ * // 错误上报
+ * tracker.trackError({ err: 'Something went wrong' })
+ */
+export function createTracker(config) {
+    return new Tracker(config);
+}
+/**
+ * 创建简化版埋点方法
+ * 返回 postTrack 和 postTrackError 方法，与原有项目用法一致
+ *
+ * @example
+ * const { postTrack, postTrackError } = createTrackMethods({
+ *   appName: 'moto'
+ * })
+ *
+ * // 等同于原来的 postJddTrack
+ * postTrack('EVENT_001', { page: 'home' })
+ *
+ * // 等同于原来的 postJddTrackError
+ * postTrackError({ err: 'error message' })
+ */
+export function createTrackMethods(config) {
+    var tracker = createTracker(config);
+    return {
+        /** 埋点上报方法 */
+        postTrack: function (eId, contentObj, isAbTest) {
+            if (contentObj === void 0) { contentObj = {}; }
+            if (isAbTest === void 0) { isAbTest = false; }
+            return tracker.track(eId, contentObj, isAbTest);
+        },
+        /** 错误上报方法 */
+        postTrackError: function (contentObj) {
+            if (contentObj === void 0) { contentObj = {}; }
+            return tracker.trackError(contentObj);
+        },
+        /** Tracker 实例 */
+        tracker: tracker
+    };
+}
+export { defaultGetChannel as getChannel };
+export default createTracker;

package/dist/modules/track/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Track 模块类型定义
+ */
+/** 应用名称类型 */
+export type AppName = 'emoto' | 'moto' | 'watch' | 'drone' | string;
+/** 平台类型 */
+export type Platform = 'android' | 'ios' | 'h5' | 'wap';
+/** Track 初始化配置 */
+export interface TrackConfig {
+    /** 应用名称，如 'emoto', 'moto', 'watch'，默认: 'moto' */
+    appName?: AppName;
+    /** 埋点上报URL，默认: https://log-center.58moto.com/am/log/v1/json */
+    logUrl?: string;
+    /** 应用版本号 */
+    version?: string;
+    /** HTTP请求方法，需要支持 post(url, data) 形式 */
+    httpClient?: () => HttpClient;
+    /** 获取渠道号的方法 */
+    getChannel?: () => string;
+    /** AppCall实例（用于AB测试等场景） */
+    appCall?: AppCallInterface;
+    /** 是否启用AB测试逻辑 */
+    enableAbTest?: boolean;
+    /** 获取当前AB测试标记的方法 */
+    getAbFlags?: () => AbFlag[] | Record<string, AbFlag>;
+}
+/** HTTP客户端接口 */
+export interface HttpClient {
+    post: (url: string, data: any) => Promise<any>;
+}
+/** AppCall接口（可选） */
+export interface AppCallInterface {
+    getAppVersion?: () => string;
+    sendEventMsg?: (data: {
+        eId: string;
+        eventContent: string;
+    }) => Promise<any>;
+}
+/** AB测试标记 */
+export interface AbFlag {
+    indexList: string[];
+    test?: boolean;
+    [key: string]: any;
+}
+/** 设备数据 */
+export interface DeviceData {
+    deviceId?: string;
+    network?: string;
+    [key: string]: any;
+}
+/** 用户数据 */
+export interface UserData {
+    uid?: string | number;
+    [key: string]: any;
+}
+/** 位置数据 */
+export interface PositionData {
+    lng?: string | number;
+    lat?: string | number;
+    [key: string]: any;
+}
+/** 单条日志数据 */
+export interface LogItem {
+    uid: string;
+    eventid: string;
+    eventcontent: string;
+    begintime: number;
+    pmenu: string;
+    menu: string;
+    net: string;
+    lon: string;
+    lat: string;
+    areacode: string;
+    address: string;
+}
+/** 埋点请求数据 */
+export interface TrackPostData {
+    deviceid: string;
+    plateform: Platform;
+    subplateform: string;
+    version: string;
+    channel: string;
+    client: string;
+    os: string;
+    useragent: string;
+    logs: LogItem[];
+}
+/** 埋点参数 */
+export interface TrackParams {
+    /** 事件ID */
+    eId: string;
+    /** 事件内容（JSON字符串） */
+    eventContent?: string;
+    /** 是否使用AB测试上报 */
+    isAbTest?: boolean;
+}
+/** 错误上报内容 */
+export interface ErrorContent {
+    /** 错误信息 */
+    err: string;
+    /** 应用类型 */
+    apptype?: string;
+    /** 页面URL */
+    url?: string;
+    /** 平台 */
+    platform?: string;
+    [key: string]: any;
+}

package/dist/modules/track/types.js

@@ -0,0 +1,4 @@
+/**
+ * Track 模块类型定义
+ */
+export {};

package/dist/modules/upload/aliOss.d.ts

@@ -14,7 +14,10 @@
  *   darkWaterUploadImage: (params) => api.darkWaterUploadImage(params),
  *   multiTransferImage: (params) => api.multiTransferImage(params),
  *   generatePrePresignedUrl: (params) => api.generatePrePresignedUrl(params),
- *   messageWarning: (msg) => window.$message.warning(msg)
+ *   messageWarning: (msg) => window.$message.warning(msg),
+ *   // 可选：开启错误上报
+ *   enableErrorReport: true,
+ *   appName: 'emoto'
  * })
  *
  * // 图片上传
@@ -41,6 +44,7 @@
  * })
  * ```
  */
+import type { TrackConfig } from '../track';
 /**
  * 业务类型枚举
  */
@@ -164,6 +168,10 @@ interface ApiResponse<T = any> {
  * 业务相关的API通过此接口传入，实现业务逻辑解耦
  */
 export interface AliOssApiConfig {
+    /** 应用名称，用于错误上报 */
+    appName?: TrackConfig['appName'];
+    /** 是否启用错误上报，默认 false */
+    enableErrorReport?: boolean;
     /** 获取STS，POST V4签名独有的表单元素- 必需 */
     /** businessType: 业务编码(必传), docType: 文件格式如png(必传)，size: _1024_567(可选) */
     getSts: (params: {
@@ -194,8 +202,15 @@ export interface AliOssApiConfig {
 export declare class AliOssClass {
     private static instance;
     private apiConfig;
+    private tracker;
     private constructor();
     static getInstance(apiConfig: AliOssApiConfig): AliOssClass;
+    /**
+     * 上报上传错误
+     * @param err 错误信息
+     * @param extra 额外信息
+     */
+    private reportError;
     /**
      * 判断文件是否为图片（支持常见图片格式）
      * @param {File} file - 上传的File对象
@@ -248,28 +263,60 @@ export declare class AliOssClass {
      * 图片上传主方法
      * 整合了所有项目的图片上传逻辑
      * @param option 上传选项
-     * @returns Promise
+     * @returns Promise - 成功时返回图片信息对象，失败时reject错误信息字符串
+     * @returns 成功返回结构: {
+     *   url: string - 上传后的图片URL,
+     *   imgUrl: string - 上传后的图片URL（可能包含尺寸信息）,
+     *   imgOrgUrl: string - 原始图片URL（包含尺寸信息）,
+     *   name: string - 文件名,
+     *   fileName: string - 文件名
+     * }
+     * @returns 失败返回: 错误信息字符串，如"文件类型不支持"、"上传失败"等
      */
     ossUploadImage: (option: UploadOption) => Promise<any>;
     /**
      * 文件上传方法
      * 支持视频、文档、APK等文件类型
      * @param option 上传选项
-     * @returns Promise
+     * @returns Promise - 成功时返回文件信息对象，失败时reject错误信息字符串
+     * @returns 成功返回结构: {
+     *   url: string - 上传后的文件URL,
+     *   imgUrl: string - 上传后的文件URL,
+     *   imgOrgUrl: string - 上传后的文件URL,
+     *   name: string - 文件名,
+     *   fileName: string - 文件名
+     * }
+     * @returns 失败返回: 错误信息字符串，如"文件类型不支持"、"上传失败"等
      */
     ossUploadFile: (option: UploadOption) => Promise<any>;
     /**
      * 纯图片上传 pureOssUploadImage
      * 注释：图片上传，不压缩
      * @param option 上传选项
-     * @returns Promise
+     * @returns Promise - 成功时返回图片信息对象，失败时reject错误信息字符串
+     * @returns 成功返回结构: {
+     *   url: string - 上传后的图片URL,
+     *   imgUrl: string - 上传后的图片URL,
+     *   imgOrgUrl: string - 上传后的图片URL,
+     *   name: string - 文件名,
+     *   fileName: string - 文件名
+     * }
+     * @returns 失败返回: 错误信息字符串，如"文件类型不支持"、"上传失败"等
      */
     pureOssUploadImage: (option: UploadOption) => Promise<any>;
     /**
      * 商品详情图片上传（不建议直接使用，请使用 pureOssUploadImage）
      * 注释：图片上传，不压缩
      * @param option 上传选项
-     * @returns Promise
+     * @returns Promise - 成功时返回图片信息对象，失败时reject错误信息字符串
+     * @returns 成功返回结构: {
+     *   url: string - 上传后的图片URL,
+     *   imgUrl: string - 上传后的图片URL,
+     *   imgOrgUrl: string - 上传后的图片URL,
+     *   name: string - 文件名,
+     *   fileName: string - 文件名
+     * }
+     * @returns 失败返回: 错误信息字符串，如"文件类型不支持"、"上传失败"等
      */
     shopDetailUpdate: (option: UploadOption) => Promise<any>;
     /**