Add FireflyGo sync mode, extra_data controls and Enka import
- js/modes.js: per-backend capability matrix (GaCy GO / FireflyGo / RobinSR) - js/firefly.js: POST /sync payload builder + extra_data normaliser - js/enka-import.js: enka.network -> FreeSR converter with merge/replace - app.js: mode-aware UI, firefly transport, Enka import, extra_data form - index.html: enable FireflyGo, add Enka import + FireflyGo controls cards - i18n: Thai/English strings for every new label, message and error - vercel.json: /api/enka/:uid rewrite; scripts/dev-server.cjs for local dev
This commit is contained in:
CAtlas0784 committed
1 parent
03fc1b82bb
commit
8eb519023a
17 files changed
+2174
-162
No files matched your search
+238
@@ -0,0 +1,238 @@
|
||||
// FireflyGo (Firefly_Srtools) transport helpers.
|
||||
//
|
||||
// FireflyGo exposes a single push endpoint, POST <base>/sync, that accepts
|
||||
// { username, password, data?: FreeSRJson, extra_data?: ExtraData }. A request
|
||||
// without `data` is the "connect" probe and only returns the current extra data.
|
||||
// Reference: https://git.kain.io.vn/Firefly-Shelter/Firefly_Srtools
|
||||
|
||||
export const FIREFLY_SYNC_PATH = '/sync';
|
||||
export const FIREFLY_DEFAULT_BASE_URL = 'http://localhost:21000';
|
||||
|
||||
/**
|
||||
* FireflyGo only listens on POST <base>/sync and ignores the GaCy-style port
|
||||
* paths, so the UI's base URL is turned into a full sync endpoint here.
|
||||
*/
|
||||
export function fireflySyncUrl(apiUrl) {
|
||||
const base = String(apiUrl ?? '').trim().replace(/\/+$/, '') || FIREFLY_DEFAULT_BASE_URL;
|
||||
if (/\/sync$/i.test(base)) return base;
|
||||
return `${base}${FIREFLY_SYNC_PATH}`;
|
||||
}
|
||||
|
||||
export const FIREFLY_EXTRA_FALLBACK = {
|
||||
multi_path: {
|
||||
main: 0,
|
||||
march_7: 0,
|
||||
multi_path_main: [],
|
||||
multi_path_march_7: []
|
||||
},
|
||||
setting: {
|
||||
censorship: false,
|
||||
cm: false,
|
||||
first_person: false,
|
||||
hide_ui: false,
|
||||
invasion_percent: 0
|
||||
},
|
||||
challenge: {
|
||||
skip_node: 0,
|
||||
challenge_peak_group_id: 0,
|
||||
challenge_peak_group_id_list: []
|
||||
},
|
||||
theory_craft: {
|
||||
hp: {},
|
||||
cycle_count: 0,
|
||||
mode: false,
|
||||
stage_id: 0,
|
||||
custom_lineup: []
|
||||
},
|
||||
lua: null
|
||||
};
|
||||
|
||||
function num(value, fallback = 0) {
|
||||
const parsed = Number(value);
|
||||
return Number.isFinite(parsed) ? parsed : fallback;
|
||||
}
|
||||
|
||||
function bool(value) {
|
||||
return value === true || value === 1 || value === 'true' || value === '1';
|
||||
}
|
||||
|
||||
function numberList(value) {
|
||||
if (Array.isArray(value)) {
|
||||
return value.map((entry) => num(entry)).filter((entry) => Number.isFinite(entry));
|
||||
}
|
||||
if (typeof value === 'string') {
|
||||
return value
|
||||
.split(/[\s,;]+/)
|
||||
.map((entry) => entry.trim())
|
||||
.filter(Boolean)
|
||||
.map((entry) => num(entry))
|
||||
.filter((entry) => Number.isFinite(entry));
|
||||
}
|
||||
return [];
|
||||
}
|
||||
|
||||
function cloneJson(value) {
|
||||
return JSON.parse(JSON.stringify(value));
|
||||
}
|
||||
|
||||
/**
|
||||
* Normalises whatever the server returned (or the user typed) into the shape
|
||||
* FireflyGo expects. Returns null when there is nothing usable so a sync never
|
||||
* sends a bogus `extra_data` block.
|
||||
*/
|
||||
export function normalizeExtraData(raw) {
|
||||
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return null;
|
||||
|
||||
const extra = cloneJson(raw);
|
||||
const multiPath = extra.multi_path && typeof extra.multi_path === 'object' ? extra.multi_path : {};
|
||||
extra.multi_path = {
|
||||
main: num(multiPath.main),
|
||||
march_7: num(multiPath.march_7),
|
||||
multi_path_main: numberList(multiPath.multi_path_main),
|
||||
multi_path_march_7: numberList(multiPath.multi_path_march_7)
|
||||
};
|
||||
|
||||
const setting = extra.setting && typeof extra.setting === 'object' ? extra.setting : {};
|
||||
extra.setting = {
|
||||
...setting,
|
||||
censorship: bool(setting.censorship),
|
||||
cm: bool(setting.cm),
|
||||
first_person: bool(setting.first_person),
|
||||
hide_ui: bool(setting.hide_ui),
|
||||
invasion_percent: num(setting.invasion_percent)
|
||||
};
|
||||
|
||||
const challenge = extra.challenge && typeof extra.challenge === 'object' ? extra.challenge : {};
|
||||
extra.challenge = {
|
||||
skip_node: num(challenge.skip_node),
|
||||
challenge_peak_group_id: num(challenge.challenge_peak_group_id),
|
||||
challenge_peak_group_id_list: numberList(challenge.challenge_peak_group_id_list)
|
||||
};
|
||||
|
||||
if (extra.theory_craft && typeof extra.theory_craft === 'object') {
|
||||
const theory = extra.theory_craft;
|
||||
extra.theory_craft = {
|
||||
hp: theory.hp && typeof theory.hp === 'object' && !Array.isArray(theory.hp) ? theory.hp : {},
|
||||
cycle_count: num(theory.cycle_count),
|
||||
mode: bool(theory.mode),
|
||||
stage_id: num(theory.stage_id),
|
||||
custom_lineup: numberList(theory.custom_lineup)
|
||||
};
|
||||
}
|
||||
|
||||
if (extra.lua !== null && extra.lua !== undefined && typeof extra.lua !== 'string') {
|
||||
extra.lua = String(extra.lua);
|
||||
}
|
||||
if (extra.lua === undefined) extra.lua = null;
|
||||
|
||||
return extra;
|
||||
}
|
||||
|
||||
function normalizeAnchorMap(skillsByAnchorType, skills) {
|
||||
if (skillsByAnchorType && typeof skillsByAnchorType === 'object' && !Array.isArray(skillsByAnchorType)) {
|
||||
const entries = Object.entries(skillsByAnchorType)
|
||||
.map(([key, value]) => [String(key), num(value)])
|
||||
.filter(([key]) => key);
|
||||
if (entries.length > 0) return Object.fromEntries(entries);
|
||||
}
|
||||
// Derive the anchor map from point ids when the save does not carry one.
|
||||
const derived = {};
|
||||
Object.entries(skills || {}).forEach(([pointId, level]) => {
|
||||
const suffix = String(pointId).slice(-3);
|
||||
const anchor = /^2\d{2}$/.test(suffix)
|
||||
? '9'
|
||||
: ({ '001': '1', '002': '2', '003': '3', '004': '4', '007': '5', '101': '6', '102': '7', '103': '8' }[suffix] || '');
|
||||
if (!anchor) return;
|
||||
if (derived[anchor] === undefined || num(level) > derived[anchor]) derived[anchor] = num(level);
|
||||
});
|
||||
return Object.keys(derived).length > 0 ? derived : undefined;
|
||||
}
|
||||
|
||||
function normalizeBattleConfig(battleConfig) {
|
||||
const source = battleConfig && typeof battleConfig === 'object' ? battleConfig : {};
|
||||
return {
|
||||
battle_type: typeof source.battle_type === 'string' && source.battle_type ? source.battle_type : 'DEFAULT',
|
||||
blessings: Array.isArray(source.blessings) ? source.blessings : [],
|
||||
custom_stats: Array.isArray(source.custom_stats) ? source.custom_stats : [],
|
||||
cycle_count: num(source.cycle_count),
|
||||
stage_id: num(source.stage_id),
|
||||
path_resonance_id: num(source.path_resonance_id),
|
||||
monsters: Array.isArray(source.monsters) ? source.monsters : []
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts the app's FreeSR snapshot into the exact payload FireflyGo's
|
||||
* converter produces: avatars keyed by id, flat lightcone/relic arrays with
|
||||
* sequential internal uids, and a stripped battle_config.
|
||||
*/
|
||||
export function buildSyncPayload(freesr) {
|
||||
const source = freesr && typeof freesr === 'object' ? freesr : {};
|
||||
const avatars = {};
|
||||
|
||||
Object.entries(source.avatars || {}).forEach(([key, avatar]) => {
|
||||
if (!avatar || typeof avatar !== 'object') return;
|
||||
const avatarId = num(avatar.avatar_id, num(key));
|
||||
if (!avatarId) return;
|
||||
const skills = { ...(avatar.data?.skills || {}) };
|
||||
const skillsByAnchorType = normalizeAnchorMap(avatar.data?.skills_by_anchor_type, skills);
|
||||
const exRanks = Array.isArray(avatar.data?.ex_rank_id_list) ? avatar.data.ex_rank_id_list.filter((id) => num(id) > 0) : [];
|
||||
|
||||
avatars[String(avatarId)] = {
|
||||
owner_uid: num(avatar.owner_uid),
|
||||
avatar_id: avatarId,
|
||||
data: {
|
||||
rank: num(avatar.data?.rank),
|
||||
skills,
|
||||
...(skillsByAnchorType ? { skills_by_anchor_type: skillsByAnchorType } : {}),
|
||||
...(exRanks.length > 0 ? { ex_rank_id_list: exRanks } : {})
|
||||
},
|
||||
level: num(avatar.level),
|
||||
promotion: num(avatar.promotion),
|
||||
techniques: Array.isArray(avatar.techniques) ? avatar.techniques : [],
|
||||
sp_value: num(avatar.sp_value),
|
||||
sp_max: num(avatar.sp_max),
|
||||
...(num(avatar.enhanced_id) > 0 ? { enhanced_id: num(avatar.enhanced_id) } : {})
|
||||
};
|
||||
});
|
||||
|
||||
const lightcones = (Array.isArray(source.lightcones) ? source.lightcones : [])
|
||||
.filter((lc) => lc && num(lc.item_id) > 0)
|
||||
.map((lc, index) => ({
|
||||
level: num(lc.level),
|
||||
item_id: num(lc.item_id),
|
||||
equip_avatar: num(lc.equip_avatar),
|
||||
rank: num(lc.rank),
|
||||
promotion: num(lc.promotion),
|
||||
internal_uid: Number.isFinite(Number(lc.internal_uid)) ? num(lc.internal_uid) : index
|
||||
}));
|
||||
|
||||
const relics = (Array.isArray(source.relics) ? source.relics : [])
|
||||
.filter((relic) => relic && num(relic.relic_id) > 0)
|
||||
.map((relic, index) => ({
|
||||
level: num(relic.level),
|
||||
relic_id: num(relic.relic_id),
|
||||
relic_set_id: num(relic.relic_set_id),
|
||||
main_affix_id: num(relic.main_affix_id),
|
||||
sub_affixes: (Array.isArray(relic.sub_affixes) ? relic.sub_affixes : [])
|
||||
.map((sub) => ({
|
||||
sub_affix_id: num(sub?.sub_affix_id),
|
||||
count: num(sub?.count),
|
||||
step: num(sub?.step)
|
||||
}))
|
||||
.filter((sub) => sub.sub_affix_id > 0),
|
||||
internal_uid: Number.isFinite(Number(relic.internal_uid)) ? num(relic.internal_uid) : index,
|
||||
equip_avatar: num(relic.equip_avatar)
|
||||
}));
|
||||
|
||||
const payload = {
|
||||
lightcones,
|
||||
relics,
|
||||
avatars,
|
||||
battle_config: normalizeBattleConfig(source.battle_config)
|
||||
};
|
||||
if (Array.isArray(source.loadout) && source.loadout.length > 0) {
|
||||
payload.loadout = source.loadout;
|
||||
}
|
||||
return payload;
|
||||
}
|
||||
Reference in new issue
Block a user