feat: 월드 스냅샷 및 시나리오 부트스트랩 관련 타입 및 로더 구현

2025-12-28 15:26:25 +00:00
parent a4c74b860e
commit 54252dc6b4
8 changed files with 1008 additions and 0 deletions
@@ -0,0 +1,68 @@
+import type { City, General, Nation } from '../domain/entities.js';
+import type { ScenarioConfig, ScenarioDiplomacy } from '../scenario/types.js';
+import type { ScenarioConfigSource, WorldStateSnapshotSource } from '../ports/worldSnapshot.js';
+import type {
+    MapDefinition,
+    ScenarioMeta,
+    UnitSetDefinition,
+    WorldSnapshot,
+} from './types.js';
+
+export interface WorldSnapshotLoadInput<
+    GeneralType extends General = General,
+    CityType extends City = City,
+    NationType extends Nation = Nation
+> {
+    worldSource: WorldStateSnapshotSource<GeneralType, CityType, NationType>;
+    scenarioConfig?: ScenarioConfig;
+    scenarioMeta?: ScenarioMeta;
+    scenarioSource?: ScenarioConfigSource;
+    map: MapDefinition;
+    unitSet?: UnitSetDefinition;
+    diplomacy?: ScenarioDiplomacy[];
+    events?: unknown[];
+    initialEvents?: unknown[];
+}
+
+// DB 기반 월드 로더: 세계 상태와 시나리오 설정을 합쳐 스냅샷을 만든다.
+export const loadWorldSnapshot = async <
+    GeneralType extends General,
+    CityType extends City,
+    NationType extends Nation
+>(
+    input: WorldSnapshotLoadInput<GeneralType, CityType, NationType>
+): Promise<WorldSnapshot> => {
+    const { worldSource, scenarioSource } = input;
+
+    const scenarioConfig =
+        input.scenarioConfig ??
+        (scenarioSource ? await scenarioSource.loadScenarioConfig() : undefined);
+    if (!scenarioConfig) {
+        throw new Error('Scenario config is required to load world snapshot.');
+    }
+
+    const scenarioMeta =
+        input.scenarioMeta ??
+        (scenarioSource?.loadScenarioMeta
+            ? await scenarioSource.loadScenarioMeta()
+            : undefined);
+
+    const [generals, cities, nations] = await Promise.all([
+        worldSource.listGenerals(),
+        worldSource.listCities(),
+        worldSource.listNations(),
+    ]);
+
+    return {
+        scenarioConfig,
+        ...(scenarioMeta ? { scenarioMeta } : {}),
+        map: input.map,
+        ...(input.unitSet ? { unitSet: input.unitSet } : {}),
+        nations,
+        cities,
+        generals,
+        diplomacy: input.diplomacy ?? [],
+        events: input.events ?? [],
+        initialEvents: input.initialEvents ?? [],
+    };
+};