@macroui/event-tracker 1.3.0

package/dist/plugin/indexeddb-sender.mjs

@@ -0,0 +1,92 @@
+/**
+ * 浏览器端辅助方法
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+}
+
+/**
+ * 序列化 & 编码
+ */
+function encodeEvent(event, encryptor) {
+    var json = JSON.stringify(event);
+    return json;
+}
+
+/**
+ * indexeddb-sender 插件：把事件写到 IndexedDB（用于离线缓存 / 批量消费）
+ *  - 不实际发送，只把序列化事件追加到指定 IDB store
+ *  - 适合后续被 webview bridge / native / service worker 消费
+ */
+function indexedDBSender(opts) {
+    if (opts === void 0) { opts = {}; }
+    var dbName = opts.dbName || 'event-tracker-outbox';
+    var storeName = opts.storeName || 'outbox';
+    var max = opts.max || 500;
+    var dbPromise = null;
+    function openDB() {
+        if (!isBrowser() || typeof indexedDB === 'undefined')
+            return Promise.resolve(null);
+        return new Promise(function (resolve) {
+            try {
+                var req_1 = indexedDB.open(dbName, 1);
+                req_1.onupgradeneeded = function () {
+                    var db = req_1.result;
+                    if (!db.objectStoreNames.contains(storeName)) {
+                        db.createObjectStore(storeName, { autoIncrement: true });
+                    }
+                };
+                req_1.onsuccess = function () { return resolve(req_1.result); };
+                req_1.onerror = function () { return resolve(null); };
+            }
+            catch (_a) {
+                resolve(null);
+            }
+        });
+    }
+    var interceptor = {
+        name: 'indexeddb-sender',
+        priority: 60,
+        entry: function (ctx) {
+            if (ctx.meta.stage !== 'sendDataStage')
+                return;
+            var ev = ctx.data;
+            dbPromise !== null && dbPromise !== void 0 ? dbPromise : (dbPromise = openDB());
+            dbPromise.then(function (db) {
+                if (!db)
+                    return;
+                try {
+                    var tx = db.transaction(storeName, 'readwrite');
+                    var store_1 = tx.objectStore(storeName);
+                    var payload_1 = encodeEvent(ev);
+                    // 限制大小：> max 则删头
+                    var cntReq_1 = store_1.count();
+                    cntReq_1.onsuccess = function () {
+                        if (cntReq_1.result >= max) {
+                            store_1.delete(IDBKeyRange.lowerBound(0, true));
+                        }
+                        store_1.add({ time: Date.now(), payload: payload_1 });
+                    };
+                }
+                catch (_a) {
+                    /* ignore */
+                }
+            }).catch(function () { });
+            return ev;
+        },
+    };
+    return {
+        name: 'indexeddb-sender',
+        install: function (_a) {
+            var stages = _a.stages;
+            if (!isBrowser())
+                return;
+            stages.sendDataStage.register(interceptor);
+        },
+        uninstall: function () {
+            dbPromise = null;
+        },
+    };
+}
+
+export { indexedDBSender };

package/dist/plugin/pageleave.cjs

@@ -0,0 +1,74 @@
+'use strict';
+
+/**
+ * 浏览器端辅助方法
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+}
+
+/**
+ * SDK 预置事件名与预置属性 key（v1.1：完整对齐神策）
+ * 命名风格对齐神策，方便跨平台对接
+ */
+/** 预置事件名 */
+var PresetEvent = {
+    WebPageLeave: '$WebPageLeave'};
+/** 预置属性 key */
+var PresetProperty = {
+    URLPath: '$url_path',
+    Title: '$title',
+    EventDuration: '$event_duration',
+    ViewportPosition: '$viewport_position'};
+
+/**
+ * pageleave 插件：用户离开页面（关闭、跳转、切到后台）时上报
+ *  - $WebPageLeave 事件
+ *  - 包含 $event_duration / $url_path / $referrer / $viewport_position
+ *  - 包含 page_visible 标记（visibilitychange API）
+ */
+function pageLeave(_opts) {
+    var sdkRef = null;
+    var enterTime = Date.now();
+    function fire(reason) {
+        var _a;
+        if (!sdkRef)
+            return;
+        var dur = Date.now() - enterTime;
+        sdkRef.track(PresetEvent.WebPageLeave, (_a = {},
+            _a[PresetProperty.EventDuration] = dur,
+            _a[PresetProperty.URLPath] = location.pathname + location.search + location.hash,
+            _a[PresetProperty.Title] = document.title,
+            _a[PresetProperty.ViewportPosition] = window.scrollY || 0,
+            _a.$page_leave_reason = reason,
+            _a));
+    }
+    return {
+        name: 'pageleave',
+        install: function (_a) {
+            var sdk = _a.sdk;
+            if (!isBrowser())
+                return;
+            sdkRef = sdk;
+            enterTime = Date.now();
+            // 重新进入页面时刷新 enterTime
+            var onVisible = function () {
+                if (document.visibilityState === 'visible')
+                    enterTime = Date.now();
+            };
+            document.addEventListener('visibilitychange', onVisible);
+            // 关闭/离开
+            window.addEventListener('pagehide', function () { return fire('pagehide'); });
+            window.addEventListener('beforeunload', function () { return fire('unload'); });
+            document.addEventListener('visibilitychange', function () {
+                if (document.visibilityState === 'hidden')
+                    fire('hidden');
+            });
+        },
+        uninstall: function () {
+            sdkRef = null;
+        },
+    };
+}
+
+exports.pageLeave = pageLeave;

package/dist/plugin/pageleave.mjs

@@ -0,0 +1,72 @@
+/**
+ * 浏览器端辅助方法
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+}
+
+/**
+ * SDK 预置事件名与预置属性 key（v1.1：完整对齐神策）
+ * 命名风格对齐神策，方便跨平台对接
+ */
+/** 预置事件名 */
+var PresetEvent = {
+    WebPageLeave: '$WebPageLeave'};
+/** 预置属性 key */
+var PresetProperty = {
+    URLPath: '$url_path',
+    Title: '$title',
+    EventDuration: '$event_duration',
+    ViewportPosition: '$viewport_position'};
+
+/**
+ * pageleave 插件：用户离开页面（关闭、跳转、切到后台）时上报
+ *  - $WebPageLeave 事件
+ *  - 包含 $event_duration / $url_path / $referrer / $viewport_position
+ *  - 包含 page_visible 标记（visibilitychange API）
+ */
+function pageLeave(_opts) {
+    var sdkRef = null;
+    var enterTime = Date.now();
+    function fire(reason) {
+        var _a;
+        if (!sdkRef)
+            return;
+        var dur = Date.now() - enterTime;
+        sdkRef.track(PresetEvent.WebPageLeave, (_a = {},
+            _a[PresetProperty.EventDuration] = dur,
+            _a[PresetProperty.URLPath] = location.pathname + location.search + location.hash,
+            _a[PresetProperty.Title] = document.title,
+            _a[PresetProperty.ViewportPosition] = window.scrollY || 0,
+            _a.$page_leave_reason = reason,
+            _a));
+    }
+    return {
+        name: 'pageleave',
+        install: function (_a) {
+            var sdk = _a.sdk;
+            if (!isBrowser())
+                return;
+            sdkRef = sdk;
+            enterTime = Date.now();
+            // 重新进入页面时刷新 enterTime
+            var onVisible = function () {
+                if (document.visibilityState === 'visible')
+                    enterTime = Date.now();
+            };
+            document.addEventListener('visibilitychange', onVisible);
+            // 关闭/离开
+            window.addEventListener('pagehide', function () { return fire('pagehide'); });
+            window.addEventListener('beforeunload', function () { return fire('unload'); });
+            document.addEventListener('visibilitychange', function () {
+                if (document.visibilityState === 'hidden')
+                    fire('hidden');
+            });
+        },
+        uninstall: function () {
+            sdkRef = null;
+        },
+    };
+}
+
+export { pageLeave };

package/dist/plugin/pageload.cjs

@@ -0,0 +1,198 @@
+'use strict';
+
+/**
+ * 浏览器端辅助方法
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+}
+
+/**
+ * SDK 预置事件名与预置属性 key（v1.1：完整对齐神策）
+ * 命名风格对齐神策，方便跨平台对接
+ */
+/** 预置事件名 */
+var PresetEvent = {
+    WebPageLoad: '$WebPageLoad'};
+/** 预置属性 key */
+var PresetProperty = {
+    // 设备 / 环境
+    AppId: '$app_id',
+    AppVersion: '$app_version',
+    Lib: '$lib',
+    LibMethod: '$lib_method',
+    LibDetail: '$lib_detail',
+    LibVersion: '$lib_version',
+    ScreenWidth: '$screen_width',
+    ScreenHeight: '$screen_height',
+    ViewportWidth: '$viewport_width',
+    ViewportHeight: '$viewport_height',
+    TimezoneOffset: '$timezone_offset',
+    UserAgent: '$user_agent',
+    Language: '$language',
+    FirstBrowserCharset: '$first_browser_charset',
+    FirstBrowserLanguage: '$first_browser_language',
+    // 位置 / 流量来源
+    URL: '$url',
+    URLPath: '$url_path',
+    Title: '$title',
+    Referrer: '$referrer',
+    ReferrerHost: '$referrer_host',
+    LatestReferrer: '$latest_referrer',
+    LatestReferrerHost: '$latest_referrer_host',
+    LatestLandingPage: '$latest_landing_page',
+    LatestSearchKeyword: '$latest_search_keyword',
+    LatestTrafficSourceType: '$latest_traffic_source_type',
+    FirstReferrer: '$first_referrer',
+    FirstReferrerHost: '$first_referrer_host',
+    FirstSearchKeyword: '$first_search_keyword',
+    FirstTrafficSourceType: '$first_traffic_source_type',
+    FirstVisitTime: '$first_visit_time',
+    SearchKeywordId: '$search_keyword_id',
+    SearchKeywordIdHash: '$search_keyword_id_hash',
+    SearchKeywordIdType: '$search_keyword_id_type',
+    IsFirstDay: '$is_first_day',
+    IsFirstTime: '$is_first_time',
+    // UTM
+    LatestUtmSource: '$latest_utm_source',
+    LatestUtmMedium: '$latest_utm_medium',
+    LatestUtmCampaign: '$latest_utm_campaign',
+    LatestUtmContent: '$latest_utm_content',
+    LatestUtmTerm: '$latest_utm_term',
+    Utms: '$utms',
+    // 身份
+    DistinctId: '$distinct_id',
+    AnonymousId: '$anonymous_id',
+    FirstId: '$first_id',
+    OriginalId: '$original_id',
+    LoginId: '$login_id',
+    IsLoginId: '$is_login_id',
+    IdentityLoginId: '$identity_login_id',
+    IdentityAnonymousId: '$identity_anonymous_id',
+    IdentityCookieId: '$identity_cookie_id',
+    IdentityEmail: '$identity_email',
+    IdentityMobile: '$identity_mobile',
+    // 全埋点元素属性
+    ElementSelector: '$element_selector',
+    ElementPath: '$element_path',
+    ElementType: '$element_type',
+    ElementId: '$element_id',
+    ElementClassName: '$element_class_name',
+    ElementName: '$element_name',
+    ElementContent: '$element_content',
+    ElementTargetUrl: '$element_target_url',
+    ElementPosition: '$element_position',
+    PageX: '$page_x',
+    PageY: '$page_y',
+    // 性能
+    PageHeight: '$page_height',
+    PageResourceSize: '$page_resource_size',
+    EventDuration: '$event_duration',
+    ViewportPosition: '$viewport_position',
+    // 渠道
+    LatestWxAdClickId: '$latest_wx_ad_click_id',
+    LatestWxAdCallbacks: '$latest_wx_ad_callbacks',
+    LatestWxAdHashKey: '$latest_wx_ad_hash_key',
+    IsChannelCallbackEvent: '$is_channel_callback_event',
+    // 会话
+    EventSessionId: '$event_session_id',
+    // 元信息
+    Time: '$time',
+    Event: '$event',
+    Option: '$option',
+    Project: '$project',
+    Token: '$token',
+    // 特殊
+    SignupMethod: '$signup_method',
+};
+
+/**
+ * pageload 插件：performance API 采集首屏加载性能
+ *  - $WebPageLoad 事件，包含：
+ *    $load_time / $dom_ready_time / $dom_interactive_time / $response_time
+ *    $page_resource_size / $page_height / $viewport_position
+ */
+function pageLoad(opts) {
+    if (opts === void 0) { opts = {}; }
+    var sdkRef = null;
+    function fire() {
+        var _a;
+        if (!sdkRef)
+            return;
+        var props = (_a = {},
+            _a[PresetProperty.URLPath] = location.pathname + location.search + location.hash,
+            _a[PresetProperty.Title] = document.title,
+            _a);
+        // 尝试 performance API
+        try {
+            var perf = (typeof performance !== 'undefined' ? performance : null);
+            if (perf) {
+                var nav = perf.getEntriesByType('navigation')[0];
+                if (nav) {
+                    if (typeof nav.domContentLoadedEventEnd === 'number') {
+                        props['$dom_ready_time'] = Math.round(nav.domContentLoadedEventEnd - nav.startTime);
+                    }
+                    if (typeof nav.domInteractive === 'number') {
+                        props['$dom_interactive_time'] = Math.round(nav.domInteractive - nav.startTime);
+                    }
+                    if (typeof nav.loadEventEnd === 'number' && typeof nav.startTime === 'number') {
+                        props['$load_time'] = Math.round(nav.loadEventEnd - nav.startTime);
+                    }
+                    if (typeof nav.responseEnd === 'number' && typeof nav.requestStart === 'number') {
+                        props['$response_time'] = Math.round(nav.responseEnd - nav.requestStart);
+                    }
+                    if (typeof nav.transferSize === 'number') {
+                        props[PresetProperty.PageResourceSize] = nav.transferSize;
+                    }
+                }
+                // paint
+                var fp = perf.getEntriesByName('first-paint')[0];
+                var fcp = perf.getEntriesByName('first-contentful-paint')[0];
+                if (fp)
+                    props['$first_paint'] = Math.round(fp.startTime);
+                if (fcp)
+                    props['$first_contentful_paint'] = Math.round(fcp.startTime);
+            }
+        }
+        catch (_b) {
+            /* ignore */
+        }
+        // 页面尺寸
+        try {
+            if (document.documentElement) {
+                props[PresetProperty.PageHeight] = document.documentElement.scrollHeight;
+                props[PresetProperty.ViewportPosition] = window.scrollY || 0;
+            }
+        }
+        catch (_c) {
+            /* ignore */
+        }
+        sdkRef.track(PresetEvent.WebPageLoad, props);
+    }
+    return {
+        name: 'pageload',
+        install: function (_a) {
+            var sdk = _a.sdk;
+            if (!isBrowser())
+                return;
+            sdkRef = sdk;
+            var fireNow = opts.immediate !== false;
+            if (document.readyState === 'complete') {
+                if (fireNow)
+                    fire();
+                else
+                    window.addEventListener('load', fire, { once: true });
+            }
+            else {
+                window.addEventListener('load', function () {
+                    if (fireNow)
+                        fire();
+                    else
+                        setTimeout(fire, 0);
+                }, { once: true });
+            }
+        },
+    };
+}
+
+exports.pageLoad = pageLoad;

package/dist/plugin/pageload.mjs

@@ -0,0 +1,196 @@
+/**
+ * 浏览器端辅助方法
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+}
+
+/**
+ * SDK 预置事件名与预置属性 key（v1.1：完整对齐神策）
+ * 命名风格对齐神策，方便跨平台对接
+ */
+/** 预置事件名 */
+var PresetEvent = {
+    WebPageLoad: '$WebPageLoad'};
+/** 预置属性 key */
+var PresetProperty = {
+    // 设备 / 环境
+    AppId: '$app_id',
+    AppVersion: '$app_version',
+    Lib: '$lib',
+    LibMethod: '$lib_method',
+    LibDetail: '$lib_detail',
+    LibVersion: '$lib_version',
+    ScreenWidth: '$screen_width',
+    ScreenHeight: '$screen_height',
+    ViewportWidth: '$viewport_width',
+    ViewportHeight: '$viewport_height',
+    TimezoneOffset: '$timezone_offset',
+    UserAgent: '$user_agent',
+    Language: '$language',
+    FirstBrowserCharset: '$first_browser_charset',
+    FirstBrowserLanguage: '$first_browser_language',
+    // 位置 / 流量来源
+    URL: '$url',
+    URLPath: '$url_path',
+    Title: '$title',
+    Referrer: '$referrer',
+    ReferrerHost: '$referrer_host',
+    LatestReferrer: '$latest_referrer',
+    LatestReferrerHost: '$latest_referrer_host',
+    LatestLandingPage: '$latest_landing_page',
+    LatestSearchKeyword: '$latest_search_keyword',
+    LatestTrafficSourceType: '$latest_traffic_source_type',
+    FirstReferrer: '$first_referrer',
+    FirstReferrerHost: '$first_referrer_host',
+    FirstSearchKeyword: '$first_search_keyword',
+    FirstTrafficSourceType: '$first_traffic_source_type',
+    FirstVisitTime: '$first_visit_time',
+    SearchKeywordId: '$search_keyword_id',
+    SearchKeywordIdHash: '$search_keyword_id_hash',
+    SearchKeywordIdType: '$search_keyword_id_type',
+    IsFirstDay: '$is_first_day',
+    IsFirstTime: '$is_first_time',
+    // UTM
+    LatestUtmSource: '$latest_utm_source',
+    LatestUtmMedium: '$latest_utm_medium',
+    LatestUtmCampaign: '$latest_utm_campaign',
+    LatestUtmContent: '$latest_utm_content',
+    LatestUtmTerm: '$latest_utm_term',
+    Utms: '$utms',
+    // 身份
+    DistinctId: '$distinct_id',
+    AnonymousId: '$anonymous_id',
+    FirstId: '$first_id',
+    OriginalId: '$original_id',
+    LoginId: '$login_id',
+    IsLoginId: '$is_login_id',
+    IdentityLoginId: '$identity_login_id',
+    IdentityAnonymousId: '$identity_anonymous_id',
+    IdentityCookieId: '$identity_cookie_id',
+    IdentityEmail: '$identity_email',
+    IdentityMobile: '$identity_mobile',
+    // 全埋点元素属性
+    ElementSelector: '$element_selector',
+    ElementPath: '$element_path',
+    ElementType: '$element_type',
+    ElementId: '$element_id',
+    ElementClassName: '$element_class_name',
+    ElementName: '$element_name',
+    ElementContent: '$element_content',
+    ElementTargetUrl: '$element_target_url',
+    ElementPosition: '$element_position',
+    PageX: '$page_x',
+    PageY: '$page_y',
+    // 性能
+    PageHeight: '$page_height',
+    PageResourceSize: '$page_resource_size',
+    EventDuration: '$event_duration',
+    ViewportPosition: '$viewport_position',
+    // 渠道
+    LatestWxAdClickId: '$latest_wx_ad_click_id',
+    LatestWxAdCallbacks: '$latest_wx_ad_callbacks',
+    LatestWxAdHashKey: '$latest_wx_ad_hash_key',
+    IsChannelCallbackEvent: '$is_channel_callback_event',
+    // 会话
+    EventSessionId: '$event_session_id',
+    // 元信息
+    Time: '$time',
+    Event: '$event',
+    Option: '$option',
+    Project: '$project',
+    Token: '$token',
+    // 特殊
+    SignupMethod: '$signup_method',
+};
+
+/**
+ * pageload 插件：performance API 采集首屏加载性能
+ *  - $WebPageLoad 事件，包含：
+ *    $load_time / $dom_ready_time / $dom_interactive_time / $response_time
+ *    $page_resource_size / $page_height / $viewport_position
+ */
+function pageLoad(opts) {
+    if (opts === void 0) { opts = {}; }
+    var sdkRef = null;
+    function fire() {
+        var _a;
+        if (!sdkRef)
+            return;
+        var props = (_a = {},
+            _a[PresetProperty.URLPath] = location.pathname + location.search + location.hash,
+            _a[PresetProperty.Title] = document.title,
+            _a);
+        // 尝试 performance API
+        try {
+            var perf = (typeof performance !== 'undefined' ? performance : null);
+            if (perf) {
+                var nav = perf.getEntriesByType('navigation')[0];
+                if (nav) {
+                    if (typeof nav.domContentLoadedEventEnd === 'number') {
+                        props['$dom_ready_time'] = Math.round(nav.domContentLoadedEventEnd - nav.startTime);
+                    }
+                    if (typeof nav.domInteractive === 'number') {
+                        props['$dom_interactive_time'] = Math.round(nav.domInteractive - nav.startTime);
+                    }
+                    if (typeof nav.loadEventEnd === 'number' && typeof nav.startTime === 'number') {
+                        props['$load_time'] = Math.round(nav.loadEventEnd - nav.startTime);
+                    }
+                    if (typeof nav.responseEnd === 'number' && typeof nav.requestStart === 'number') {
+                        props['$response_time'] = Math.round(nav.responseEnd - nav.requestStart);
+                    }
+                    if (typeof nav.transferSize === 'number') {
+                        props[PresetProperty.PageResourceSize] = nav.transferSize;
+                    }
+                }
+                // paint
+                var fp = perf.getEntriesByName('first-paint')[0];
+                var fcp = perf.getEntriesByName('first-contentful-paint')[0];
+                if (fp)
+                    props['$first_paint'] = Math.round(fp.startTime);
+                if (fcp)
+                    props['$first_contentful_paint'] = Math.round(fcp.startTime);
+            }
+        }
+        catch (_b) {
+            /* ignore */
+        }
+        // 页面尺寸
+        try {
+            if (document.documentElement) {
+                props[PresetProperty.PageHeight] = document.documentElement.scrollHeight;
+                props[PresetProperty.ViewportPosition] = window.scrollY || 0;
+            }
+        }
+        catch (_c) {
+            /* ignore */
+        }
+        sdkRef.track(PresetEvent.WebPageLoad, props);
+    }
+    return {
+        name: 'pageload',
+        install: function (_a) {
+            var sdk = _a.sdk;
+            if (!isBrowser())
+                return;
+            sdkRef = sdk;
+            var fireNow = opts.immediate !== false;
+            if (document.readyState === 'complete') {
+                if (fireNow)
+                    fire();
+                else
+                    window.addEventListener('load', fire, { once: true });
+            }
+            else {
+                window.addEventListener('load', function () {
+                    if (fireNow)
+                        fire();
+                    else
+                        setTimeout(fire, 0);
+                }, { once: true });
+            }
+        },
+    };
+}
+
+export { pageLoad };