merge: 최신 main을 개인 기록 시각 수정에 반영

packages/logic/src/rewards/legacyUniqueItemPool.ts

@@ -1,5 +1,6 @@
+import { createItemModuleRegistry, ItemLoader, ITEM_KEYS, loadItemModules } from '@sammo-ts/logic/items/index.js';
 import type { ItemModule } from '@sammo-ts/logic/items/types.js';
-import type { UniqueItemPool } from './uniqueLottery.js';
+import { resolveUniqueConfig, type UniqueItemPool, type UniqueLotteryConfig } from './uniqueLottery.js';
 
 const LEGACY_UNIQUE_ITEM_KEYS: Readonly<Record<ItemModule['slot'], readonly string[]>> = {
     horse: [
@@ -125,3 +126,38 @@ export const buildLegacyDefaultUniqueItemPool = (itemRegistry: Map<string, ItemM
     }
     return pool;
 };
+
+let legacyDefaultUniqueItemPoolPromise: Promise<UniqueItemPool> | null = null;
+
+const cloneUniqueItemPool = (pool: UniqueItemPool): UniqueItemPool =>
+    Object.fromEntries(Object.entries(pool).map(([slot, entries]) => [slot, { ...entries }]));
+
+export const loadLegacyDefaultUniqueItemPool = async (loader?: ItemLoader): Promise<UniqueItemPool> => {
+    if (loader) {
+        const modules = await loadItemModules([...ITEM_KEYS], loader);
+        return buildLegacyDefaultUniqueItemPool(createItemModuleRegistry(modules));
+    }
+
+    legacyDefaultUniqueItemPoolPromise ??= loadItemModules([...ITEM_KEYS], new ItemLoader()).then((modules) =>
+        buildLegacyDefaultUniqueItemPool(createItemModuleRegistry(modules))
+    );
+    return cloneUniqueItemPool(await legacyDefaultUniqueItemPoolPromise);
+};
+
+/**
+ * Ref의 GameConst 기본값은 시나리오가 allItems를 덮어쓰지 않아도 항상 존재합니다.
+ * 오래된 Core snapshot의 생략값/문자열 빈 객체도 같은 기본 풀로 해석합니다.
+ */
+export const resolveLegacyCompatibleUniqueConfig = async (
+    configConst: Record<string, unknown>,
+    loader?: ItemLoader
+): Promise<UniqueLotteryConfig> => {
+    const config = resolveUniqueConfig(configConst);
+    if (Object.keys(config.allItems).length > 0) {
+        return config;
+    }
+    return {
+        ...config,
+        allItems: await loadLegacyDefaultUniqueItemPool(loader),
+    };
+};

packages/logic/test/legacyUniqueItemPool.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest';
+
+import { resolveLegacyCompatibleUniqueConfig } from '../src/rewards/legacyUniqueItemPool.js';
+
+describe('legacy-compatible unique item pool', () => {
+    it.each([undefined, {}, '{}'] as const)('restores the Ref default pool when allItems is %j', async (allItems) => {
+        const config = await resolveLegacyCompatibleUniqueConfig(allItems === undefined ? {} : { allItems });
+
+        expect(Object.keys(config.allItems)).toEqual(['horse', 'weapon', 'book', 'item']);
+        expect(config.allItems.weapon?.che_무기_12_칠성검).toBe(2);
+        expect(config.allItems.item?.che_의술_청낭서).toBe(1);
+        expect(config.allItems.weapon?.che_무기_01_단도).toBeUndefined();
+    });
+
+    it('preserves an explicit scenario pool, including its counts', async () => {
+        const config = await resolveLegacyCompatibleUniqueConfig({
+            allItems: {
+                weapon: {
+                    che_무기_12_칠성검: 7,
+                },
+            },
+        });
+
+        expect(config.allItems).toEqual({
+            weapon: {
+                che_무기_12_칠성검: 7,
+            },
+        });
+    });
+});