mirror of
https://github.com/BTMuli/TeyvatGuide.git
synced 2025-12-06 08:32:51 +08:00
225 lines
6.6 KiB
TypeScript
225 lines
6.6 KiB
TypeScript
/**
|
||
* @file utils/UIGF.ts
|
||
* @description UIGF工具类
|
||
* @since Beta v0.5.5
|
||
*/
|
||
|
||
import { app, path } from "@tauri-apps/api";
|
||
import { readTextFile, writeTextFile } from "@tauri-apps/plugin-fs";
|
||
import { Ajv } from "ajv";
|
||
import { ErrorObject } from "ajv/lib/types/index.js";
|
||
|
||
import showSnackbar from "../components/func/snackbar.js";
|
||
import { Uigf4Schema, UigfSchema } from "../data/index.js";
|
||
import TSUserGacha from "../plugins/Sqlite/modules/userGacha.js";
|
||
|
||
import TGLogger from "./TGLogger.js";
|
||
import { timestampToDate } from "./toolFunc.js";
|
||
|
||
/**
|
||
* @description 获取 UIGF 时区
|
||
* @since Beta v0.3.5
|
||
* @param {string} uid - UID
|
||
* @returns {number} 时区
|
||
*/
|
||
function getUigfTimeZone(uid: string): number {
|
||
if (uid.startsWith("6")) return -5;
|
||
if (uid.startsWith("7")) return 1;
|
||
return 8;
|
||
}
|
||
|
||
/**
|
||
* @description 获取 UIGF 头部信息
|
||
* @since Beta v0.4.4
|
||
* @param {string} uid - UID
|
||
* @returns {Promise<TGApp.Plugins.UIGF.Info>}
|
||
*/
|
||
async function getUigfHeader(uid: string): Promise<TGApp.Plugins.UIGF.Info> {
|
||
const stamp = Date.now();
|
||
return {
|
||
uid,
|
||
lang: "zh-cn",
|
||
uigf_version: "v3.0",
|
||
export_timestamp: Math.floor(stamp / 1000),
|
||
export_time: timestampToDate(stamp),
|
||
export_app: "TeyvatGuide",
|
||
export_app_version: await app.getVersion(),
|
||
region_time_zone: getUigfTimeZone(uid),
|
||
};
|
||
}
|
||
|
||
/**
|
||
* @description 获取 UIGF v4.0 头部信息
|
||
* @since Beta v0.5.1
|
||
* @returns {TGApp.Plugins.UIGF.Info4} UIGF v4.0 头部信息
|
||
*/
|
||
async function getUigf4Header(): Promise<TGApp.Plugins.UIGF.Info4> {
|
||
const stamp = Date.now();
|
||
return {
|
||
export_timestamp: Math.floor(stamp / 1000).toString(),
|
||
export_app: "TeyvatGuide",
|
||
export_app_version: await app.getVersion(),
|
||
version: "v4.0",
|
||
lang: "zh-cn",
|
||
};
|
||
}
|
||
|
||
/**
|
||
* @description 数据转换-数据库到 UIGF
|
||
* @since Alpha v0.2.3
|
||
* @param {TGApp.Sqlite.GachaRecords.SingleTable[]} data - 数据库数据
|
||
* @returns {TGApp.Plugins.UIGF.GachaItem[]} UIGF 数据
|
||
*/
|
||
function convertDataToUigf(
|
||
data: TGApp.Sqlite.GachaRecords.SingleTable[],
|
||
): TGApp.Plugins.UIGF.GachaItem[] {
|
||
return data.map((gacha) => {
|
||
return {
|
||
gacha_type: gacha.gachaType,
|
||
item_id: gacha.itemId,
|
||
count: gacha.count,
|
||
time: gacha.time,
|
||
name: gacha.name,
|
||
item_type: gacha.type,
|
||
rank_type: gacha.rank,
|
||
id: gacha.id,
|
||
uigf_gacha_type: gacha.uigfType,
|
||
};
|
||
});
|
||
}
|
||
|
||
/**
|
||
* @description 检测是否存在 UIGF 数据，采用 ajv 验证 schema
|
||
* @since Beta v0.5.0
|
||
* @param {string} path - UIGF 数据路径
|
||
* @param {boolean} isVersion4 - 是否为 UIGF v4.0
|
||
* @returns {Promise<boolean>} 是否存在 UIGF 数据
|
||
*/
|
||
export async function verifyUigfData(path: string, isVersion4: boolean = false): Promise<boolean> {
|
||
const fileData: string = await readTextFile(path);
|
||
try {
|
||
const fileJson = JSON.parse(fileData);
|
||
if (isVersion4) return validateUigf4Data(fileJson);
|
||
return validateUigfData(fileJson);
|
||
} catch (e) {
|
||
showSnackbar.error(`UIGF 数据格式错误 ${e}`);
|
||
await TGLogger.Error(`UIGF 数据格式错误，文件路径：${path}`);
|
||
await TGLogger.Error(`错误信息 ${e}`);
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @description 验证 UIGF 数据
|
||
* @since Beta v0.5.1
|
||
* @param {object} data - UIGF 数据
|
||
* @returns {boolean} 是否验证通过
|
||
*/
|
||
function validateUigfData(data: object): boolean {
|
||
const ajv = new Ajv();
|
||
const validate = ajv.compile(UigfSchema);
|
||
if (!validate(data)) {
|
||
if (!validate.errors || validate.errors.length === 0) return false;
|
||
const error: ErrorObject = validate.errors[0];
|
||
showSnackbar.error(`${error.instancePath || error.schemaPath} ${error.message}`);
|
||
return false;
|
||
}
|
||
const parsedData: TGApp.Plugins.UIGF.Schema = <TGApp.Plugins.UIGF.Schema>data;
|
||
if (parsedData.info.uigf_version < "v2.3") {
|
||
showSnackbar.error("UIGF 版本过低，请使用 v2.3 或以上版本");
|
||
return false;
|
||
}
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* @description 验证 UIGF v4.0 数据
|
||
* @since Beta v0.5.0
|
||
* @param {object} data - UIGF 数据
|
||
* @returns {boolean} 是否验证通过
|
||
*/
|
||
function validateUigf4Data(data: object): boolean {
|
||
const ajv = new Ajv();
|
||
const validate4 = ajv.compile(Uigf4Schema);
|
||
if (!validate4(data)) {
|
||
if (!validate4.errors || validate4.errors.length === 0) return false;
|
||
const error: ErrorObject = validate4.errors[0];
|
||
showSnackbar.error(`${error.instancePath || error.schemaPath} ${error.message}`);
|
||
return false;
|
||
}
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* @description 读取 UIGF 数据
|
||
* @since Beta v0.5.0
|
||
* @param {string} userPath - UIGF 数据路径
|
||
* @returns {Promise<TGApp.Plugins.UIGF.Schema>} UIGF 数据
|
||
*/
|
||
export async function readUigfData(userPath: string): Promise<TGApp.Plugins.UIGF.Schema> {
|
||
const fileData: string = await readTextFile(userPath);
|
||
return JSON.parse(fileData);
|
||
}
|
||
|
||
/**
|
||
* @description 读取 UIGF 4.0 数据
|
||
* @since Beta v0.5.0
|
||
* @param {string} userPath - UIGF 数据路径
|
||
* @returns {Promise<TGApp.Plugins.UIGF.Schema4>} UIGF 数据
|
||
*/
|
||
export async function readUigf4Data(userPath: string): Promise<TGApp.Plugins.UIGF.Schema4> {
|
||
const fileData: string = await readTextFile(userPath);
|
||
return JSON.parse(fileData);
|
||
}
|
||
|
||
/**
|
||
* @description 导出 UIGF 数据
|
||
* @since Beta v0.5.0
|
||
* @param {string} uid - UID
|
||
* @param {TGApp.Sqlite.GachaRecords.SingleTable[]} gachaList - 祈愿列表
|
||
* @param {string} savePath - 保存路径
|
||
* @returns {Promise<void>}
|
||
*/
|
||
export async function exportUigfData(
|
||
uid: string,
|
||
gachaList: TGApp.Sqlite.GachaRecords.SingleTable[],
|
||
savePath?: string,
|
||
): Promise<void> {
|
||
const UigfData = {
|
||
info: await getUigfHeader(uid),
|
||
list: convertDataToUigf(gachaList),
|
||
};
|
||
const filePath = savePath ?? `${await path.appLocalDataDir()}userData\\UIGF_${uid}.json`;
|
||
await writeTextFile(filePath, JSON.stringify(UigfData));
|
||
}
|
||
|
||
/**
|
||
* @description 导出 UIGF v4.0 数据
|
||
* @since Beta v0.5.0
|
||
* @param {string} filePath - 保存路径
|
||
* @param {string} uid - UID，如果为空表示导出所有数据
|
||
* @returns {Promise<void>}
|
||
*/
|
||
export async function exportUigf4Data(filePath: string, uid?: string): Promise<void> {
|
||
const UigfData: TGApp.Plugins.UIGF.Schema4 = {
|
||
info: await getUigf4Header(),
|
||
hk4e: [],
|
||
};
|
||
let uidList: string[] = [];
|
||
if (uid) {
|
||
uidList.push(uid);
|
||
} else {
|
||
uidList = await TSUserGacha.getUidList();
|
||
}
|
||
for (const uid of uidList) {
|
||
const gachaList = await TSUserGacha.getGachaRecords(uid);
|
||
const data: TGApp.Plugins.UIGF.GachaHk4e = {
|
||
uid: uid,
|
||
timezone: getUigfTimeZone(uid),
|
||
list: convertDataToUigf(gachaList),
|
||
};
|
||
UigfData.hk4e.push(data);
|
||
}
|
||
await writeTextFile(filePath, JSON.stringify(UigfData));
|
||
}
|