perf: 프로필 프런트엔드 자산을 커밋 단위로 공유한다

정적 운영 빌드에서 프로필별 base와 API 설정을 런타임 JSON으로 분리하고, 공용 Vite 번들과 sourcemap을 한 번만 생성·게시한다. Preview와 기존 정적 artifact의 전환 호환 경계는 유지한다.
2026-08-22 17:54:43 +00:00
parent ecc8721238
commit ade543f936
24 changed files with 628 additions and 79 deletions
@@ -0,0 +1,75 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+
+import { resolveGameFrontendRuntimeConfig } from '../src/config/runtimeConfig.ts';
+
+const documentWithConfig = (value: string | null): Pick<Document, 'getElementById'> => ({
+    getElementById: () => (value === null ? null : ({ textContent: value } as HTMLElement)),
+});
+
+void describe('game frontend runtime config', () => {
+    void it('prefers the embedded profile wrapper config over build-time fallbacks', () => {
+        const config = resolveGameFrontendRuntimeConfig(
+            documentWithConfig(
+                JSON.stringify({
+                    version: 1,
+                    profile: 'pya',
+                    profileName: 'pya:default',
+                    appBasePath: '/pya',
+                    gameApiUrl: '/pya/api/trpc',
+                    gameSseUrl: '/pya/api/events',
+                    gatewayApiUrl: '/gateway/api/trpc',
+                    gatewayWebUrl: '/gateway/',
+                    buildCommitSha: 'a'.repeat(40),
+                    assetReleaseId: `${'a'.repeat(40)}-${'b'.repeat(16)}`,
+                })
+            ),
+            {
+                VITE_APP_BASE_PATH: '/che',
+                VITE_GAME_API_URL: '/che/api/trpc',
+                VITE_GAME_SSE_URL: '/che/api/events',
+                VITE_GAME_PROFILE: 'che',
+                VITE_BUILD_COMMIT_SHA: 'c'.repeat(40),
+            }
+        );
+
+        assert.equal(config.profile, 'pya');
+        assert.equal(config.appBasePath, '/pya/');
+        assert.equal(config.gameApiUrl, '/pya/api/trpc');
+        assert.equal(config.gameSseUrl, '/pya/api/events');
+        assert.equal(config.buildCommitSha, 'a'.repeat(40));
+        assert.equal(config.assetReleaseId, `${'a'.repeat(40)}-${'b'.repeat(16)}`);
+    });
+
+    void it('keeps preview and local development compatible through Vite environment fallbacks', () => {
+        const config = resolveGameFrontendRuntimeConfig(documentWithConfig(null), {
+            VITE_APP_BASE_PATH: '/hwe',
+            VITE_GAME_API_URL: '/hwe/api/trpc',
+            VITE_GAME_SSE_URL: '/hwe/api/events',
+            VITE_GAME_PROFILE: 'hwe',
+            VITE_GATEWAY_API_URL: '/gateway/api/trpc',
+            VITE_GATEWAY_WEB_URL: '/gateway/',
+            VITE_BUILD_COMMIT_SHA: 'd'.repeat(40),
+        });
+
+        assert.deepEqual(config, {
+            version: 1,
+            profile: 'hwe',
+            appBasePath: '/hwe/',
+            gameApiUrl: '/hwe/api/trpc',
+            gameSseUrl: '/hwe/api/events',
+            gatewayApiUrl: '/gateway/api/trpc',
+            gatewayWebUrl: '/gateway/',
+            buildCommitSha: 'd'.repeat(40),
+        });
+    });
+
+    void it('falls back safely when the embedded script is malformed', () => {
+        const config = resolveGameFrontendRuntimeConfig(documentWithConfig('{'), {});
+
+        assert.equal(config.appBasePath, '/');
+        assert.equal(config.gameApiUrl, '/api/trpc');
+        assert.equal(config.gameSseUrl, '/api/events');
+        assert.equal(config.buildCommitSha, 'unknown');
+    });
+});