Genarrative/apps/ai-game-creator-shell/src/services/clientAnalytics.ts

import type { TauriInvoke } from '../app/types';

// 宿主签发的无凭据上下文：前端只传回原值，不从当前登录态补身份。
type AnalyticsContext = {
  route: { user_id: string | null; destination_origin: string | null };
  editor_session_id: string;
  client_version: string;
};

export type ProjectOpenAnalytics = ReturnType<typeof beginProjectOpenAnalytics>;

export function beginProjectOpenAnalytics(
  invoke: TauriInvoke,
  openSource: 'create' | 'picker' | 'recent',
) {
  try {
    const operationId = crypto.randomUUID();
    const context = invoke<AnalyticsContext | null>(
      'capture_analytics_context',
    ).catch(() => null);
    let recorded = false;
    return {
      record(projectPath: string) {
        if (recorded) return;
        recorded = true;
        const eventTime = new Date().toISOString();
        void context
          .then((captured) => {
            if (!captured) return;
            return invoke('record_analytics_project_open', {
              context: captured,
              projectPath,
              operationId,
              openSource,
              eventTime,
            });
          })
          .catch(() => undefined);
      },
    };
  } catch {
    // UUID、桥接与写入失败都不能改变业务操作结果。
    return null;
  }
}

export function recordAnalyticsProjectLeave(
  invoke: TauriInvoke,
  projectPath: string,
) {
  try {
    void invoke('record_analytics_project_leave', { projectPath }).catch(
      () => undefined,
    );
  } catch {
    // 离开项目不能等待或依赖埋点。
  }
}

// 保存开始冻结身份，完成时冻结时间；观察器不能影响保存结果。
export function beginUiSaveAnalytics(
  invoke: TauriInvoke,
  projectPath: string,
  saveSource: 'manual' | 'auto',
) {
  try {
    const operationId = crypto.randomUUID();
    const context = invoke<AnalyticsContext | null>(
      'capture_analytics_context',
    ).catch(() => null);
    let recorded = false;
    return {
      record(changed: boolean) {
        if (recorded) return;
        recorded = true;
        if (saveSource === 'auto' && !changed) return;
        try {
          const eventTime = new Date().toISOString();
          void context
            .then((captured) => {
              if (!captured) return;
              return invoke('record_analytics_ui_save', {
                context: captured,
                projectPath,
                operationId,
                saveSource,
                changed,
                eventTime,
              });
            })
            .catch(() => undefined);
        } catch {
          // 时间或桥接失败仅丢弃本条埋点。
        }
      },
    };
  } catch {
    return null;
  }
}