@spacecorexdev/core 0.0.2 → 0.0.5

package/src/utils/CacheViewToggleInfo.ts

@@ -0,0 +1,182 @@
+'use strict';
+
+/**
+ * Copyright (c) 2025 SPACECORE Co.,Ltd. All Rights Reserved.
+ * Author: brian.li
+ * Date: 2025-06-21 11:43
+ * Desc: 视图切换缓存工具类 - 支持Dexie缓存各页面UIViewToggle的选择
+ *
+ * @example 使用方法
+ *
+ * // 1. 获取页面的视图模式
+ * import { getViewMode, setViewMode, CacheViewToggleInfo } from './CacheViewToggleInfo';
+ * const viewMode = await getViewMode('user-management');
+ * console.log(viewMode); // 'table' | 'grid' | null
+ *
+ * // 2. 设置页面的视图模式
+ * await setViewMode('user-management', 'grid');
+ *
+ * // 3. 清除页面视图模式缓存
+ * import { clearViewModeCache, clearAllViewModeCache } from './CacheViewToggleInfo';
+ * await clearViewModeCache('user-management');
+ * await clearAllViewModeCache();
+ */
+
+import Dexie, { Table } from 'dexie';
+
+/** 视图模式缓存数据结构 */
+interface ViewModeCache {
+  pageKey: string;
+  viewMode: string;
+  timestamp: number;
+}
+
+/** Dexie 数据库类 */
+class ViewToggleDatabase extends Dexie {
+  viewModeCache!: Table<ViewModeCache, string>;
+
+  constructor() {
+    super('ViewToggleDB');
+    this.version(1).stores({
+      viewModeCache: 'pageKey, timestamp'
+    });
+  }
+}
+
+/** 单例数据库实例 */
+const db = new ViewToggleDatabase();
+
+/**
+ * 从缓存获取指定页面的视图模式
+ * @param pageKey 页面标识（如路由路径）
+ * @returns 缓存的视图模式或null
+ */
+const getFromCache = async (pageKey: string): Promise<string | null> => {
+  try {
+    const cached = await db.viewModeCache.get(pageKey);
+    if (cached) {
+      return cached.viewMode;
+    }
+    return null;
+  } catch (error) {
+    console.error('读取视图模式缓存失败:', error);
+    return null;
+  }
+};
+
+/**
+ * 设置页面视图模式到缓存
+ * @param pageKey 页面标识
+ * @param viewMode 视图模式值
+ */
+const setToCache = async (pageKey: string, viewMode: string): Promise<void> => {
+  try {
+    await db.viewModeCache.put({
+      pageKey,
+      viewMode,
+      timestamp: Date.now()
+    });
+  } catch (error) {
+    console.error('写入视图模式缓存失败:', error);
+  }
+};
+
+/**
+ * 清除指定页面的视图模式缓存
+ * @param pageKey 页面标识
+ */
+const clearCache = async (pageKey: string): Promise<void> => {
+  try {
+    await db.viewModeCache.delete(pageKey);
+  } catch (error) {
+    console.error('清除视图模式缓存失败:', error);
+  }
+};
+
+/**
+ * 清除所有视图模式缓存
+ */
+const clearAllCache = async (): Promise<void> => {
+  try {
+    await db.viewModeCache.clear();
+  } catch (error) {
+    console.error('清除所有视图模式缓存失败:', error);
+  }
+};
+
+/**
+ * 获取指定页面的视图模式
+ * @param pageKey 页面标识（如路由路径）
+ * @returns 视图模式值或null
+ */
+const getViewMode = async (pageKey: string): Promise<string | null> => {
+  return await getFromCache(pageKey);
+};
+
+/**
+ * 设置指定页面的视图模式
+ * @param pageKey 页面标识（如路由路径）
+ * @param viewMode 视图模式值
+ */
+const setViewMode = async (pageKey: string, viewMode: string): Promise<void> => {
+  await setToCache(pageKey, viewMode);
+};
+
+/**
+ * 清除指定页面的视图模式缓存
+ * @param pageKey 页面标识
+ */
+const clearViewModeCache = async (pageKey: string): Promise<void> => {
+  await clearCache(pageKey);
+};
+
+/**
+ * 清除所有视图模式缓存
+ */
+const clearAllViewModeCache = async (): Promise<void> => {
+  await clearAllCache();
+};
+
+/**
+ * 获取所有缓存的页面视图模式
+ * @returns 所有缓存的页面视图模式
+ */
+const getAllCachedViewModes = async (): Promise<ViewModeCache[]> => {
+  try {
+    return await db.viewModeCache.toArray();
+  } catch (error) {
+    console.error('获取所有视图模式缓存失败:', error);
+    return [];
+  }
+};
+
+export const CacheViewToggleInfo = {
+  /**
+   * 获取指定页面的视图模式
+   * @param pageKey 页面标识（如路由路径）
+   * @returns 视图模式值或null
+   */
+  getViewMode,
+  /**
+   * 设置指定页面的视图模式
+   * @param pageKey 页面标识（如路由路径）
+   * @param viewMode 视图模式值
+   */
+  setViewMode,
+  /**
+   * 清除指定页面的视图模式缓存
+   * @param pageKey 页面标识
+   */
+  clearViewModeCache,
+  /**
+   * 清除所有视图模式缓存
+   */
+  clearAllViewModeCache,
+  /**
+   * 获取所有缓存的页面视图模式
+   * @returns 所有缓存的页面视图模式
+   */
+  getAllCachedViewModes
+};
+
+export { getViewMode, setViewMode, clearViewModeCache, clearAllViewModeCache };

package/src/utils/MessageContentUtils.ts

@@ -0,0 +1,268 @@
+'use strict';
+
+/**
+ * Copyright (c) 2026 SPACECORE Co.,Ltd. All Rights Reserved.
+ * Author: GitHub Copilot
+ * Desc: 用户消息 content 字段统一封装工具
+ *
+ * 由于 user_message 表只保留 title + content 两列，业务类型/关联ID/跳转等
+ * 信息统一序列化为 JSON 字符串写入 content，前端解析后分类展示与跳转。
+ */
+
+/** 消息大类 */
+export type MessageType = 'project' | 'approval' | 'knowledge' | 'todo' | 'crm';
+
+/** 项目子类型 */
+export type ProjectBizType =
+  | 'file_add'
+  | 'file_update'
+  | 'file_delete'
+  | 'contract_add'
+  | 'contract_delete'
+  | 'contract_update'
+  | 'detail'
+  | 'member_add'
+  | 'member_remove'
+  | 'member_role_change'
+  | 'file_download';
+
+/** 审批子类型 */
+export type ApprovalBizType =
+  | 'submit'
+  | 'approve'
+  | 'reject'
+  | 'cancel'
+  | 'deal';
+
+/** 知识库子类型 */
+export type KnowledgeBizType = 'kb_new';
+
+/** 待办子类型 */
+export type TodoBizType = 'task_assign' | 'task_remind';
+
+/** CRM 子类型 */
+export type CrmBizType = 'customer_transfer_in' | 'customer_transfer_out';
+
+/** 全部业务子类型 */
+export type MessageBizType = ProjectBizType | ApprovalBizType | KnowledgeBizType | TodoBizType | CrmBizType;
+
+/** content 字段结构定义 */
+export interface MessageContent {
+  /** 消息大类 */
+  type: MessageType;
+  /** 业务子类型 */
+  bizType: MessageBizType;
+  /** 关联业务主键（项目ID/审批实例ID/知识文章ID） */
+  id: string;
+  /** 人话描述，前端可直接展示 */
+  text: string;
+  /** 下载地址（相对文件根路径，file_download 成功时存在） */
+  url?: string;
+  /** 下载文件名 */
+  fileName?: string;
+  /** 打包任务 ID */
+  jobId?: string;
+  /** 下载地址过期时间戳（毫秒） */
+  expireAt?: number;
+}
+
+/** 消息大类展示名称 */
+export const MESSAGE_TYPE_LABELS: Record<MessageType, string> = {
+  project: '项目动态',
+  approval: '审批动态',
+  knowledge: '知识库',
+  todo: '待办任务',
+  crm: '客户管理',
+};
+
+/** 项目类业务子类型展示名称 */
+export const PROJECT_BIZ_LABELS: Record<ProjectBizType, string> = {
+  file_add: '文件新增',
+  file_update: '文件更新',
+  file_delete: '文件删除',
+  contract_add: '合同新增',
+  contract_delete: '合同删除',
+  contract_update: '合同更新',
+  detail: '详情更新',
+  member_add: '成员加入',
+  member_remove: '成员移除',
+  member_role_change: '角色变更',
+  file_download: '文件下载',
+};
+
+/** 审批类业务子类型展示名称 */
+export const APPROVAL_BIZ_LABELS: Record<ApprovalBizType, string> = {
+  submit: '审批提交',
+  approve: '审批通过',
+  reject: '审批驳回',
+  cancel: '审批撤销',
+  deal: '产物更新',
+};
+
+/** 知识库类业务子类型展示名称 */
+export const KNOWLEDGE_BIZ_LABELS: Record<KnowledgeBizType, string> = {
+  kb_new: '新增知识',
+};
+
+/** 待办类业务子类型展示名称 */
+export const TODO_BIZ_LABELS: Record<TodoBizType, string> = {
+  task_assign: '任务指派',
+  task_remind: '到期提醒',
+};
+
+/** CRM 类业务子类型展示名称 */
+export const CRM_BIZ_LABELS: Record<CrmBizType, string> = {
+  customer_transfer_in: '客户移交（接收）',
+  customer_transfer_out: '客户移交（移交出）',
+};
+
+/** 项目类 bizType 到项目详情页 tab 的映射 */
+const PROJECT_BIZ_TAB_MAP: Partial<Record<ProjectBizType, string>> = {
+  file_add: 'files',
+  file_update: 'files',
+  file_delete: 'files',
+  contract_add: 'contracts',
+  contract_update: 'contracts',
+  contract_delete: 'contracts',
+  detail: 'detail',
+  member_add: 'members',
+  member_remove: 'members',
+  member_role_change: 'members',
+};
+
+export class MessageContentUtils {
+  /**
+   * 构造消息 content JSON 字符串
+   * @param type 消息大类
+   * @param bizType 业务子类型
+   * @param id 关联业务主键
+   * @param text 人话描述
+   * @returns 序列化后的 JSON 字符串
+   */
+  static buildContent(
+    type: MessageType,
+    bizType: MessageBizType,
+    id: string,
+    text: string,
+  ): string {
+    const content: MessageContent = { type, bizType, id: id || '', text: text || '' };
+    return JSON.stringify(content);
+  }
+
+  /**
+   * 解析消息 content JSON 字符串
+   * @param content content 字段
+   * @returns 解析后的结构，解析失败返回 null
+   */
+  static parseContent(content: string): MessageContent | null {
+    if (!content) {
+      return null;
+    }
+    try {
+      const obj = JSON.parse(content);
+      if (
+        obj &&
+        typeof obj.type === 'string' &&
+        typeof obj.bizType === 'string' &&
+        typeof obj.id === 'string'
+      ) {
+        const parsed: MessageContent = {
+          type: obj.type as MessageType,
+          bizType: obj.bizType as MessageBizType,
+          id: obj.id,
+          text: typeof obj.text === 'string' ? obj.text : '',
+        };
+        if (typeof obj.url === 'string') {
+          parsed.url = obj.url;
+        }
+        if (typeof obj.fileName === 'string') {
+          parsed.fileName = obj.fileName;
+        }
+        if (typeof obj.jobId === 'string') {
+          parsed.jobId = obj.jobId;
+        }
+        if (typeof obj.expireAt === 'number') {
+          parsed.expireAt = obj.expireAt;
+        }
+        return parsed;
+      }
+      return null;
+    } catch (e) {
+      return null;
+    }
+  }
+
+  /** 判断是否为受支持的消息大类 */
+  static isMessageType(type: string): type is MessageType {
+    return Object.prototype.hasOwnProperty.call(MESSAGE_TYPE_LABELS, type);
+  }
+
+  /** 获取消息大类展示名称，未知类型降级为「系统消息」 */
+  static getTypeLabel(type: string): string {
+    return MESSAGE_TYPE_LABELS[type as MessageType] || '系统消息';
+  }
+
+  /** 获取业务子类型展示名称，未知子类型返回空串 */
+  static getBizTypeLabel(type: string, bizType: string): string {
+    switch (type) {
+      case 'project':
+        return PROJECT_BIZ_LABELS[bizType as ProjectBizType] || '';
+      case 'approval':
+        return APPROVAL_BIZ_LABELS[bizType as ApprovalBizType] || '';
+      case 'knowledge':
+        return KNOWLEDGE_BIZ_LABELS[bizType as KnowledgeBizType] || '';
+      case 'todo':
+        return TODO_BIZ_LABELS[bizType as TodoBizType] || '';
+      case 'crm':
+        return CRM_BIZ_LABELS[bizType as CrmBizType] || '';
+      default:
+        return '';
+    }
+  }
+
+  /**
+   * 获取消息正文：优先展示后端下发的人话 text，
+   * text 缺失时降级为业务子类型名称。
+   */
+  static getDisplayText(content: MessageContent | null | undefined): string {
+    if (!content) {
+      return '';
+    }
+    return content.text || MessageContentUtils.getBizTypeLabel(content.type, content.bizType);
+  }
+
+  /**
+   * 获取消息关联业务页面的跳转路由（含查询参数）。
+   * project    -> /project?id=xxx&tab=files|contracts|members|detail
+   * approval   -> /approval?instanceId=xxx
+   * knowledge  -> /knowledge?id=xxx
+   * todo       -> /todo?todoId=xxx（待办页读取参数后自动打开任务抽屉）
+   * 未知类型或缺少关联ID时返回 null。
+   */
+  static getJumpRoute(content: MessageContent | null | undefined): string | null {
+    if (!content || !content.id) {
+      return null;
+    }
+    const id = encodeURIComponent(content.id);
+    switch (content.type) {
+      case 'project': {
+        // 文件夹打包下载通知不跳转，由消息中心直接触发下载
+        if (content.bizType === 'file_download') {
+          return null;
+        }
+        const tab = PROJECT_BIZ_TAB_MAP[content.bizType as ProjectBizType];
+        return `/project?id=${id}${tab ? `&tab=${tab}` : ''}`;
+      }
+      case 'approval':
+        return `/approval?instanceId=${id}`;
+      case 'knowledge':
+        return `/knowledge?id=${id}`;
+      case 'todo':
+        return `/todo?todoId=${id}`;
+      case 'crm':
+        return `/crm?id=${id}`;
+      default:
+        return null;
+    }
+  }
+}

package/src/utils/clipboard.ts

@@ -0,0 +1,70 @@
+/**
+ * 复制文本到剪贴板。
+ * 优先尝试 navigator.clipboard（HTTPS/localhost 安全上下文可用），
+ * 若不可用或调用失败（如部分移动端 webview 权限/手势问题），自动回退到 document.execCommand('copy')。
+ */
+export async function copyToClipboard(text: string): Promise<void> {
+  // 1. 优先尝试 Clipboard API。注意：即使存在也可能 reject，因此失败需继续走兜底。
+  if (navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
+    try {
+      await navigator.clipboard.writeText(text);
+      return;
+    } catch {
+      // 忽略，进入 execCommand 兜底
+    }
+  }
+
+  // 2. 兜底：临时 textarea + execCommand('copy')，兼容 HTTP 内网及 iOS/Android 移动端
+  const succeeded = copyViaExecCommand(text);
+  if (!succeeded) {
+    throw new Error('复制到剪贴板失败');
+  }
+}
+
+function copyViaExecCommand(text: string): boolean {
+  const textarea = document.createElement('textarea');
+  textarea.value = text;
+  // iOS 下 readonly 会阻止选中，先设为可编辑；复制后再恢复
+  textarea.setAttribute('contenteditable', 'true');
+  // 隐藏元素，避免影响页面布局与滚动（不能用 display:none，否则无法选中）
+  textarea.style.position = 'fixed';
+  textarea.style.top = '0';
+  textarea.style.left = '0';
+  textarea.style.width = '1px';
+  textarea.style.height = '1px';
+  textarea.style.padding = '0';
+  textarea.style.border = 'none';
+  textarea.style.outline = 'none';
+  textarea.style.boxShadow = 'none';
+  textarea.style.background = 'transparent';
+  textarea.style.opacity = '0';
+  document.body.appendChild(textarea);
+
+  const isIOS = /ipad|iphone|ipod/i.test(navigator.userAgent);
+  let succeeded = false;
+
+  try {
+    if (isIOS) {
+      // iOS Safari：需用 Range 选中 contenteditable 元素
+      const selection = document.getSelection();
+      const range = document.createRange();
+      range.selectNodeContents(textarea);
+      selection?.removeAllRanges();
+      selection?.addRange(range);
+      textarea.setSelectionRange(0, text.length);
+    } else {
+      // 其他平台：focus + select
+      textarea.focus();
+      textarea.select();
+      textarea.setSelectionRange(0, text.length);
+    }
+
+    succeeded = document.execCommand('copy');
+  } catch {
+    succeeded = false;
+  } finally {
+    document.body.removeChild(textarea);
+  }
+
+  return succeeded;
+}

package/src/utils/companyEmail.ts

@@ -0,0 +1,19 @@
+// 公司邮箱域名来自前端环境变量，多个域名用逗号分隔。
+const companyEmailRules = (import.meta.env.VITE_COMPANY_EMAIL_DOMAINS || '')
+  .split(',')
+  .map((rule: string) => rule.trim().toLowerCase().replace(/^@/, ''))
+  .filter(Boolean);
+
+const normalizeEmail = (email?: string) => (email || '').trim().toLowerCase();
+
+export const getCompanyEmailRuleText = () => companyEmailRules.join('、');
+
+export const isCompanyEmail = (email?: string) => {
+  const normalizedEmail = normalizeEmail(email);
+  const domain = normalizedEmail.split('@')[1];
+
+  // 兼容两种配置：完整邮箱地址或邮箱域名。
+  return companyEmailRules.some((rule: string) => (
+    rule.includes('@') ? rule === normalizedEmail : Boolean(domain && rule === domain)
+  ));
+};

package/src/utils/forbidDebugger.ts

@@ -0,0 +1,59 @@
+'use strict'
+
+/**
+ * Copyright (c) 2021 bpui All Rights Reserved.
+ * Author: brian.li
+ * Date: 2021-08-25 14:24
+ * Desc:
+ */
+
+/**
+ * @descs 禁止浏览器调试.
+ */
+export function forbidDebugger() {
+  const check = function() {
+    function doCheck(a:number) {
+      if (('' + a / a)['length'] !== 1 || a % 20 === 0) {
+        ;(function() {}['constructor']('debugger')())
+      } else {
+        ;(function() {}['constructor']('debugger')())
+      }
+      doCheck(++a)
+    }
+    try {
+      doCheck(0)
+    } catch (err) { ; }
+  }
+
+  const checkDebuggerWindow = function() {
+    const thresholdW = 160 // 打开控制台的宽或高阈值
+    const thresholdH = 160 + 200 // 打开控制台的宽或高阈值
+    if (
+      window.outerWidth - window.innerWidth > thresholdW ||
+      window.outerHeight - window.innerHeight > thresholdH
+    ) {
+      window.close()
+      ;(window.location as any) = 'about:blank'
+    }
+  }
+
+  setInterval(function() {
+    if (!__debug) {
+      checkDebuggerWindow()
+      check()
+    }
+  }, 5000)
+
+  if (!__debug) {
+    checkDebuggerWindow()
+    check()
+
+    // f12.
+    window.onkeydown = window.onkeyup = window.onkeypress = function (event) {
+      if (event.keyCode === 123) {
+        event.preventDefault()
+        window.event.returnValue = false
+      }
+    }
+  }
+}

package/src/utils/formatters.ts

@@ -0,0 +1,94 @@
+/**
+ * e.g. 2026/04/17
+ * @param date 
+ * @returns 
+ */
+
+const initalDate = 0; // new Date('1970-01-01T08:00:00.000Z').getTime();
+
+export const formatDate = (date: Date | string): string => {
+  if (!date) return '无';
+  if (typeof date === 'string') {
+    date = new Date(date);
+  }
+
+  if (date.getTime() == initalDate) {
+    return '无';
+  }
+
+  if (isNaN(date.getTime())) {
+    return '无';
+  }
+
+
+  return date.toLocaleDateString('zh-CN', {
+    year: 'numeric',
+    month: '2-digit',
+    day: 'numeric'
+  });
+};
+
+/**
+ * e.g. 2026/04/17 20:41
+ * @param date 
+ * @returns 
+ */
+export const formatDatetime = (date: Date|string): string => {
+  if (!date) return '无';
+  if (typeof date === 'string') {
+    date = new Date(date);
+  }
+  
+  if (date.getTime() == initalDate) {
+    return '无';
+  }
+
+  if (isNaN(date.getTime())) {
+    return '无';
+  }
+  
+  
+  return date.toLocaleDateString('zh-CN', {
+    year: 'numeric',
+    month: '2-digit',
+    day: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit'
+  });
+};
+
+export const formatCurrency = (amount: number): string => {
+  return new Intl.NumberFormat('zh-CN', {
+    style: 'currency',
+    currency: 'CNY'
+  }).format(amount);
+};
+
+/**
+ * 返回文件大小
+ */
+export const formatDisksize = (filesize: number): string => {
+  if (!filesize) return '0 KB';
+
+  filesize = (filesize / 1024);
+  if (filesize < 1024) {
+    if (filesize.toFixed(1).endsWith('.0')) {
+      return filesize.toFixed(2) + ' KB';
+    }
+    return filesize.toFixed(1) + ' KB';
+  }
+
+  filesize = (filesize / 1024);
+  if (filesize < 1024) {
+    if (filesize.toFixed(1).endsWith('.0')) {
+      return filesize.toFixed(2) + ' MB';
+    }
+    return filesize.toFixed(1) + ' MB';
+  }
+
+  filesize = (filesize / 1024);
+  if (filesize.toFixed(1).endsWith('.0')) {
+    return filesize.toFixed(2) + ' GB';
+  }
+  return filesize.toFixed(1) + ' GB';
+};