OpenFlare/frontend/lib/utils.ts

import { type ClassValue, clsx } from 'clsx';
import { twMerge } from 'tailwind-merge';

export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}

export function formatDateTime(dateStr: string | Date) {
  try {
    const date = typeof dateStr === 'string' ? new Date(dateStr) : dateStr;
    return new Intl.DateTimeFormat('zh-CN', {
      timeZone: 'Asia/Shanghai',
      year: 'numeric',
      month: '2-digit',
      day: '2-digit',
      hour: '2-digit',
      minute: '2-digit',
      hour12: false,
    }).format(date);
  } catch {
    return String(dateStr);
  }
}

/**
 * 格式化日期为本地时间字符串（带时区）
 * @param date 要格式化的日期
 * @returns 格式化后的日期字符串，如 "2024-01-15T00:00:00+08:00"
 */
export function formatLocalDate(date: Date): string {
  const year = date.getFullYear();
  const month = String(date.getMonth() + 1).padStart(2, '0');
  const day = String(date.getDate()).padStart(2, '0');
  const hours = String(date.getHours()).padStart(2, '0');
  const minutes = String(date.getMinutes()).padStart(2, '0');
  const seconds = String(date.getSeconds()).padStart(2, '0');
  return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}+08:00`;
}

type Base64Buffer = {
  from: (
    input: string,
    encoding: 'utf-8',
  ) => { toString: (encoding: 'base64') => string };
};

/**
 * Base64 编码
 * @param value 待编码字符串
 * @returns Base64 编码后的字符串
 */
export function encodeBase64(value: string): string {
  if (typeof globalThis.btoa === 'function') {
    return globalThis.btoa(value);
  }

  const bufferConstructor = (
    globalThis as typeof globalThis & { Buffer?: Base64Buffer }
  ).Buffer;
  if (bufferConstructor) {
    return bufferConstructor.from(value, 'utf-8').toString('base64');
  }

  throw new Error('当前环境不支持 Base64 编码');
}

/**
 * 生成交易缓存的唯一键
 * @param params 交易查询参数
 * @returns 缓存键字符串
 */
export function generateTransactionCacheKey(params: {
  types?: string[];
  statuses?: string[];
  payee_transfer_status?: string;
  client_id?: string;
  page?: number;
  page_size?: number;
  startTime?: string;
  endTime?: string;
  id?: string;
  order_name?: string;
  payer_username?: string;
  payee_username?: string;
}): string {
  const typesKey = params.types?.length ? params.types.sort().join(',') : 'all';
  const statusesKey = params.statuses?.length
    ? params.statuses.sort().join(',')
    : 'all';
  const transferStatusKey = params.payee_transfer_status || 'all';
  const clientIdKey = params.client_id || 'all';
  const startTimeKey = params.startTime || 'no-start';
  const endTimeKey = params.endTime || 'no-end';
  const idKey = params.id || 'no-id';
  const orderNameKey = params.order_name || 'no-name';
  const payerKey = params.payer_username || 'no-payer';
  const payeeKey = params.payee_username || 'no-payee';

  return `${typesKey}_${statusesKey}_${transferStatusKey}_${clientIdKey}_${params.page}_${params.page_size}_${startTimeKey}_${endTimeKey}_${idKey}_${orderNameKey}_${payerKey}_${payeeKey}`;
}

/**
 * 验证并净化重定向目标 URL，防止 Open Redirect 和 XSS 攻击。
 * 只允许以单个斜杠 "/" 开头的相对路径，拒绝 "//"、协议、反斜杠、控制字符等编码变体。
 */
export function safeRedirectTarget(
  url: string | null | undefined,
  fallback = '/',
): string {
  if (!url) return fallback;

  // 1. 拒绝包含控制字符、空白字符或反斜杠的 URL
  if (/[\u0000-\u001F\u007F-\u009F\s\\]/.test(url)) {
    return fallback;
  }

  // 2. 必须以单个 '/' 开头，且不能以 '//' 开头
  if (!url.startsWith('/') || url.startsWith('//')) {
    return fallback;
  }

  // 3. 递归 URL 解码并检测潜在的绕过载荷
  try {
    let decoded = url;
    let prev = '';
    let attempts = 0;
    while (decoded !== prev && decoded.includes('%') && attempts < 3) {
      prev = decoded;
      decoded = decodeURIComponent(decoded);
      attempts++;
    }

    // 检查解码后的内容是否包含控制字符、空白字符或反斜杠
    if (/[\u0000-\u001F\u007F-\u009F\s\\]/.test(decoded)) {
      return fallback;
    }

    // 检查解码后的内容是否以单个 '/' 开头，且不能以 '//' 开头
    if (!decoded.startsWith('/') || decoded.startsWith('//')) {
      return fallback;
    }

    // 提取路径部分（即问号 ? 或井号 # 之前的内容），确保其中不含冒号（防止 scheme）、双斜杠或反斜杠
    const pathPart = decoded.split(/[?#]/)[0];
    if (
      pathPart.includes(':') ||
      pathPart.includes('//') ||
      pathPart.includes('\\')
    ) {
      return fallback;
    }
  } catch {
    return fallback;
  }

  return url;
}