ae-tracking 0.1.0

package/dist/src/client.js

@@ -0,0 +1,56 @@
+import { request, FormData } from 'undici';
+import { Blob } from 'node:buffer';
+export class TEClient {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    url(p) {
+        return this.opts.host.replace(/\/$/, '') + p;
+    }
+    assertOk(env) {
+        if (env.return_code !== 0) {
+            if (env.return_code === -1001) {
+                throw new Error(`AE token expired or invalid (return_code -1001). Re-login in Chrome, then run: ae-tracking auth login`);
+            }
+            throw new Error(env.return_message || `AE error ${env.return_code}`);
+        }
+    }
+    async getProgram(projectId) {
+        const r = await request(this.url(`/v1/ta/bury/manage/program/query?projectId=${encodeURIComponent(String(projectId))}`), {
+            method: 'GET',
+            headers: {
+                authorization: `bearer ${this.opts.token}`,
+                accept: 'application/json',
+            },
+        });
+        const env = (await r.body.json());
+        this.assertOk(env);
+        return env.data ?? null;
+    }
+    async deleteProgram(projectId) {
+        const r = await request(this.url(`/v1/ta/bury/manage/program/delete?projectId=${encodeURIComponent(String(projectId))}`), {
+            method: 'GET',
+            headers: {
+                authorization: `bearer ${this.opts.token}`,
+                accept: 'application/json',
+            },
+        });
+        const env = (await r.body.json());
+        this.assertOk(env);
+        return { return_code: env.return_code, return_message: env.return_message };
+    }
+    async uploadProgramExcel(args) {
+        const fd = new FormData();
+        fd.append('file', new Blob([args.file], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }), args.filename);
+        fd.append('projectId', String(args.projectId));
+        fd.append('access_token', this.opts.token);
+        const r = await request(this.url('/v1/ta/bury/manage/program/excel-save'), {
+            method: 'POST',
+            body: fd,
+        });
+        const env = (await r.body.json());
+        this.assertOk(env);
+        return { return_code: env.return_code, return_message: env.return_message };
+    }
+}

package/dist/src/config.d.ts

@@ -0,0 +1,4 @@
+export declare function getConfigDir(): string;
+export declare function getActiveHost(): string;
+export declare function setActiveHost(host: string): void;
+export declare function extractHostname(url: string): string;

package/dist/src/config.js

@@ -0,0 +1,29 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+export function getConfigDir() {
+    return process.env.AE_TRACKING_HOME || path.join(os.homedir(), '.ae-tracking');
+}
+const CONFIG_FILE = () => path.join(getConfigDir(), 'config.json');
+function load() {
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_FILE(), 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function save(c) {
+    fs.mkdirSync(getConfigDir(), { recursive: true });
+    fs.writeFileSync(CONFIG_FILE(), JSON.stringify(c, null, 2));
+}
+export function getActiveHost() { return load().activeHost ?? ''; }
+export function setActiveHost(host) { const c = load(); c.activeHost = host; save(c); }
+export function extractHostname(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return url;
+    }
+}

package/dist/src/plan/autotrack.d.ts

@@ -0,0 +1,18 @@
+import type { Event, SDKType } from './types.js';
+/**
+ * SDK 自动采集事件定义
+ * 根据 SDK 类型返回对应的自动采集事件数组
+ */
+export declare const PRESET_PROPERTIES: string[];
+/**
+ * 根据 SDK 类型获取对应的自动采集事件
+ */
+export declare function getAutotrackEvents(sdkType: SDKType): Event[];
+/**
+ * SDK 类型显示名称
+ */
+export declare const SDK_TYPE_DISPLAY_NAMES: Record<SDKType, string>;
+/**
+ * 应用类型 → 可选 SDK 类型映射
+ */
+export declare const APP_TYPE_SDK_OPTIONS: Record<string, SDKType[]>;

package/dist/src/plan/autotrack.js

@@ -0,0 +1,350 @@
+/**
+ * SDK 自动采集事件定义
+ * 根据 SDK 类型返回对应的自动采集事件数组
+ */
+// 预置属性列表（由 SDK 自动采集，不需要定义到 event_properties）
+export const PRESET_PROPERTIES = [
+    '#duration',
+    '#resume_from_background',
+    '#screen_name',
+    '#title',
+    '#url',
+    '#referrer',
+    '#url_path',
+    '#element_id',
+    '#element_type',
+    '#element_content',
+    '#element_position',
+    '#element_selector',
+    '#element_name',
+    '#app_crashed_reason',
+    '#scene',
+    '#start_reason',
+    '#background_duration',
+];
+// Android/iOS 自动采集事件
+const nativeAppEvents = [
+    {
+        event_name: 'ta_app_install',
+        display_name: 'APP 安装',
+        event_tag: '系统事件',
+        event_desc: 'APP 首次安装时上报，升级不触发，删除重装会触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_start',
+        display_name: 'APP 启动',
+        event_tag: '系统事件',
+        event_desc: '用户开启 APP 或从后台唤醒时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_end',
+        display_name: 'APP 关闭',
+        event_tag: '系统事件',
+        event_desc: '用户关闭 APP 或将 APP 调至后台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_view',
+        display_name: 'APP 页面浏览',
+        event_tag: '系统事件',
+        event_desc: '用户浏览页面（Activity/ViewController）时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_click',
+        display_name: 'APP 控件点击',
+        event_tag: '系统事件',
+        event_desc: '用户点击控件时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_crash',
+        display_name: 'APP 崩溃',
+        event_tag: '系统事件',
+        event_desc: 'APP 出现未捕获异常时上报',
+        source: 'autotrack',
+        prop_names: [],
+    },
+];
+// JavaScript (Web/H5) 自动采集事件
+const jsEvents = [
+    {
+        event_name: 'ta_pageview',
+        display_name: '页面浏览',
+        event_tag: '系统事件',
+        event_desc: '调用 ta.quick("autoTrack") 时上报',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_page_show',
+        display_name: '页面显示',
+        event_tag: '系统事件',
+        event_desc: '页面显示时触发（需开启配置）',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_page_hide',
+        display_name: '页面隐藏',
+        event_tag: '系统事件',
+        event_desc: '页面隐藏时触发（需开启配置）',
+        source: 'autotrack',
+        prop_names: [],
+    },
+];
+// 微信小程序自动采集事件
+const wechatMpEvents = [
+    {
+        event_name: 'ta_mp_launch',
+        display_name: '小程序初始化',
+        event_tag: '系统事件',
+        event_desc: '小程序被首次打开时触发，进程生命周期内只触发一次',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mp_show',
+        display_name: '小程序启动',
+        event_tag: '系统事件',
+        event_desc: '小程序被启动或从后台调回前台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mp_hide',
+        display_name: '小程序隐藏',
+        event_tag: '系统事件',
+        event_desc: '小程序被调入后台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mp_view',
+        display_name: '小程序页面浏览',
+        event_tag: '系统事件',
+        event_desc: '页面被打开或从后台调回前台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mp_share',
+        display_name: '小程序转发分享',
+        event_tag: '系统事件',
+        event_desc: '转发按钮被点击时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_page_leave',
+        display_name: '小程序页面卸载',
+        event_tag: '系统事件',
+        event_desc: '页面卸载时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_add_favorite',
+        display_name: '小程序页面收藏',
+        event_tag: '系统事件',
+        event_desc: '页面被收藏时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mp_click',
+        display_name: '小程序元素点击',
+        event_tag: '系统事件',
+        event_desc: '页面元素被点击时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+];
+// 微信小游戏自动采集事件（精简版）
+const wechatMgEvents = [
+    {
+        event_name: 'ta_mp_launch',
+        display_name: '小游戏初始化',
+        event_tag: '系统事件',
+        event_desc: '小游戏被首次打开时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mp_show',
+        display_name: '小游戏启动',
+        event_tag: '系统事件',
+        event_desc: '小游戏被启动或从后台调回前台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mp_hide',
+        display_name: '小游戏隐藏',
+        event_tag: '系统事件',
+        event_desc: '小游戏被调入后台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+];
+// Unity 自动采集事件
+const unityEvents = [
+    {
+        event_name: 'ta_app_install',
+        display_name: 'APP 安装',
+        event_tag: '系统事件',
+        event_desc: '首次安装后打开时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_start',
+        display_name: 'APP 启动',
+        event_tag: '系统事件',
+        event_desc: '游戏进入前台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_end',
+        display_name: 'APP 关闭',
+        event_tag: '系统事件',
+        event_desc: '游戏进入后台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+];
+// Unity 微信小游戏自动采集事件
+const unityWxmgEvents = [
+    {
+        event_name: 'ta_mg_launch',
+        display_name: '小游戏初始化',
+        event_tag: '系统事件',
+        event_desc: '小游戏首次打开时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mg_show',
+        display_name: '小游戏启动',
+        event_tag: '系统事件',
+        event_desc: '小游戏进入前台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_mg_hide',
+        display_name: '小游戏隐藏',
+        event_tag: '系统事件',
+        event_desc: '小游戏进入后台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+];
+// 其他游戏引擎（Cocos2d-x, CocosCreator, LayaAir, Unreal）自动采集事件
+const gameEngineEvents = [
+    {
+        event_name: 'ta_app_install',
+        display_name: 'APP 安装',
+        event_tag: '系统事件',
+        event_desc: '首次安装时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_start',
+        display_name: 'APP 启动',
+        event_tag: '系统事件',
+        event_desc: '游戏进入前台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+    {
+        event_name: 'ta_app_end',
+        display_name: 'APP 关闭',
+        event_tag: '系统事件',
+        event_desc: '游戏进入后台时触发',
+        source: 'autotrack',
+        prop_names: [],
+    },
+];
+/**
+ * 根据 SDK 类型获取对应的自动采集事件
+ */
+export function getAutotrackEvents(sdkType) {
+    switch (sdkType) {
+        case 'android':
+        case 'ios':
+        case 'react_native':
+        case 'flutter':
+        case 'uniapp_app':
+            return nativeAppEvents;
+        case 'javascript':
+        case 'uniapp_h5':
+            return jsEvents;
+        case 'wechat_mp':
+        case 'douyin_mp':
+        case 'alipay_mp':
+        case 'other_mp':
+        case 'uniapp_mp':
+            return wechatMpEvents;
+        case 'wechat_mg':
+            return wechatMgEvents;
+        case 'unity':
+            return unityEvents;
+        case 'unity_wxmg':
+            return unityWxmgEvents;
+        case 'cocos2dx':
+        case 'cocoscreator':
+        case 'layaair':
+        case 'unreal':
+            return gameEngineEvents;
+        default:
+            return [];
+    }
+}
+/**
+ * SDK 类型显示名称
+ */
+export const SDK_TYPE_DISPLAY_NAMES = {
+    android: 'Android SDK',
+    ios: 'iOS SDK',
+    openharmony: 'OpenHarmony SDK',
+    javascript: 'JavaScript SDK',
+    wechat_mp: '微信小程序 SDK',
+    wechat_mg: '微信小游戏 SDK',
+    douyin_mp: '抖音小程序 SDK',
+    alipay_mp: '支付宝小程序 SDK',
+    other_mp: '其他小程序 SDK',
+    unity: 'Unity SDK',
+    unity_wxmg: 'Unity 微信小游戏',
+    cocos2dx: 'Cocos2d-x SDK',
+    cocoscreator: 'CocosCreator SDK',
+    layaair: 'LayaAir SDK',
+    unreal: 'Unreal SDK',
+    react_native: 'React Native SDK',
+    flutter: 'Flutter SDK',
+    uniapp_mp: 'uni-app 小程序端',
+    uniapp_app: 'uni-app APP端',
+    uniapp_h5: 'uni-app H5端',
+};
+/**
+ * 应用类型 → 可选 SDK 类型映射
+ */
+export const APP_TYPE_SDK_OPTIONS = {
+    'Android': ['android'],
+    'iOS': ['ios'],
+    'H5': ['javascript'],
+    'Web': ['javascript'],
+    '小程序': ['wechat_mp', 'wechat_mg', 'douyin_mp', 'alipay_mp', 'other_mp'],
+    'Unity': ['unity', 'unity_wxmg'],
+    '游戏引擎': ['cocos2dx', 'cocoscreator', 'layaair', 'unreal'],
+    '跨平台': ['react_native', 'flutter', 'uniapp_mp', 'uniapp_app', 'uniapp_h5'],
+};

package/dist/src/plan/conflict.d.ts

@@ -0,0 +1,34 @@
+import type { Draft } from './types.js';
+/**
+ * 冲突检测
+ * 在追加模式下，对比新方案与既有方案，检测两类冲突：
+ * - A: 同名属性类型不一致（严重）
+ * - B: 同名事件已存在（提醒）
+ */
+export interface Conflict {
+    type: 'property_type_conflict' | 'event_exists';
+    severity: 'error' | 'warning';
+    name: string;
+    existingType?: string;
+    newType?: string;
+    existingPropCount?: number;
+    newPropCount?: number;
+}
+export interface ConflictResult {
+    hasErrors: boolean;
+    hasWarnings: boolean;
+    conflicts: Conflict[];
+}
+/**
+ * 检测新方案与既有方案的冲突
+ */
+export declare function detectConflicts(newDraft: Draft, existingDraft: Draft): ConflictResult;
+/**
+ * 格式化冲突报告（用于 CLI 输出）
+ */
+export declare function formatConflictReport(result: ConflictResult, existingSummary: {
+    events: number;
+    eventProps: number;
+    commonProps: number;
+    userProps: number;
+}): string;

package/dist/src/plan/conflict.js

@@ -0,0 +1,106 @@
+/**
+ * 检测新方案与既有方案的冲突
+ */
+export function detectConflicts(newDraft, existingDraft) {
+    const conflicts = [];
+    // 冲突类型 A：同名属性类型不一致
+    // 检查三个属性池：event_properties, common_event_properties, user_properties
+    // event_properties
+    for (const newProp of newDraft.event_properties) {
+        const existingProp = existingDraft.event_properties.find(p => p.name === newProp.name);
+        if (existingProp && existingProp.type !== newProp.type) {
+            conflicts.push({
+                type: 'property_type_conflict',
+                severity: 'error',
+                name: newProp.name,
+                existingType: existingProp.type,
+                newType: newProp.type,
+            });
+        }
+    }
+    // common_event_properties
+    for (const newProp of newDraft.common_event_properties) {
+        const existingProp = existingDraft.common_event_properties.find(p => p.name === newProp.name);
+        if (existingProp && existingProp.type !== newProp.type) {
+            conflicts.push({
+                type: 'property_type_conflict',
+                severity: 'error',
+                name: newProp.name,
+                existingType: existingProp.type,
+                newType: newProp.type,
+            });
+        }
+    }
+    // user_properties
+    for (const newProp of newDraft.user_properties) {
+        const existingProp = existingDraft.user_properties.find(p => p.name === newProp.name);
+        if (existingProp && existingProp.type !== newProp.type) {
+            conflicts.push({
+                type: 'property_type_conflict',
+                severity: 'error',
+                name: newProp.name,
+                existingType: existingProp.type,
+                newType: newProp.type,
+            });
+        }
+    }
+    // 冲突类型 B：同名事件已存在
+    for (const newEvent of newDraft.events) {
+        const existingEvent = existingDraft.events.find(e => e.event_name === newEvent.event_name);
+        if (existingEvent) {
+            conflicts.push({
+                type: 'event_exists',
+                severity: 'warning',
+                name: newEvent.event_name,
+                existingPropCount: existingEvent.prop_names.length,
+                newPropCount: newEvent.prop_names.length,
+            });
+        }
+    }
+    return {
+        hasErrors: conflicts.some(c => c.severity === 'error'),
+        hasWarnings: conflicts.some(c => c.severity === 'warning'),
+        conflicts,
+    };
+}
+/**
+ * 格式化冲突报告（用于 CLI 输出）
+ */
+export function formatConflictReport(result, existingSummary) {
+    const lines = [];
+    lines.push('项目已有埋点方案：');
+    lines.push(`- 事件数：${existingSummary.events}`);
+    lines.push(`- 事件属性数：${existingSummary.eventProps}`);
+    lines.push(`- 公共属性数：${existingSummary.commonProps}`);
+    lines.push(`- 用户属性数：${existingSummary.userProps}`);
+    lines.push('');
+    if (result.hasErrors) {
+        lines.push('⚠️ 严重冲突：同名属性类型不一致');
+        lines.push('');
+        lines.push('以下属性在既有方案和新方案中类型不同，');
+        lines.push('追加上传会导致上报数据被抛弃：');
+        lines.push('');
+        lines.push('| 属性名 | 既有类型 | 新方案类型 |');
+        lines.push('|---|---|---|');
+        for (const c of result.conflicts.filter(c => c.type === 'property_type_conflict')) {
+            lines.push(`| ${c.name} | ${c.existingType} | ${c.newType} |`);
+        }
+        lines.push('');
+        lines.push('建议：');
+        lines.push('1. 修改新方案的属性类型，与既有方案一致');
+        lines.push('2. 或选择「替换」模式重新定义类型');
+    }
+    if (result.hasWarnings && !result.hasErrors) {
+        lines.push('⚠️ 提醒：以下事件已存在于项目中（追加模式不会覆盖）');
+        lines.push('');
+        for (const c of result.conflicts.filter(c => c.type === 'event_exists')) {
+            lines.push(`- ${c.name}（既有：${c.existingPropCount} 属性，新方案：${c.newPropCount} 属性）`);
+        }
+        lines.push('');
+        lines.push('追加后：');
+        lines.push('- 既有事件的属性关联不会改变');
+        lines.push('- 既有事件的新属性不会被添加');
+        lines.push('- 新事件会正常添加');
+    }
+    return lines.join('\n');
+}

package/dist/src/plan/draft.d.ts

@@ -0,0 +1,39 @@
+import type { Draft, Event, SDKType, SDKIntegrationMode, ServerLanguage, ClientLanguage, UserIdentity } from './types.js';
+export interface DraftMeta {
+    app_type: string;
+    sdk_integration_mode: SDKIntegrationMode;
+    client_platforms?: SDKType[];
+    client_sdk_type?: SDKType;
+    client_languages?: ClientLanguage[];
+    client_platform_languages?: Record<SDKType, ClientLanguage[]>;
+    server_language?: ServerLanguage;
+    project_id?: number;
+    plan_name: string;
+    scenario?: string;
+    user_identity?: UserIdentity;
+}
+export declare function emptyDraft(meta: DraftMeta): Draft;
+export declare function emptyDraftLegacy(appType: string, planName: string, sdkType?: SDKType): Draft;
+export declare function loadDraft(p: string): Draft;
+export declare function saveDraft(d: Draft, p: string): void;
+/**
+ * 向 draft 注入 SDK 自动采集事件
+ * 自动采集事件放在 events 数组末尾，标记 source: "autotrack", platform: "client"
+ */
+export declare function injectAutotrackEvents(draft: Draft): Draft;
+/**
+ * 获取 draft 中的业务事件（排除自动采集事件）
+ */
+export declare function getBusinessEvents(draft: Draft): Event[];
+/**
+ * 获取 draft 中的自动采集事件
+ */
+export declare function getAutotrackEventsFromDraft(draft: Draft): Event[];
+/**
+ * 按 platform 分组获取事件
+ */
+export declare function getEventsByPlatform(draft: Draft): {
+    client: Event[];
+    server: Event[];
+    both: Event[];
+};