web/src/helpers/secureApiCall.js

/*

Copyright (C) 2025 QuantumNous



This program is free software: you can redistribute it and/or modify

it under the terms of the GNU Affero General Public License as

published by the Free Software Foundation, either version 3 of the

License, or (at your option) any later version.



This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

GNU Affero General Public License for more details.



You should have received a copy of the GNU Affero General Public License

along with this program. If not, see <https://www.gnu.org/licenses/>.



For commercial licensing, please contact support@quantumnous.com

*/

/**

 * 安全 API 调用包装器

 * 自动处理需要验证的 403 错误，透明地触发验证流程

 */

/**

 * 检查错误是否是需要安全验证的错误

 * @param {Error} error - 错误对象

 * @returns {boolean}

 */
export function isVerificationRequiredError(error) {
  if (!error.response) return false;

  const { status, data } = error.response;

  // 检查是否是 403 错误且包含验证相关的错误码
  if (status === 403 && data) {
    const verificationCodes = [
      'VERIFICATION_REQUIRED',
      'VERIFICATION_EXPIRED',
      'VERIFICATION_INVALID'
    ];

    return verificationCodes.includes(data.code);
  }

  return false;
}

/**

 * 从错误中提取验证需求信息

 * @param {Error} error - 错误对象

 * @returns {Object} 验证需求信息

 */
export function extractVerificationInfo(error) {
  const data = error.response?.data || {};

  return {
    code: data.code,
    message: data.message || '需要安全验证',
    required: true
  };
}