@quantabit/report-sdk 1.0.0

package/dist/index.esm.js

@@ -0,0 +1,794 @@
+import React, { useState, useEffect, useCallback, useContext, createContext } from 'react';
+import { BaseApiClient } from '@quantabit/sdk-config';
+
+/**
+ * Report SDK - API 客户端
+ * 举报系统后端接口封装
+ * 
+ * 使用 BaseApiClient 基类简化代码
+ */
+
+
+/**
+ * 举报 API 客户端
+ */
+class ReportApiClient extends BaseApiClient {
+  constructor(config = {}) {
+    super('/report', config);
+  }
+
+  // ============ 举报提交 ============
+
+  /**
+   * 提交举报
+   * @param {Object} data - 举报数据
+   */
+  async submit(data) {
+    return this.post('/', data);
+  }
+
+  /**
+   * 举报用户
+   * @param {string} userId - 被举报用户 ID
+   * @param {Object} data - 举报信息
+   */
+  async reportUser(userId, data) {
+    return this.post('/user', {
+      target_id: userId,
+      ...data
+    });
+  }
+
+  /**
+   * 举报内容
+   * @param {string} contentId - 内容 ID
+   * @param {string} contentType - 内容类型
+   * @param {Object} data - 举报信息
+   */
+  async reportContent(contentId, contentType, data) {
+    return this.post('/content', {
+      content_id: contentId,
+      content_type: contentType,
+      ...data
+    });
+  }
+
+  /**
+   * 举报评论
+   * @param {string} commentId - 评论 ID
+   * @param {Object} data - 举报信息
+   */
+  async reportComment(commentId, data) {
+    return this.post('/comment', {
+      comment_id: commentId,
+      ...data
+    });
+  }
+
+  // ============ 举报查询 ============
+
+  /**
+   * 获取我的举报列表
+   * @param {Object} params - 查询参数
+   */
+  async getMyReports(params = {}) {
+    return this.get('/my', params);
+  }
+
+  /**
+   * 获取举报详情
+   * @param {string} reportId - 举报 ID
+   */
+  async getReport(reportId) {
+    return this.get(`/${reportId}`);
+  }
+
+  /**
+   * 获取举报处理进度
+   * @param {string} reportId - 举报 ID
+   */
+  async getReportProgress(reportId) {
+    return this.get(`/${reportId}/progress`);
+  }
+
+  /**
+   * 撤回举报
+   * @param {string} reportId - 举报 ID
+   */
+  async withdraw(reportId) {
+    return this.post(`/${reportId}/withdraw`);
+  }
+
+  // ============ 举报类型 ============
+
+  /**
+   * 获取举报类型列表
+   * @param {string} category - 分类
+   */
+  async getReportTypes(category = null) {
+    const params = category ? {
+      category
+    } : {};
+    return this.get('/types', params);
+  }
+
+  /**
+   * 获取举报类型分类
+   */
+  async getReportCategories() {
+    return this.get('/categories');
+  }
+
+  // ============ 管理员操作 ============
+
+  /**
+   * 获取待处理举报（管理员）
+   * @param {Object} params - 查询参数
+   */
+  async getPendingReports(params = {}) {
+    return this.get('/admin/pending', params);
+  }
+
+  /**
+   * 处理举报（管理员）
+   * @param {string} reportId - 举报 ID
+   * @param {Object} decision - 处理决定
+   */
+  async handleReport(reportId, decision) {
+    return this.post(`/admin/${reportId}/handle`, decision);
+  }
+
+  /**
+   * 批量处理举报（管理员）
+   * @param {string[]} reportIds - 举报 ID 列表
+   * @param {Object} decision - 处理决定
+   */
+  async batchHandle(reportIds, decision) {
+    return this.post('/admin/batch-handle', {
+      report_ids: reportIds,
+      ...decision
+    });
+  }
+
+  /**
+   * 分配举报（管理员）
+   * @param {string} reportId - 举报 ID
+   * @param {string} handlerId - 处理人 ID
+   */
+  async assignReport(reportId, handlerId) {
+    return this.post(`/admin/${reportId}/assign`, {
+      handler_id: handlerId
+    });
+  }
+
+  // ============ 统计 ============
+
+  /**
+   * 获取举报统计（管理员）
+   * @param {Object} params - 统计参数
+   */
+  async getStats(params = {}) {
+    return this.get('/admin/stats', params);
+  }
+
+  /**
+   * 获取举报趋势（管理员）
+   * @param {Object} params - 查询参数
+   */
+  async getTrend(params = {}) {
+    return this.get('/admin/trend', params);
+  }
+}
+
+// 创建默认实例
+const reportApi = new ReportApiClient();
+
+/**
+ * Report SDK - 国际化 i18n
+ */
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  zh: {
+    loading: '加载中...',
+    report: '举报',
+    reports: '举报记录',
+    // 举报类型
+    typeContent: '内容违规',
+    typeUser: '用户违规',
+    typeSpam: '垃圾信息',
+    typeFraud: '欺诈诈骗',
+    typeHarassment: '骚扰辱骂',
+    typeViolence: '暴力内容',
+    typePorn: '色情内容',
+    typeInfringement: '侵权假冒',
+    typeOther: '其他',
+    // 举报状态
+    statusPending: '待处理',
+    statusProcessing: '处理中',
+    statusApproved: '已通过',
+    statusRejected: '已驳回',
+    statusClosed: '已关闭',
+    // 表单
+    selectType: '选择举报类型',
+    describe: '问题描述',
+    describePlaceholder: '请详细描述您遇到的问题...',
+    uploadEvidence: '上传证据',
+    uploadHint: '支持图片、视频、截图',
+    contact: '联系方式（选填）',
+    // 操作
+    submit: '提交举报',
+    cancel: '取消',
+    viewDetail: '查看详情',
+    // 结果
+    submitSuccess: '举报提交成功',
+    submitSuccessHint: '我们会尽快处理您的举报',
+    // 审核（管理端）
+    review: '审核',
+    approve: '通过（已处理）',
+    reject: '驳回',
+    reviewNote: '审核备注',
+    // 提示
+    noReports: '暂无举报记录',
+    thanksForReport: '感谢您的反馈'
+  },
+  en: {
+    loading: 'Loading...',
+    report: 'Report',
+    reports: 'Reports',
+    typeContent: 'Content Violation',
+    typeUser: 'User Violation',
+    typeSpam: 'Spam',
+    typeFraud: 'Fraud',
+    typeHarassment: 'Harassment',
+    typeViolence: 'Violence',
+    typePorn: 'Adult Content',
+    typeInfringement: 'Infringement',
+    typeOther: 'Other',
+    statusPending: 'Pending',
+    statusProcessing: 'Processing',
+    statusApproved: 'Approved',
+    statusRejected: 'Rejected',
+    statusClosed: 'Closed',
+    selectType: 'Select Report Type',
+    describe: 'Description',
+    describePlaceholder: 'Please describe the issue...',
+    uploadEvidence: 'Upload Evidence',
+    uploadHint: 'Images, videos, or screenshots',
+    contact: 'Contact (Optional)',
+    submit: 'Submit Report',
+    cancel: 'Cancel',
+    viewDetail: 'View Details',
+    submitSuccess: 'Report Submitted',
+    submitSuccessHint: 'We will review your report shortly',
+    review: 'Review',
+    approve: 'Approve',
+    reject: 'Reject',
+    reviewNote: 'Review Note',
+    noReports: 'No reports',
+    thanksForReport: 'Thank you for your feedback'
+  },
+  ja: {
+    loading: '読み込み中...',
+    report: '通報',
+    reports: '通報履歴',
+    typeContent: 'コンテンツ違反',
+    typeUser: 'ユーザー違反',
+    typeSpam: 'スパム',
+    typeFraud: '詐欺',
+    typeHarassment: '嫌がらせ',
+    typeViolence: '暴力',
+    typePorn: 'アダルトコンテンツ',
+    typeInfringement: '権利侵害',
+    typeOther: 'その他',
+    statusPending: '保留中',
+    statusProcessing: '処理中',
+    statusApproved: '承認済み',
+    statusRejected: '拒否されました',
+    statusClosed: 'クローズ',
+    selectType: '通報タイプを選択',
+    describe: '説明',
+    describePlaceholder: '問題を説明してください...',
+    uploadEvidence: '証拠をアップロード',
+    uploadHint: '画像、ビデオ、またはスクリーンショット',
+    contact: '連絡先（任意）',
+    submit: '通報を送信',
+    cancel: 'キャンセル',
+    viewDetail: '詳細を見る',
+    submitSuccess: '通報を送信しました',
+    submitSuccessHint: '通報をすぐに確認します',
+    review: '審査',
+    approve: '承認',
+    reject: '拒否',
+    reviewNote: '審査メモ',
+    noReports: '通報はありません',
+    thanksForReport: 'フィードバックをありがとうございます'
+  },
+  ko: {
+    loading: '로딩 중...',
+    report: '신고',
+    reports: '신고 내역',
+    typeContent: '콘텐츠 위반',
+    typeUser: '사용자 위반',
+    typeSpam: '스팸',
+    typeFraud: '사기',
+    typeHarassment: '괴롭힘',
+    typeViolence: '폭력',
+    typePorn: '음란물',
+    typeInfringement: '권리 침해',
+    typeOther: '기타',
+    statusPending: '대기 중',
+    statusProcessing: '처리 중',
+    statusApproved: '승인됨',
+    statusRejected: '거부됨',
+    statusClosed: '닫힘',
+    selectType: '신고 유형 선택',
+    describe: '설명',
+    describePlaceholder: '문제를 설명해주세요...',
+    uploadEvidence: '증거 업로드',
+    uploadHint: '이미지, 동영상 또는 스크린샷',
+    contact: '연락처 (선택 사항)',
+    submit: '신고 제출',
+    cancel: '취소',
+    viewDetail: '자세히 보기',
+    submitSuccess: '신고가 제출되었습니다',
+    submitSuccessHint: '곧 신고 내용을 확인하겠습니다',
+    review: '검토',
+    approve: '승인',
+    reject: '거부',
+    reviewNote: '검토 메모',
+    noReports: '신고 내역 없음',
+    thanksForReport: '피드백을 보내주셔서 감사합니다'
+  }
+};
+let currentLanguage = 'zh';
+function setLanguage(lang) {
+  if (SUPPORTED_LANGUAGES.includes(lang)) {
+    currentLanguage = lang;
+    if (typeof window !== 'undefined') {
+      localStorage.setItem('qbit_did_report_language', lang);
+    }
+  }
+}
+function getLanguage() {
+  if (typeof window !== 'undefined') {
+    const saved = localStorage.getItem('qbit_did_report_language');
+    if (saved && SUPPORTED_LANGUAGES.includes(saved)) {
+      currentLanguage = saved;
+    }
+  }
+  return currentLanguage;
+}
+function t(key, params) {
+  const msgs = messages[getLanguage()] || messages.zh;
+  let text = msgs[key] || key;
+  if (params) {
+    Object.keys(params).forEach(k => {
+      text = text.replace(new RegExp(`\\{${k}\\}`, 'g'), params[k]);
+    });
+  }
+  return text;
+}
+
+/**
+ * Report SDK - Context Provider
+ */
+
+const ReportContext = /*#__PURE__*/createContext(null);
+function ReportProvider({
+  children,
+  apiUrl,
+  token,
+  language = 'zh',
+  onSubmit,
+  onError
+}) {
+  const [myReports, setMyReports] = useState([]);
+  const [pendingReports, setPendingReports] = useState([]);
+  const [stats, setStats] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (apiUrl) reportApi.setBaseUrl(apiUrl);
+    if (token) reportApi.setToken(token);
+    if (language) setLanguage(language);
+  }, [apiUrl, token, language]);
+  const handleError = useCallback(err => {
+    setError(err.message);
+    onError?.(err);
+  }, [onError]);
+
+  // ============ 用户操作 ============
+
+  const submit = useCallback(async data => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await reportApi.submit(data);
+      onSubmit?.(result);
+      return result;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [handleError, onSubmit]);
+  const loadMyReports = useCallback(async (params = {}) => {
+    setLoading(true);
+    try {
+      const result = await reportApi.getMyReports(params);
+      const items = result.items || result.data || result || [];
+      setMyReports(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+    } finally {
+      setLoading(false);
+    }
+  }, [handleError]);
+
+  // ============ 管理操作 ============
+
+  const loadPendingReports = useCallback(async (params = {}) => {
+    setLoading(true);
+    try {
+      const result = await reportApi.getPendingList(params);
+      const items = result.items || result.data || result || [];
+      setPendingReports(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+    } finally {
+      setLoading(false);
+    }
+  }, [handleError]);
+  const handleReport = useCallback(async (reportId, data) => {
+    setLoading(true);
+    try {
+      const result = await reportApi.handle(reportId, data);
+      await loadPendingReports();
+      return result;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [handleError, loadPendingReports]);
+  const loadStats = useCallback(async () => {
+    try {
+      const result = await reportApi.getStats();
+      setStats(result);
+      return result;
+    } catch (err) {
+      handleError(err);
+    }
+  }, [handleError]);
+  const value = {
+    myReports,
+    pendingReports,
+    stats,
+    loading,
+    error,
+    submit,
+    loadMyReports,
+    loadPendingReports,
+    handleReport,
+    loadStats,
+    api: reportApi
+  };
+  return /*#__PURE__*/React.createElement(ReportContext.Provider, {
+    value: value
+  }, children);
+}
+function useReport() {
+  const context = useContext(ReportContext);
+  if (!context) {
+    throw new Error('useReport must be used within a ReportProvider');
+  }
+  return context;
+}
+
+/**
+ * Report SDK - 类型定义
+ */
+
+// 举报类型
+const ReportType = {
+  CONTENT: 'content',
+  // 内容违规
+  USER: 'user',
+  // 用户违规
+  SPAM: 'spam',
+  // 垃圾信息
+  FRAUD: 'fraud',
+  // 欺诈
+  HARASSMENT: 'harassment',
+  // 骚扰
+  VIOLENCE: 'violence',
+  // 暴力
+  PORN: 'porn',
+  // 色情
+  INFRINGEMENT: 'infringement',
+  // 侵权
+  OTHER: 'other' // 其他
+};
+
+// 举报目标类型
+const TargetType = {
+  POST: 'post',
+  // 帖子
+  COMMENT: 'comment',
+  // 评论
+  USER: 'user',
+  // 用户
+  MESSAGE: 'message',
+  // 消息
+  GROUP: 'group',
+  // 群组
+  PRODUCT: 'product' // 商品
+};
+
+// 举报状态
+const ReportStatus = {
+  PENDING: 'pending',
+  // 待处理
+  PROCESSING: 'processing',
+  // 处理中
+  APPROVED: 'approved',
+  // 已通过（举报成立）
+  REJECTED: 'rejected',
+  // 已驳回
+  CLOSED: 'closed' // 已关闭
+};
+
+// 处理结果
+const HandleResult = {
+  WARNING: 'warning',
+  // 警告
+  DELETE: 'delete',
+  // 删除内容
+  MUTE: 'mute',
+  // 禁言
+  BAN: 'ban',
+  // 封禁
+  NONE: 'none' // 无处理
+};
+
+/**
+ * 举报类型配置
+ */
+const ReportTypeConfig = {
+  [ReportType.SPAM]: {
+    icon: '🗑️',
+    color: '#faad14'
+  },
+  [ReportType.FRAUD]: {
+    icon: '⚠️',
+    color: '#ff4d4f'
+  },
+  [ReportType.HARASSMENT]: {
+    icon: '😡',
+    color: '#eb2f96'
+  },
+  [ReportType.VIOLENCE]: {
+    icon: '⚔️',
+    color: '#cf1322'
+  },
+  [ReportType.PORN]: {
+    icon: '🔞',
+    color: '#722ed1'
+  },
+  [ReportType.INFRINGEMENT]: {
+    icon: '©️',
+    color: '#1890ff'
+  },
+  [ReportType.CONTENT]: {
+    icon: '📝',
+    color: '#fa8c16'
+  },
+  [ReportType.USER]: {
+    icon: '👤',
+    color: '#52c41a'
+  },
+  [ReportType.OTHER]: {
+    icon: '❓',
+    color: '#8c8c8c'
+  }
+};
+
+/**
+ * 创建默认举报
+ */
+function createDefaultReport(overrides = {}) {
+  return {
+    id: null,
+    reporter_did: null,
+    target_type: TargetType.POST,
+    target_id: null,
+    report_type: ReportType.OTHER,
+    description: '',
+    evidence_urls: [],
+    // 证据截图
+    contact: '',
+    status: ReportStatus.PENDING,
+    handler_did: null,
+    // 处理人
+    handle_result: null,
+    // 处理结果
+    handle_note: '',
+    // 处理备注
+    created_at: null,
+    handled_at: null,
+    ...overrides
+  };
+}
+
+/**
+ * 获取举报类型列表
+ */
+function getReportTypes() {
+  return Object.values(ReportType).map(type => ({
+    value: type,
+    ...ReportTypeConfig[type]
+  }));
+}
+
+/**
+ * Report SDK - ReportForm 组件
+ * 举报表单
+ */
+
+function ReportForm({
+  targetType,
+  targetId,
+  onSuccess,
+  onCancel,
+  className = ''
+}) {
+  const {
+    submit,
+    loading
+  } = useReport();
+  const [reportType, setReportType] = useState('');
+  const [description, setDescription] = useState('');
+  const [evidenceUrls, setEvidenceUrls] = useState([]);
+  const [contact, setContact] = useState('');
+  const [submitted, setSubmitted] = useState(false);
+  const [error, setError] = useState(null);
+  const reportTypes = getReportTypes();
+  const handleSubmit = async e => {
+    e.preventDefault();
+    setError(null);
+    if (!reportType) {
+      setError('请选择举报类型');
+      return;
+    }
+    if (!description.trim()) {
+      setError('请填写问题描述');
+      return;
+    }
+    try {
+      const result = await submit({
+        target_type: targetType,
+        target_id: targetId,
+        report_type: reportType,
+        description: description.trim(),
+        evidence_urls: evidenceUrls,
+        contact
+      });
+      setSubmitted(true);
+      onSuccess?.(result);
+    } catch (err) {
+      setError(err.message);
+    }
+  };
+  if (submitted) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: `report-form report-success ${className}`
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "success-icon"
+    }, "\u2713"), /*#__PURE__*/React.createElement("h3", null, t('submitSuccess')), /*#__PURE__*/React.createElement("p", null, t('submitSuccessHint')), /*#__PURE__*/React.createElement("button", {
+      className: "btn-close",
+      onClick: onCancel
+    }, "\u5173\u95ED"));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: `report-form ${className}`
+  }, /*#__PURE__*/React.createElement("h3", {
+    className: "report-form-title"
+  }, t('report')), /*#__PURE__*/React.createElement("form", {
+    onSubmit: handleSubmit
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "form-group"
+  }, /*#__PURE__*/React.createElement("label", null, t('selectType')), /*#__PURE__*/React.createElement("div", {
+    className: "report-type-grid"
+  }, reportTypes.map(type => {
+    const config = ReportTypeConfig[type.value];
+    return /*#__PURE__*/React.createElement("button", {
+      key: type.value,
+      type: "button",
+      className: `report-type-item ${reportType === type.value ? 'selected' : ''}`,
+      onClick: () => setReportType(type.value)
+    }, /*#__PURE__*/React.createElement("span", {
+      className: "type-icon"
+    }, config.icon), /*#__PURE__*/React.createElement("span", {
+      className: "type-label"
+    }, t(`type${type.value.charAt(0).toUpperCase() + type.value.slice(1)}`)));
+  }))), /*#__PURE__*/React.createElement("div", {
+    className: "form-group"
+  }, /*#__PURE__*/React.createElement("label", null, t('describe')), /*#__PURE__*/React.createElement("textarea", {
+    value: description,
+    onChange: e => setDescription(e.target.value),
+    placeholder: t('describePlaceholder'),
+    rows: 4,
+    maxLength: 500
+  }), /*#__PURE__*/React.createElement("span", {
+    className: "char-count"
+  }, description.length, "/500")), /*#__PURE__*/React.createElement("div", {
+    className: "form-group"
+  }, /*#__PURE__*/React.createElement("label", null, t('contact')), /*#__PURE__*/React.createElement("input", {
+    type: "text",
+    value: contact,
+    onChange: e => setContact(e.target.value),
+    placeholder: "\u90AE\u7BB1\u6216\u624B\u673A\u53F7"
+  })), error && /*#__PURE__*/React.createElement("div", {
+    className: "form-error"
+  }, error), /*#__PURE__*/React.createElement("div", {
+    className: "form-actions"
+  }, /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "btn-cancel",
+    onClick: onCancel
+  }, t('cancel')), /*#__PURE__*/React.createElement("button", {
+    type: "submit",
+    className: "btn-submit",
+    disabled: loading
+  }, loading ? t('loading') : t('submit')))));
+}
+
+/**
+ * Report SDK - ReportButton 组件
+ * 举报按钮（点击弹出表单）
+ */
+
+function ReportButton({
+  targetType,
+  targetId,
+  onSuccess,
+  iconOnly = false,
+  className = ''
+}) {
+  const [showForm, setShowForm] = useState(false);
+  const handleSuccess = result => {
+    setShowForm(false);
+    onSuccess?.(result);
+  };
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("button", {
+    className: `report-button ${iconOnly ? 'icon-only' : ''} ${className}`,
+    onClick: () => setShowForm(true),
+    title: t('report')
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "report-icon"
+  }, "\uD83D\uDEA8"), !iconOnly && /*#__PURE__*/React.createElement("span", {
+    className: "report-text"
+  }, t('report'))), showForm && /*#__PURE__*/React.createElement("div", {
+    className: "report-modal-overlay",
+    onClick: () => setShowForm(false)
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "report-modal",
+    onClick: e => e.stopPropagation()
+  }, /*#__PURE__*/React.createElement("button", {
+    className: "modal-close",
+    onClick: () => setShowForm(false)
+  }, "\u2715"), /*#__PURE__*/React.createElement(ReportForm, {
+    targetType: targetType,
+    targetId: targetId,
+    onSuccess: handleSuccess,
+    onCancel: () => setShowForm(false)
+  }))));
+}
+
+export { HandleResult, ReportApiClient, ReportButton, ReportForm, ReportProvider, ReportStatus, ReportType, ReportTypeConfig, SUPPORTED_LANGUAGES, TargetType, createDefaultReport, getLanguage, getReportTypes, messages, reportApi, setLanguage, t, useReport };
+//# sourceMappingURL=index.esm.js.map