Hide_D
fc7de05017
중앙 이전 기록 스키마와 버전 정규화기를 도입하고, 재실행 시 현행 계정 상태를 보존한다. 카카오 인증 뒤 이관 비밀번호를 1회 설정하는 흐름과 비카카오 계정용 안전한 CLI 복구 경로를 추가한다.
322 lines
14 KiB
TypeScript
322 lines
14 KiB
TypeScript
export type ArchivedJsonValue =
|
|
null | boolean | number | string | ArchivedJsonValue[] | { [key: string]: ArchivedJsonValue };
|
|
|
|
export const ARCHIVED_GENERAL_SCHEMA_VERSION = 1 as const;
|
|
|
|
export const LEGACY_ARCHIVE_PROFILES = ['che', 'kwe', 'pwe', 'twe', 'nya', 'pya', 'hwe'] as const;
|
|
export type LegacyArchiveProfile = (typeof LEGACY_ARCHIVE_PROFILES)[number];
|
|
|
|
export const isLegacyArchiveProfile = (value: string): value is LegacyArchiveProfile =>
|
|
(LEGACY_ARCHIVE_PROFILES as readonly string[]).includes(value);
|
|
|
|
export type ArchivedGeneralSourceFormat = 'legacy-flat-v0' | 'ref-flat-v1' | 'core-snapshot-v1' | 'unknown';
|
|
|
|
export interface ArchivedGeneralSnapshotV1 {
|
|
schemaVersion: typeof ARCHIVED_GENERAL_SCHEMA_VERSION;
|
|
identity: {
|
|
name: string;
|
|
picture: string | null;
|
|
imageServer: number | null;
|
|
npcState: number | null;
|
|
nationId: number | null;
|
|
cityId: number | null;
|
|
officerLevel: number | null;
|
|
officerCity: number | null;
|
|
};
|
|
stats: {
|
|
leadership: number | null;
|
|
strength: number | null;
|
|
intelligence: number | null;
|
|
leadershipExperience: number | null;
|
|
strengthExperience: number | null;
|
|
intelligenceExperience: number | null;
|
|
};
|
|
progression: {
|
|
experience: number | null;
|
|
experienceLevel: number | null;
|
|
dedication: number | null;
|
|
dedicationLevel: number | null;
|
|
age: number | null;
|
|
startAge: number | null;
|
|
bornYear: number | null;
|
|
deadYear: number | null;
|
|
};
|
|
traits: {
|
|
personality: string | null;
|
|
specialDomestic: string | null;
|
|
specialWar: string | null;
|
|
};
|
|
resources: {
|
|
gold: number | null;
|
|
rice: number | null;
|
|
crew: number | null;
|
|
crewType: string | null;
|
|
train: number | null;
|
|
morale: number | null;
|
|
injury: number | null;
|
|
};
|
|
items: {
|
|
horse: string | null;
|
|
weapon: string | null;
|
|
book: string | null;
|
|
item: string | null;
|
|
};
|
|
mastery: {
|
|
infantry: number | null;
|
|
archery: number | null;
|
|
cavalry: number | null;
|
|
special: number | null;
|
|
siege: number | null;
|
|
};
|
|
battle: {
|
|
battles: number | null;
|
|
wins: number | null;
|
|
losses: number | null;
|
|
fireSuccesses: number | null;
|
|
kills: number | null;
|
|
deaths: number | null;
|
|
killedCrew: number | null;
|
|
lostCrew: number | null;
|
|
winRate: number | null;
|
|
killRate: number | null;
|
|
recentWar: string | null;
|
|
tactics: {
|
|
total: { wins: number | null; draws: number | null; losses: number | null };
|
|
leadership: { wins: number | null; draws: number | null; losses: number | null };
|
|
intelligence: { wins: number | null; draws: number | null; losses: number | null };
|
|
};
|
|
};
|
|
history: string[];
|
|
availability: {
|
|
mastery: boolean;
|
|
battleAggregates: boolean;
|
|
tactics: boolean;
|
|
history: boolean;
|
|
battleDetailLogs: false;
|
|
battleResultLogs: false;
|
|
};
|
|
}
|
|
|
|
type JsonRecord = Record<string, ArchivedJsonValue | undefined>;
|
|
|
|
const asRecord = (value: ArchivedJsonValue | undefined): JsonRecord =>
|
|
value !== null && typeof value === 'object' && !Array.isArray(value) ? (value as JsonRecord) : {};
|
|
|
|
const finiteNumber = (value: ArchivedJsonValue | undefined): number | null => {
|
|
if (typeof value === 'number' && Number.isFinite(value)) return value;
|
|
if (typeof value === 'string' && value.trim() !== '') {
|
|
const parsed = Number(value);
|
|
return Number.isFinite(parsed) ? parsed : null;
|
|
}
|
|
return null;
|
|
};
|
|
|
|
const firstNumber = (...values: Array<ArchivedJsonValue | undefined>): number | null => {
|
|
for (const value of values) {
|
|
const parsed = finiteNumber(value);
|
|
if (parsed !== null) return parsed;
|
|
}
|
|
return null;
|
|
};
|
|
|
|
const text = (value: ArchivedJsonValue | undefined): string | null => {
|
|
if (typeof value === 'string') return value.trim() === '' ? null : value;
|
|
if (typeof value === 'number' && Number.isFinite(value)) return String(value);
|
|
return null;
|
|
};
|
|
|
|
const firstText = (...values: Array<ArchivedJsonValue | undefined>): string | null => {
|
|
for (const value of values) {
|
|
const parsed = text(value);
|
|
if (parsed !== null) return parsed;
|
|
}
|
|
return null;
|
|
};
|
|
|
|
const historyLines = (value: ArchivedJsonValue | undefined): string[] => {
|
|
if (Array.isArray(value)) {
|
|
return value.filter((entry): entry is string => typeof entry === 'string' && entry.trim().length > 0);
|
|
}
|
|
if (typeof value !== 'string') return [];
|
|
return value
|
|
.split(/<br\s*\/?>/iu)
|
|
.map((entry) => entry.trim())
|
|
.filter(Boolean);
|
|
};
|
|
|
|
const rate = (numerator: number | null, denominator: number | null): number | null =>
|
|
numerator === null || denominator === null || denominator <= 0
|
|
? null
|
|
: Math.round((numerator / denominator) * 10_000) / 100;
|
|
|
|
export const detectArchivedGeneralSourceFormat = (raw: ArchivedJsonValue): ArchivedGeneralSourceFormat => {
|
|
const data = asRecord(raw);
|
|
if (Object.keys(asRecord(data.stats)).length > 0 || data.schemaVersion === 1) return 'core-snapshot-v1';
|
|
if ('leadership' in data || 'strength' in data || 'dex1' in data) return 'ref-flat-v1';
|
|
if ('leader' in data || 'power' in data || 'dex0' in data) return 'legacy-flat-v0';
|
|
return 'unknown';
|
|
};
|
|
|
|
export const normalizeArchivedGeneral = (
|
|
raw: ArchivedJsonValue,
|
|
fallbackName: string
|
|
): { sourceFormat: ArchivedGeneralSourceFormat; snapshot: ArchivedGeneralSnapshotV1 } => {
|
|
const data = asRecord(raw);
|
|
const identity = asRecord(data.identity);
|
|
const stats = asRecord(data.stats);
|
|
const role = asRecord(data.role);
|
|
const items = asRecord(data.items);
|
|
const progression = asRecord(data.progression);
|
|
const traits = asRecord(data.traits);
|
|
const resources = asRecord(data.resources);
|
|
const nestedMastery = asRecord(data.mastery);
|
|
const nestedBattle = asRecord(data.battle);
|
|
const nestedTactics = asRecord(nestedBattle.tactics);
|
|
const totalTactics = asRecord(nestedTactics.total);
|
|
const leadershipTactics = asRecord(nestedTactics.leadership);
|
|
const intelligenceTactics = asRecord(nestedTactics.intelligence);
|
|
const oldMastery = 'dex0' in data;
|
|
const masteryValues = oldMastery
|
|
? [data.dex0, data.dex10, data.dex20, data.dex30, data.dex40]
|
|
: [
|
|
data.dex1 ?? nestedMastery.infantry,
|
|
data.dex2 ?? nestedMastery.archery,
|
|
data.dex3 ?? nestedMastery.cavalry,
|
|
data.dex4 ?? nestedMastery.special,
|
|
data.dex5 ?? nestedMastery.siege,
|
|
];
|
|
const mastery = masteryValues.map(finiteNumber);
|
|
const battles = firstNumber(data.warnum, nestedBattle.battles);
|
|
const wins = firstNumber(data.killnum, nestedBattle.wins);
|
|
const losses = firstNumber(data.deathnum, nestedBattle.losses);
|
|
const killedCrew = firstNumber(data.killcrew, nestedBattle.killedCrew);
|
|
const lostCrew = firstNumber(data.deathcrew, nestedBattle.lostCrew);
|
|
const history = historyLines(data.history);
|
|
const tacticValues = [
|
|
data.ttw ?? totalTactics.wins,
|
|
data.ttd ?? totalTactics.draws,
|
|
data.ttl ?? totalTactics.losses,
|
|
data.tlw ?? leadershipTactics.wins,
|
|
data.tld ?? leadershipTactics.draws,
|
|
data.tll ?? leadershipTactics.losses,
|
|
data.tiw ?? intelligenceTactics.wins,
|
|
data.tid ?? intelligenceTactics.draws,
|
|
data.til ?? intelligenceTactics.losses,
|
|
];
|
|
const tacticsAvailable = tacticValues.some((value) => finiteNumber(value) !== null);
|
|
|
|
return {
|
|
sourceFormat: detectArchivedGeneralSourceFormat(raw),
|
|
snapshot: {
|
|
schemaVersion: ARCHIVED_GENERAL_SCHEMA_VERSION,
|
|
identity: {
|
|
name: firstText(data.name, identity.name) ?? fallbackName,
|
|
picture: firstText(data.picture, identity.picture),
|
|
imageServer: firstNumber(data.imageServer, data.imgsvr, identity.imageServer),
|
|
npcState: firstNumber(data.npcState, data.npc, identity.npcState),
|
|
nationId: firstNumber(data.nationId, data.nation, identity.nationId),
|
|
cityId: firstNumber(data.cityId, data.city, identity.cityId),
|
|
officerLevel: firstNumber(data.officerLevel, data.officer_level, data.level, identity.officerLevel),
|
|
officerCity: firstNumber(data.officerCity, data.officer_city, identity.officerCity),
|
|
},
|
|
stats: {
|
|
leadership: firstNumber(data.leadership, data.leader, stats.leadership),
|
|
strength: firstNumber(data.strength, data.power, stats.strength),
|
|
intelligence: firstNumber(data.intelligence, data.intel, stats.intelligence),
|
|
leadershipExperience: firstNumber(
|
|
data.leadershipExperience,
|
|
data.leadership_exp,
|
|
stats.leadershipExperience
|
|
),
|
|
strengthExperience: firstNumber(data.strengthExperience, data.strength_exp, stats.strengthExperience),
|
|
intelligenceExperience: firstNumber(
|
|
data.intelligenceExperience,
|
|
data.intel_exp,
|
|
stats.intelligenceExperience
|
|
),
|
|
},
|
|
progression: {
|
|
experience: firstNumber(data.experience, progression.experience),
|
|
experienceLevel: firstNumber(data.experienceLevel, data.explevel, progression.experienceLevel),
|
|
dedication: firstNumber(data.dedication, progression.dedication),
|
|
dedicationLevel: firstNumber(data.dedicationLevel, data.dedlevel, progression.dedicationLevel),
|
|
age: firstNumber(data.age, progression.age),
|
|
startAge: firstNumber(data.startAge, data.startage, progression.startAge),
|
|
bornYear: firstNumber(data.bornYear, data.bornyear, progression.bornYear),
|
|
deadYear: firstNumber(data.deadYear, data.deadyear, progression.deadYear),
|
|
},
|
|
traits: {
|
|
personality: firstText(data.personalCode, data.personal, role.personality, traits.personality),
|
|
specialDomestic: firstText(
|
|
data.specialCode,
|
|
data.special,
|
|
role.specialDomestic,
|
|
traits.specialDomestic
|
|
),
|
|
specialWar: firstText(data.special2Code, data.special2, role.specialWar, traits.specialWar),
|
|
},
|
|
resources: {
|
|
gold: firstNumber(data.gold, resources.gold),
|
|
rice: firstNumber(data.rice, resources.rice),
|
|
crew: firstNumber(data.crew, resources.crew),
|
|
crewType: firstText(data.crewType, data.crewtype, resources.crewType),
|
|
train: firstNumber(data.train, resources.train),
|
|
morale: firstNumber(data.morale, data.atmos, resources.morale),
|
|
injury: firstNumber(data.injury, resources.injury),
|
|
},
|
|
items: {
|
|
horse: firstText(items.horse, data.horse),
|
|
weapon: firstText(items.weapon, data.weapon, data.weap),
|
|
book: firstText(items.book, data.book),
|
|
item: firstText(items.item, data.item),
|
|
},
|
|
mastery: {
|
|
infantry: mastery[0] ?? null,
|
|
archery: mastery[1] ?? null,
|
|
cavalry: mastery[2] ?? null,
|
|
special: mastery[3] ?? null,
|
|
siege: mastery[4] ?? null,
|
|
},
|
|
battle: {
|
|
battles,
|
|
wins,
|
|
losses,
|
|
fireSuccesses: firstNumber(data.firenum, nestedBattle.fireSuccesses),
|
|
kills: firstNumber(nestedBattle.kills, wins),
|
|
deaths: firstNumber(nestedBattle.deaths, losses),
|
|
killedCrew,
|
|
lostCrew,
|
|
winRate: firstNumber(nestedBattle.winRate) ?? rate(wins, battles),
|
|
killRate: firstNumber(nestedBattle.killRate) ?? rate(killedCrew, lostCrew),
|
|
recentWar: firstText(data.recentWar, data.recent_war, nestedBattle.recentWar),
|
|
tactics: {
|
|
total: {
|
|
wins: firstNumber(data.ttw, totalTactics.wins),
|
|
draws: firstNumber(data.ttd, totalTactics.draws),
|
|
losses: firstNumber(data.ttl, totalTactics.losses),
|
|
},
|
|
leadership: {
|
|
wins: firstNumber(data.tlw, leadershipTactics.wins),
|
|
draws: firstNumber(data.tld, leadershipTactics.draws),
|
|
losses: firstNumber(data.tll, leadershipTactics.losses),
|
|
},
|
|
intelligence: {
|
|
wins: firstNumber(data.tiw, intelligenceTactics.wins),
|
|
draws: firstNumber(data.tid, intelligenceTactics.draws),
|
|
losses: firstNumber(data.til, intelligenceTactics.losses),
|
|
},
|
|
},
|
|
},
|
|
history,
|
|
availability: {
|
|
mastery: mastery.some((value) => value !== null),
|
|
battleAggregates: [battles, wins, losses, killedCrew, lostCrew].some((value) => value !== null),
|
|
tactics: tacticsAvailable,
|
|
history: history.length > 0,
|
|
battleDetailLogs: false,
|
|
battleResultLogs: false,
|
|
},
|
|
},
|
|
};
|
|
};
|