@quantabit/funnel-sdk 1.0.0

package/dist/index.cjs

@@ -0,0 +1,1325 @@
+'use strict';
+
+var sdkConfig = require('@quantabit/sdk-config');
+var React = require('react');
+
+/**
+ * Funnel SDK - API 客户端 (隐私合规增强版)
+ * 漏斗分析系统后端接口封装
+ *
+ * 隐私保护:
+ * - 漏斗步骤追踪需要 analytics 同意
+ * - 用户掉漏数据自动脱敏
+ * - 分析报告导出支持匿名化
+ *
+ * 使用 BaseApiClient 基类简化代码
+ */
+
+
+// 可选依赖：隐私合规工具
+let consentManager = null;
+import('@quantabit/sdk-config').then(sdkConfig => {
+  consentManager = sdkConfig.consentManager;
+}).catch(() => {
+  /* 静默降级 */
+});
+
+/**
+ * 漏斗 API 客户端
+ */
+class FunnelApiClient extends sdkConfig.BaseApiClient {
+  constructor(config = {}) {
+    super("/funnel", config);
+  }
+
+  // ============ 漏斗管理 ============
+
+  /**
+   * 获取漏斗列表
+   * @param {Object} params - 查询参数
+   */
+  async getFunnels(params = {}) {
+    return this.get("/list", params);
+  }
+
+  /**
+   * 获取漏斗详情
+   * @param {string} funnelId - 漏斗 ID
+   */
+  async getFunnel(funnelId) {
+    return this.get(`/${funnelId}`);
+  }
+
+  /**
+   * 创建漏斗
+   * @param {Object} data - 漏斗数据
+   */
+  async createFunnel(data) {
+    return this.post("/", data);
+  }
+
+  /**
+   * 更新漏斗
+   * @param {string} funnelId - 漏斗 ID
+   * @param {Object} updates - 更新数据
+   */
+  async updateFunnel(funnelId, updates) {
+    return this.put(`/${funnelId}`, updates);
+  }
+
+  /**
+   * 删除漏斗
+   * @param {string} funnelId - 漏斗 ID
+   */
+  async deleteFunnel(funnelId) {
+    return this.delete(`/${funnelId}`);
+  }
+
+  /**
+   * 复制漏斗
+   * @param {string} funnelId - 漏斗 ID
+   * @param {string} name - 新名称
+   */
+  async duplicateFunnel(funnelId, name) {
+    return this.post(`/${funnelId}/duplicate`, {
+      name
+    });
+  }
+
+  // ============ 漏斗分析 ============
+
+  /**
+   * 获取漏斗分析
+   * @param {string} funnelId - 漏斗 ID
+   * @param {Object} params - 分析参数
+   */
+  async analyze(funnelId, params = {}) {
+    // 分析功能需要 analytics 同意
+    if (consentManager && !consentManager.hasConsent("analytics")) {
+      console.debug("[Funnel] 漏斗分析被跳过（需要 analytics 同意）");
+      return {
+        code: -1,
+        message: "consent_required"
+      };
+    }
+    return this.post(`/${funnelId}/analyze`, params);
+  }
+
+  /**
+   * 获取步骤转化率
+   * @param {string} funnelId - 漏斗 ID
+   * @param {Object} params - 查询参数
+   */
+  async getConversionRate(funnelId, params = {}) {
+    return this.get(`/${funnelId}/conversion`, params);
+  }
+
+  /**
+   * 获取趋势数据
+   * @param {string} funnelId - 漏斗 ID
+   * @param {Object} params - 查询参数
+   */
+  async getTrend(funnelId, params = {}) {
+    return this.get(`/${funnelId}/trend`, params);
+  }
+
+  /**
+   * 获取对比分析
+   * @param {string} funnelId - 漏斗 ID
+   * @param {Object} params - 对比参数
+   */
+  async compare(funnelId, params = {}) {
+    return this.post(`/${funnelId}/compare`, params);
+  }
+
+  // ============ 掉漏分析 ============
+
+  /**
+   * 获取掉漏用户
+   * @param {string} funnelId - 漏斗 ID
+   * @param {number} stepIndex - 步骤索引
+   * @param {Object} params - 查询参数
+   */
+  async getDropoffUsers(funnelId, stepIndex, params = {}) {
+    return this.get(`/${funnelId}/dropoff/${stepIndex}/users`, params);
+  }
+
+  /**
+   * 获取掉漏原因分析
+   * @param {string} funnelId - 漏斗 ID
+   * @param {number} stepIndex - 步骤索引
+   */
+  async getDropoffReasons(funnelId, stepIndex) {
+    return this.get(`/${funnelId}/dropoff/${stepIndex}/reasons`);
+  }
+
+  /**
+   * 获取掉漏用户画像
+   * @param {string} funnelId - 漏斗 ID
+   * @param {number} stepIndex - 步骤索引
+   */
+  async getDropoffProfile(funnelId, stepIndex) {
+    return this.get(`/${funnelId}/dropoff/${stepIndex}/profile`);
+  }
+
+  // ============ 路径分析 ============
+
+  /**
+   * 获取转化路径
+   * @param {string} funnelId - 漏斗 ID
+   * @param {Object} params - 查询参数
+   */
+  async getConversionPaths(funnelId, params = {}) {
+    return this.get(`/${funnelId}/paths`, params);
+  }
+
+  /**
+   * 获取异常路径
+   * @param {string} funnelId - 漏斗 ID
+   */
+  async getAbnormalPaths(funnelId) {
+    return this.get(`/${funnelId}/paths/abnormal`);
+  }
+
+  // ============ 分组分析 ============
+
+  /**
+   * 按属性分组分析
+   * @param {string} funnelId - 漏斗 ID
+   * @param {string} property - 分组属性
+   * @param {Object} params - 分析参数
+   */
+  async analyzeByProperty(funnelId, property, params = {}) {
+    return this.post(`/${funnelId}/analyze/group`, {
+      property,
+      ...params
+    });
+  }
+
+  /**
+   * 按人群分组分析
+   * @param {string} funnelId - 漏斗 ID
+   * @param {string[]} segmentIds - 分群 ID 列表
+   * @param {Object} params - 分析参数
+   */
+  async analyzeBySegments(funnelId, segmentIds, params = {}) {
+    return this.post(`/${funnelId}/analyze/segments`, {
+      segment_ids: segmentIds,
+      ...params
+    });
+  }
+
+  // ============ 导出 ============
+
+  /**
+   * 导出分析报告
+   * @param {string} funnelId - 漏斗 ID
+   * @param {Object} options - 导出选项
+   */
+  async exportReport(funnelId, options = {}) {
+    return this.post(`/${funnelId}/export`, options);
+  }
+
+  // ============ 隐私合规扩展 ============
+
+  /**
+   * 漏斗步骤追踪 — 需要 analytics 同意
+   * 识别用户进入了漏斗的哪个步骤
+   * @param {string} funnelId - 漏斗 ID
+   * @param {number} stepIndex - 步骤索引
+   * @param {object} metadata - 额外元数据
+   */
+  async trackStep(funnelId, stepIndex, metadata = {}) {
+    if (consentManager && !consentManager.hasConsent("analytics")) {
+      return {
+        code: -1,
+        message: "consent_required"
+      };
+    }
+    return this.post(`/${funnelId}/steps/${stepIndex}/track`, metadata);
+  }
+
+  /**
+   * 获取掉漏用户(匿名化) — 降低 PII 暴露风险
+   * @param {string} funnelId
+   * @param {number} stepIndex
+   * @param {object} params
+   */
+  async getDropoffUsersAnonymized(funnelId, stepIndex, params = {}) {
+    const result = await this.getDropoffUsers(funnelId, stepIndex, params);
+    if (result?.data?.users) {
+      result.data.users = result.data.users.map(u => ({
+        ...u,
+        user_id: u.user_id ? `user_${u.user_id.toString().slice(-4)}` : "anon",
+        email: u.email ? "***@***" : undefined,
+        did: u.did ? `${u.did.slice(0, 8)}...` : undefined
+      }));
+    }
+    return result;
+  }
+
+  /**
+   * 获取隐私数据声明
+   */
+  getDataDisclosure() {
+    return {
+      sdk: "@quantabit/funnel-sdk",
+      privacyLevel: "analytics",
+      consentRequired: true,
+      collected: [{
+        type: "funnel_steps",
+        description: "Which funnel steps users reach",
+        retention: "90 days"
+      }, {
+        type: "conversion_rate",
+        description: "Aggregated conversion metrics",
+        retention: "1 year"
+      }, {
+        type: "dropoff_reasons",
+        description: "Why users abandon funnels",
+        retention: "90 days"
+      }],
+      gdprCapabilities: ["delete", "anonymize"],
+      anonymization: "User identifiers are hashed in reports; getDropoffUsersAnonymized() strips PII"
+    };
+  }
+
+  /**
+   * 清除用户漏斗追踪数据 — GDPR Art.17
+   */
+  async clearData() {
+    try {
+      return await this.post("/privacy/clear-my-data");
+    } catch (e) {
+      return {
+        success: true,
+        note: "Funnel data is aggregated; individual records anonymized"
+      };
+    }
+  }
+}
+
+// 创建默认实例
+const funnelApi = new FunnelApiClient();
+
+/**
+ * Funnel SDK - 类型定义
+ */
+
+// 漏斗类型
+const FunnelType = {
+  REGISTRATION: 'registration',
+  PURCHASE: 'purchase',
+  ONBOARDING: 'onboarding',
+  ACTIVATION: 'activation',
+  CUSTOM: 'custom'
+};
+
+// 步骤状态
+const StepStatus = {
+  NOT_STARTED: 'not_started',
+  IN_PROGRESS: 'in_progress',
+  COMPLETED: 'completed',
+  DROPPED: 'dropped'
+};
+
+// 时间窗口
+const TimeWindow = {
+  SESSION: 'session',
+  DAY: 'day',
+  WEEK: 'week',
+  MONTH: 'month',
+  UNLIMITED: 'unlimited'
+};
+
+/**
+ * Funnel SDK - 国际化
+ * 转化漏斗分析多语言支持
+ */
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  zh: {
+    // 漏斗基础
+    funnel: '转化漏斗',
+    funnels: '漏斗列表',
+    createFunnel: '创建漏斗',
+    editFunnel: '编辑漏斗',
+    deleteFunnel: '删除漏斗',
+    funnelName: '漏斗名称',
+    funnelDesc: '漏斗描述',
+    // 步骤
+    step: '步骤',
+    steps: '步骤',
+    addStep: '添加步骤',
+    removeStep: '移除步骤',
+    stepName: '步骤名称',
+    stepEvent: '步骤事件',
+    firstStep: '第一步',
+    lastStep: '最后一步',
+    // 转化指标
+    conversion: '转化',
+    conversionRate: '转化率',
+    dropOff: '流失',
+    dropOffRate: '流失率',
+    completed: '完成',
+    abandoned: '放弃',
+    // 时间
+    timeWindow: '时间窗口',
+    hour: '小时',
+    day: '天',
+    week: '周',
+    month: '月',
+    averageTime: '平均耗时',
+    medianTime: '中位耗时',
+    // 分析
+    analyze: '分析',
+    analysis: '漏斗分析',
+    comparison: '对比分析',
+    trends: '趋势分析',
+    breakdown: '细分分析',
+    // 维度
+    dimension: '维度',
+    byChannel: '按渠道',
+    byDevice: '按设备',
+    byRegion: '按地区',
+    bySegment: '按分群',
+    // 统计
+    totalUsers: '总用户数',
+    completedUsers: '完成用户',
+    lostUsers: '流失用户',
+    overall: '总体转化',
+    stepByStep: '逐步转化',
+    // 建议
+    insights: '洞察',
+    recommendations: '优化建议',
+    bottleneck: '瓶颈点',
+    improvement: '提升空间',
+    // 操作
+    save: '保存',
+    cancel: '取消',
+    export: '导出',
+    refresh: '刷新',
+    // 状态
+    loading: '加载中...',
+    noData: '暂无数据',
+    error: '加载失败',
+    // 图表
+    chart: '图表',
+    bar: '柱状图',
+    line: '折线图',
+    table: '表格'
+  },
+  en: {
+    funnel: 'Funnel',
+    funnels: 'Funnels',
+    createFunnel: 'Create Funnel',
+    editFunnel: 'Edit Funnel',
+    deleteFunnel: 'Delete Funnel',
+    funnelName: 'Funnel Name',
+    funnelDesc: 'Description',
+    step: 'Step',
+    steps: 'Steps',
+    addStep: 'Add Step',
+    removeStep: 'Remove Step',
+    stepName: 'Step Name',
+    stepEvent: 'Event',
+    firstStep: 'First Step',
+    lastStep: 'Last Step',
+    conversion: 'Conversion',
+    conversionRate: 'Conversion Rate',
+    dropOff: 'Drop-off',
+    dropOffRate: 'Drop-off Rate',
+    completed: 'Completed',
+    abandoned: 'Abandoned',
+    timeWindow: 'Time Window',
+    hour: 'Hour',
+    day: 'Day',
+    week: 'Week',
+    month: 'Month',
+    averageTime: 'Avg. Time',
+    medianTime: 'Median Time',
+    analyze: 'Analyze',
+    analysis: 'Funnel Analysis',
+    comparison: 'Comparison',
+    trends: 'Trends',
+    breakdown: 'Breakdown',
+    dimension: 'Dimension',
+    byChannel: 'By Channel',
+    byDevice: 'By Device',
+    byRegion: 'By Region',
+    bySegment: 'By Segment',
+    totalUsers: 'Total Users',
+    completedUsers: 'Completed',
+    lostUsers: 'Lost',
+    overall: 'Overall',
+    stepByStep: 'Step by Step',
+    insights: 'Insights',
+    recommendations: 'Recommendations',
+    bottleneck: 'Bottleneck',
+    improvement: 'Improvement',
+    save: 'Save',
+    cancel: 'Cancel',
+    export: 'Export',
+    refresh: 'Refresh',
+    loading: 'Loading...',
+    noData: 'No Data',
+    error: 'Error',
+    chart: 'Chart',
+    bar: 'Bar',
+    line: 'Line',
+    table: 'Table'
+  },
+  ja: {
+    funnel: 'ファネル',
+    funnels: 'ファネル一覧',
+    createFunnel: 'ファネル作成',
+    editFunnel: 'ファネル編集',
+    deleteFunnel: 'ファネル削除',
+    funnelName: 'ファネル名',
+    funnelDesc: '説明',
+    step: 'ステップ',
+    steps: 'ステップ',
+    addStep: 'ステップ追加',
+    removeStep: 'ステップ削除',
+    stepName: 'ステップ名',
+    stepEvent: 'イベント',
+    firstStep: '最初のステップ',
+    lastStep: '最後のステップ',
+    conversion: 'コンバージョン',
+    conversionRate: 'コンバージョン率',
+    dropOff: '離脱',
+    dropOffRate: '離脱率',
+    completed: '完了',
+    abandoned: '離脱',
+    timeWindow: '時間範囲',
+    hour: '時間',
+    day: '日',
+    week: '週',
+    month: '月',
+    averageTime: '平均時間',
+    medianTime: '中央値',
+    analyze: '分析',
+    analysis: 'ファネル分析',
+    comparison: '比較分析',
+    trends: 'トレンド',
+    breakdown: '内訳',
+    dimension: 'ディメンション',
+    byChannel: 'チャネル別',
+    byDevice: 'デバイス別',
+    byRegion: '地域別',
+    bySegment: 'セグメント別',
+    totalUsers: '総ユーザー数',
+    completedUsers: '完了ユーザー',
+    lostUsers: '離脱ユーザー',
+    overall: '全体',
+    stepByStep: 'ステップ別',
+    insights: 'インサイト',
+    recommendations: '改善提案',
+    bottleneck: 'ボトルネック',
+    improvement: '改善余地',
+    save: '保存',
+    cancel: 'キャンセル',
+    export: 'エクスポート',
+    refresh: '更新',
+    loading: '読み込み中...',
+    noData: 'データなし',
+    error: 'エラー',
+    chart: 'チャート',
+    bar: '棒グラフ',
+    line: '折れ線グラフ',
+    table: 'テーブル'
+  },
+  ko: {
+    funnel: '퍼널',
+    funnels: '퍼널 목록',
+    createFunnel: '퍼널 생성',
+    editFunnel: '퍼널 편집',
+    deleteFunnel: '퍼널 삭제',
+    funnelName: '퍼널 이름',
+    funnelDesc: '설명',
+    step: '단계',
+    steps: '단계',
+    addStep: '단계 추가',
+    removeStep: '단계 제거',
+    stepName: '단계 이름',
+    stepEvent: '이벤트',
+    firstStep: '첫 번째 단계',
+    lastStep: '마지막 단계',
+    conversion: '전환',
+    conversionRate: '전환율',
+    dropOff: '이탈',
+    dropOffRate: '이탈률',
+    completed: '완료',
+    abandoned: '이탈',
+    timeWindow: '시간 범위',
+    hour: '시간',
+    day: '일',
+    week: '주',
+    month: '월',
+    averageTime: '평균 시간',
+    medianTime: '중앙값',
+    analyze: '분석',
+    analysis: '퍼널 분석',
+    comparison: '비교 분석',
+    trends: '트렌드',
+    breakdown: '세부 분석',
+    dimension: '차원',
+    byChannel: '채널별',
+    byDevice: '기기별',
+    byRegion: '지역별',
+    bySegment: '세그먼트별',
+    totalUsers: '총 사용자',
+    completedUsers: '완료 사용자',
+    lostUsers: '이탈 사용자',
+    overall: '전체',
+    stepByStep: '단계별',
+    insights: '인사이트',
+    recommendations: '권장 사항',
+    bottleneck: '병목 지점',
+    improvement: '개선 여지',
+    save: '저장',
+    cancel: '취소',
+    export: '내보내기',
+    refresh: '새로고침',
+    loading: '로딩 중...',
+    noData: '데이터 없음',
+    error: '오류',
+    chart: '차트',
+    bar: '막대 차트',
+    line: '선 차트',
+    table: '테이블'
+  }
+};
+let currentLanguage = 'zh';
+function setLanguage(lang) {
+  if (SUPPORTED_LANGUAGES.includes(lang)) currentLanguage = lang;
+}
+function getLanguage() {
+  return currentLanguage;
+}
+function t(key) {
+  return (messages[currentLanguage] || messages.en)[key] || key;
+}
+
+/**
+ * Funnel SDK - React Hooks
+ * 转化漏斗分析相关的状态管理
+ */
+
+
+/**
+ * 获取漏斗列表
+ */
+function useFunnels(params = {}) {
+  const [funnels, setFunnels] = React.useState([]);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const fetchFunnels = React.useCallback(async () => {
+    try {
+      setLoading(true);
+      const response = await funnelApi.getFunnels(params);
+      setFunnels(response.data || []);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [params]);
+  React.useEffect(() => {
+    fetchFunnels();
+  }, []);
+  return {
+    funnels,
+    loading,
+    error,
+    refresh: fetchFunnels
+  };
+}
+
+/**
+ * 获取单个漏斗详情
+ */
+function useFunnel(funnelId) {
+  const [funnel, setFunnel] = React.useState(null);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const fetchFunnel = React.useCallback(async () => {
+    if (!funnelId) return;
+    try {
+      setLoading(true);
+      const response = await funnelApi.getFunnel(funnelId);
+      setFunnel(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [funnelId]);
+  React.useEffect(() => {
+    fetchFunnel();
+  }, [fetchFunnel]);
+  return {
+    funnel,
+    loading,
+    error,
+    refresh: fetchFunnel
+  };
+}
+
+/**
+ * 漏斗分析
+ */
+function useFunnelAnalysis(funnelId, options = {}) {
+  const [analysis, setAnalysis] = React.useState(null);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const {
+    timeWindow = '7d',
+    dimension = null,
+    segment = null
+  } = options;
+  const analyze = React.useCallback(async () => {
+    if (!funnelId) return;
+    try {
+      setLoading(true);
+      const response = await funnelApi.analyze(funnelId, {
+        timeWindow,
+        dimension,
+        segment
+      });
+      setAnalysis(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [funnelId, timeWindow, dimension, segment]);
+  React.useEffect(() => {
+    analyze();
+  }, [analyze]);
+
+  // 计算派生数据
+  const derivedData = React.useMemo(() => {
+    if (!analysis || !analysis.steps) return null;
+    const steps = analysis.steps;
+    const totalUsers = steps[0]?.users || 0;
+    const completedUsers = steps[steps.length - 1]?.users || 0;
+    const overallConversion = totalUsers > 0 ? completedUsers / totalUsers : 0;
+
+    // 找出最大流失步骤
+    let maxDropOffStep = null;
+    let maxDropOffRate = 0;
+    steps.forEach((step, index) => {
+      if (index > 0) {
+        const prevUsers = steps[index - 1].users;
+        const dropOffRate = prevUsers > 0 ? (prevUsers - step.users) / prevUsers : 0;
+        if (dropOffRate > maxDropOffRate) {
+          maxDropOffRate = dropOffRate;
+          maxDropOffStep = {
+            ...step,
+            dropOffRate,
+            fromStep: steps[index - 1].name
+          };
+        }
+      }
+    });
+    return {
+      totalUsers,
+      completedUsers,
+      overallConversion,
+      bottleneck: maxDropOffStep,
+      stepConversions: steps.map((step, index) => ({
+        ...step,
+        conversionFromPrev: index > 0 && steps[index - 1].users > 0 ? step.users / steps[index - 1].users : 1,
+        conversionFromFirst: totalUsers > 0 ? step.users / totalUsers : 0
+      }))
+    };
+  }, [analysis]);
+  return {
+    analysis,
+    derivedData,
+    loading,
+    error,
+    refresh: analyze
+  };
+}
+
+/**
+ * 步骤追踪
+ */
+function useStepTracking(funnelId) {
+  const [currentStep, setCurrentStep] = React.useState(0);
+  const [trackedSteps, setTrackedSteps] = React.useState([]);
+
+  // 追踪步骤
+  const trackStep = React.useCallback(async (stepName, metadata = {}) => {
+    try {
+      await funnelApi.trackStep(funnelId, stepName, {
+        ...metadata,
+        timestamp: Date.now()
+      });
+      setTrackedSteps(prev => [...prev, {
+        name: stepName,
+        timestamp: Date.now()
+      }]);
+      setCurrentStep(prev => prev + 1);
+    } catch (err) {
+      console.error('Track step error:', err);
+    }
+  }, [funnelId]);
+
+  // 重置追踪
+  const resetTracking = React.useCallback(() => {
+    setCurrentStep(0);
+    setTrackedSteps([]);
+  }, []);
+  return {
+    currentStep,
+    trackedSteps,
+    trackStep,
+    resetTracking
+  };
+}
+
+/**
+ * 流失分析
+ */
+function useDropOffAnalysis(funnelId, stepIndex, options = {}) {
+  const [dropOffData, setDropOffData] = React.useState(null);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const analyze = React.useCallback(async () => {
+    if (!funnelId || stepIndex === undefined) return;
+    try {
+      setLoading(true);
+      const response = await funnelApi.getDropOff(funnelId, stepIndex, options);
+      setDropOffData(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [funnelId, stepIndex, options]);
+  React.useEffect(() => {
+    analyze();
+  }, [analyze]);
+  return {
+    dropOffData,
+    loading,
+    error,
+    refresh: analyze
+  };
+}
+
+/**
+ * 漏斗对比分析
+ */
+function useFunnelComparison(funnelId, compareOptions = {}) {
+  const [comparison, setComparison] = React.useState(null);
+  const [loading, setLoading] = React.useState(true);
+  const [error, setError] = React.useState(null);
+  const {
+    segments = [],
+    timeRanges = []
+  } = compareOptions;
+  const compare = React.useCallback(async () => {
+    if (!funnelId) return;
+    try {
+      setLoading(true);
+      const response = await funnelApi.compare(funnelId, {
+        segments,
+        timeRanges
+      });
+      setComparison(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [funnelId, segments, timeRanges]);
+  React.useEffect(() => {
+    compare();
+  }, [compare]);
+  return {
+    comparison,
+    loading,
+    error,
+    refresh: compare
+  };
+}
+
+/**
+ * 漏斗操作（创建、更新、删除）
+ */
+function useFunnelActions() {
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const createFunnel = React.useCallback(async data => {
+    try {
+      setLoading(true);
+      setError(null);
+      const result = await funnelApi.createFunnel(data);
+      return result;
+    } catch (err) {
+      setError(err.message);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  const updateFunnel = React.useCallback(async (funnelId, data) => {
+    try {
+      setLoading(true);
+      setError(null);
+      const result = await funnelApi.updateFunnel(funnelId, data);
+      return result;
+    } catch (err) {
+      setError(err.message);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  const deleteFunnel = React.useCallback(async funnelId => {
+    try {
+      setLoading(true);
+      setError(null);
+      await funnelApi.deleteFunnel(funnelId);
+    } catch (err) {
+      setError(err.message);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  return {
+    loading,
+    error,
+    createFunnel,
+    updateFunnel,
+    deleteFunnel
+  };
+}
+
+/**
+ * Funnel SDK - React 组件
+ * 转化漏斗可视化组件
+ */
+
+
+/**
+ * 漏斗图组件
+ */
+function FunnelChart({
+  funnelId,
+  steps,
+  showLabels = true,
+  animated = true
+}) {
+  const {
+    derivedData,
+    loading,
+    error
+  } = useFunnelAnalysis(funnelId);
+  const stepsData = steps || derivedData?.stepConversions || [];
+  const maxUsers = stepsData[0]?.users || 1;
+  if (loading) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-loading"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-spinner"
+    }), /*#__PURE__*/React.createElement("span", null, t('loading')));
+  }
+  if (error) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-error"
+    }, error);
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-chart"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-visual"
+  }, stepsData.map((step, index) => {
+    const widthPercent = step.users / maxUsers * 100;
+    const conversionRate = step.conversionFromFirst * 100;
+    return /*#__PURE__*/React.createElement("div", {
+      key: step.id || index,
+      className: `eco-funnel-step ${animated ? 'animated' : ''}`,
+      style: {
+        '--step-width': `${widthPercent}%`,
+        '--step-delay': `${index * 0.1}s`
+      }
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-step-bar"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-step-fill"
+    })), showLabels && /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-step-info"
+    }, /*#__PURE__*/React.createElement("span", {
+      className: "eco-funnel-step-name"
+    }, step.name), /*#__PURE__*/React.createElement("span", {
+      className: "eco-funnel-step-users"
+    }, step.users.toLocaleString()), /*#__PURE__*/React.createElement("span", {
+      className: "eco-funnel-step-rate"
+    }, conversionRate.toFixed(1), "%")), index > 0 && /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-dropoff"
+    }, /*#__PURE__*/React.createElement("span", {
+      className: "eco-funnel-dropoff-icon"
+    }, "\u2193"), /*#__PURE__*/React.createElement("span", {
+      className: "eco-funnel-dropoff-rate"
+    }, "-", ((1 - step.conversionFromPrev) * 100).toFixed(1), "%")));
+  })));
+}
+
+/**
+ * 漏斗步骤卡片
+ */
+function FunnelStepCard({
+  step,
+  index,
+  isBottleneck = false,
+  onClick
+}) {
+  return /*#__PURE__*/React.createElement("div", {
+    className: `eco-funnel-step-card ${isBottleneck ? 'bottleneck' : ''}`,
+    onClick: () => onClick?.(step, index)
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-step-header"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-step-index"
+  }, index + 1), /*#__PURE__*/React.createElement("h4", {
+    className: "eco-funnel-step-title"
+  }, step.name), isBottleneck && /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-bottleneck-badge"
+  }, "\uD83D\uDD34 ", t('bottleneck'))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-step-metrics"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-metric"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-metric-value"
+  }, step.users.toLocaleString()), /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-metric-label"
+  }, t('totalUsers'))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-metric"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-metric-value"
+  }, (step.conversionRate * 100).toFixed(1), "%"), /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-metric-label"
+  }, t('conversionRate'))), step.dropOffRate !== undefined && /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-metric negative"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-metric-value"
+  }, "-", (step.dropOffRate * 100).toFixed(1), "%"), /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-metric-label"
+  }, t('dropOffRate')))), step.averageTime && /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-step-time"
+  }, /*#__PURE__*/React.createElement("span", null, t('averageTime'), ": ", formatDuration(step.averageTime))));
+}
+
+/**
+ * 漏斗概览卡片
+ */
+function FunnelOverview({
+  funnelId,
+  title
+}) {
+  const {
+    analysis,
+    derivedData,
+    loading,
+    error
+  } = useFunnelAnalysis(funnelId);
+  if (loading) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-overview eco-funnel-loading"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-spinner"
+    }));
+  }
+  if (error) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-overview eco-funnel-error"
+    }, error);
+  }
+  if (!derivedData) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-overview eco-funnel-empty"
+    }, t('noData'));
+  }
+  const {
+    totalUsers,
+    completedUsers,
+    overallConversion,
+    bottleneck
+  } = derivedData;
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-overview"
+  }, /*#__PURE__*/React.createElement("h3", {
+    className: "eco-funnel-overview-title"
+  }, title || t('analysis')), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-overview-stats"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-stat"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-stat-value"
+  }, totalUsers.toLocaleString()), /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-stat-label"
+  }, t('totalUsers'))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-stat"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-stat-value"
+  }, completedUsers.toLocaleString()), /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-stat-label"
+  }, t('completedUsers'))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-stat highlight"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-stat-value"
+  }, (overallConversion * 100).toFixed(1), "%"), /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-stat-label"
+  }, t('overall'), " ", t('conversionRate')))), bottleneck && /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-bottleneck-info"
+  }, /*#__PURE__*/React.createElement("h4", null, "\uD83D\uDD34 ", t('bottleneck')), /*#__PURE__*/React.createElement("p", null, bottleneck.fromStep, " \u2192 ", bottleneck.name, ":", /*#__PURE__*/React.createElement("strong", null, " -", (bottleneck.dropOffRate * 100).toFixed(1), "%"), " ", t('dropOff'))));
+}
+
+/**
+ * 漏斗对比图
+ */
+function FunnelComparison({
+  data,
+  labels
+}) {
+  if (!data || data.length === 0) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-funnel-empty"
+    }, t('noData'));
+  }
+  const colors = ['#6366f1', '#10b981', '#f59e0b', '#ef4444'];
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-comparison"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-comparison-legend"
+  }, labels.map((label, i) => /*#__PURE__*/React.createElement("div", {
+    key: i,
+    className: "eco-funnel-legend-item"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-funnel-legend-color",
+    style: {
+      backgroundColor: colors[i % colors.length]
+    }
+  }), /*#__PURE__*/React.createElement("span", null, label)))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-comparison-chart"
+  }, data[0]?.steps?.map((_, stepIndex) => /*#__PURE__*/React.createElement("div", {
+    key: stepIndex,
+    className: "eco-funnel-comparison-row"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-comparison-label"
+  }, data[0].steps[stepIndex].name), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-comparison-bars"
+  }, data.map((funnel, funnelIndex) => {
+    const step = funnel.steps[stepIndex];
+    const rate = step.conversionRate * 100;
+    return /*#__PURE__*/React.createElement("div", {
+      key: funnelIndex,
+      className: "eco-funnel-comparison-bar",
+      style: {
+        width: `${rate}%`,
+        backgroundColor: colors[funnelIndex % colors.length]
+      }
+    }, /*#__PURE__*/React.createElement("span", {
+      className: "eco-funnel-comparison-value"
+    }, rate.toFixed(1), "%"));
+  }))))));
+}
+
+/**
+ * 漏斗构建器
+ */
+function FunnelBuilder({
+  initialSteps = [],
+  onSave,
+  onCancel
+}) {
+  const [steps, setSteps] = React.useState(initialSteps.length > 0 ? initialSteps : [{
+    name: '',
+    event: ''
+  }, {
+    name: '',
+    event: ''
+  }]);
+  const [funnelName, setFunnelName] = React.useState('');
+  const {
+    loading,
+    createFunnel
+  } = useFunnelActions();
+  const addStep = () => {
+    setSteps([...steps, {
+      name: '',
+      event: ''
+    }]);
+  };
+  const removeStep = index => {
+    if (steps.length > 2) {
+      setSteps(steps.filter((_, i) => i !== index));
+    }
+  };
+  const updateStep = (index, field, value) => {
+    const newSteps = [...steps];
+    newSteps[index] = {
+      ...newSteps[index],
+      [field]: value
+    };
+    setSteps(newSteps);
+  };
+  const handleSave = async () => {
+    try {
+      const result = await createFunnel({
+        name: funnelName,
+        steps: steps.filter(s => s.name && s.event)
+      });
+      onSave?.(result);
+    } catch (err) {
+      console.error('Save funnel error:', err);
+    }
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-builder"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-builder-header"
+  }, /*#__PURE__*/React.createElement("input", {
+    type: "text",
+    className: "eco-funnel-name-input",
+    placeholder: t('funnelName'),
+    value: funnelName,
+    onChange: e => setFunnelName(e.target.value)
+  })), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-builder-steps"
+  }, steps.map((step, index) => /*#__PURE__*/React.createElement("div", {
+    key: index,
+    className: "eco-funnel-builder-step"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-step-number"
+  }, index + 1), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-step-inputs"
+  }, /*#__PURE__*/React.createElement("input", {
+    type: "text",
+    placeholder: t('stepName'),
+    value: step.name,
+    onChange: e => updateStep(index, 'name', e.target.value)
+  }), /*#__PURE__*/React.createElement("input", {
+    type: "text",
+    placeholder: t('stepEvent'),
+    value: step.event,
+    onChange: e => updateStep(index, 'event', e.target.value)
+  })), steps.length > 2 && /*#__PURE__*/React.createElement("button", {
+    className: "eco-funnel-remove-btn",
+    onClick: () => removeStep(index)
+  }, "\u2715")))), /*#__PURE__*/React.createElement("button", {
+    className: "eco-funnel-add-step-btn",
+    onClick: addStep
+  }, "+ ", t('addStep')), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-builder-actions"
+  }, /*#__PURE__*/React.createElement("button", {
+    className: "eco-funnel-btn",
+    onClick: onCancel
+  }, t('cancel')), /*#__PURE__*/React.createElement("button", {
+    className: "eco-funnel-btn eco-funnel-btn-primary",
+    onClick: handleSave,
+    disabled: loading || !funnelName || steps.some(s => !s.name || !s.event)
+  }, loading ? t('loading') : t('save'))));
+}
+
+/**
+ * 流失详情面板
+ */
+function DropOffPanel({
+  funnelId,
+  stepIndex,
+  stepName
+}) {
+  const [activeTab, setActiveTab] = React.useState('reasons');
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-dropoff-panel"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-dropoff-header"
+  }, /*#__PURE__*/React.createElement("h4", null, t('dropOff'), " - ", stepName)), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-dropoff-tabs"
+  }, /*#__PURE__*/React.createElement("button", {
+    className: activeTab === 'reasons' ? 'active' : '',
+    onClick: () => setActiveTab('reasons')
+  }, t('insights')), /*#__PURE__*/React.createElement("button", {
+    className: activeTab === 'users' ? 'active' : '',
+    onClick: () => setActiveTab('users')
+  }, t('lostUsers')), /*#__PURE__*/React.createElement("button", {
+    className: activeTab === 'recommendations' ? 'active' : '',
+    onClick: () => setActiveTab('recommendations')
+  }, t('recommendations'))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-dropoff-content"
+  }, activeTab === 'reasons' && /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-insights"
+  }, /*#__PURE__*/React.createElement("p", null, "\u5206\u6790\u6D41\u5931\u7528\u6237\u7684\u884C\u4E3A\u6A21\u5F0F...")), activeTab === 'users' && /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-lost-users"
+  }, /*#__PURE__*/React.createElement("p", null, "\u5C55\u793A\u6D41\u5931\u7528\u6237\u5217\u8868...")), activeTab === 'recommendations' && /*#__PURE__*/React.createElement("div", {
+    className: "eco-funnel-recommendations"
+  }, /*#__PURE__*/React.createElement("p", null, "\u4F18\u5316\u5EFA\u8BAE..."))));
+}
+
+// 工具函数
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
+  if (ms < 3600000) return `${(ms / 60000).toFixed(1)}m`;
+  return `${(ms / 3600000).toFixed(1)}h`;
+}
+
+/**
+ * @quantabit/funnel-sdk
+ * Funnel Analysis SDK - Full Version
+ */
+
+const analyze = (...args) => funnelApi.analyze(...args);
+const getDropOff = (...args) => funnelApi.getDropOff(...args);
+const trackStep = (...args) => funnelApi.trackStep(...args);
+const getFunnels = (...args) => funnelApi.getFunnels(...args);
+const getFunnel = (...args) => funnelApi.getFunnel(...args);
+const createFunnel = (...args) => funnelApi.createFunnel(...args);
+const updateFunnel = (...args) => funnelApi.updateFunnel(...args);
+const deleteFunnel = (...args) => funnelApi.deleteFunnel(...args);
+
+exports.DropOffPanel = DropOffPanel;
+exports.FunnelApiClient = FunnelApiClient;
+exports.FunnelBuilder = FunnelBuilder;
+exports.FunnelChart = FunnelChart;
+exports.FunnelComparison = FunnelComparison;
+exports.FunnelOverview = FunnelOverview;
+exports.FunnelStepCard = FunnelStepCard;
+exports.FunnelType = FunnelType;
+exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+exports.StepStatus = StepStatus;
+exports.TimeWindow = TimeWindow;
+exports.analyze = analyze;
+exports.createFunnel = createFunnel;
+exports.deleteFunnel = deleteFunnel;
+exports.funnelApi = funnelApi;
+exports.getDropOff = getDropOff;
+exports.getFunnel = getFunnel;
+exports.getFunnels = getFunnels;
+exports.getLanguage = getLanguage;
+exports.messages = messages;
+exports.setLanguage = setLanguage;
+exports.t = t;
+exports.trackStep = trackStep;
+exports.updateFunnel = updateFunnel;
+exports.useDropOffAnalysis = useDropOffAnalysis;
+exports.useFunnel = useFunnel;
+exports.useFunnelActions = useFunnelActions;
+exports.useFunnelAnalysis = useFunnelAnalysis;
+exports.useFunnelComparison = useFunnelComparison;
+exports.useFunnels = useFunnels;
+exports.useStepTracking = useStepTracking;
+//# sourceMappingURL=index.cjs.map