Files
clean-architecture-frontend…/vite.service-worker.config.ts
T
DongHyeonka f4d5761a2a fix(test-run): 실행마다 빌드·Playwright 출력 폴더를 따로 쓴다
문제: 빌드는 `dist`, `.generated/frontend-runtime`, `artifacts/release`·
`artifacts/quality`에 고정으로 쓰고, 다섯 Playwright 설정은 결과·report·
JUnit을 `artifacts/tests/<이름>/`에 고정으로 쓴다. 한 checkout에서 두
번째 e2e 실행이 시작하면 빌드 1단계가 첫 실행의 preview가 서빙 중인
`dist`를 지우고, Playwright가 `outputDir`을 비워 첫 실행의 trace를 지운다.
증거 파일도 늦게 끝난 쪽 것으로 섞인다(1105/12-04).

고른 방법: 변수 두 개로 나눈다(`scripts/lib/run-isolation.ts`).
- `TEST_RUN_ID`: Playwright 설정이 읽는다. 값이 있으면 그 실행의 결과·
  report·JUnit과 서빙할 빌드를 `.tmp/runs/<id>/` 아래 같은 상대 경로에
  둔다. 없으면 지금 경로 그대로라 게이트, CI upload, 증거 검사가 읽는
  곳이 바뀌지 않는다.
- `RUN_OUTPUT_ROOT`: 설정이 web server에만 넘긴다. 빌드 단계 전부
  (`build-frontend`, contract set, runtime config, SW asset 목록, SW 빌드,
  build manifest)와 `vite.config.ts`가 읽어 `dist`·생성 모듈·증거·Vite
  캐시를 그 아래에 쓴다. preview는 `--outDir`로 같은 `dist`를 서빙한다.
빌드 코드는 `TEST_RUN_ID`를 읽지 않는다. e2e worker가 저장소 복사본을
빌드할 때(fixture-builds, service-worker-builds) runner 환경을 물려받는데,
그 빌드는 복사본 자기 `dist`에 써야 하기 때문이다.
두 루트는 `.` 또는 `.tmp/` 아래만 받는다. git, Tailwind 소스 스캔(report
안 문자열이 CSS에 들어가지 않게), Vite watcher, vitest, 저장소 복사
helper가 모두 `.tmp`를 건너뛴다. service-worker-builds의 복사 제외 목록에
`.tmp`를 더했다(fixture-builds와 같아짐). build manifest의 경로는 빌드가
쓴 폴더 기준 상대 경로로 둔다.
`vite.config.ts`가 새로 가져오는 `scripts/lib/run-isolation.ts`는 저장소
일부를 임시 루트에 복사해 빌드하는 두 목록(초기 JS 측정
`scripts/scale/measure-feature-shape-growth.ts`,
`tests/unit/product-feature-selection-build.test.ts`)에도 더한다.
Storybook은 run ID가 있으면 `build:storybook`의 두 단계를 다른 `-o`로
돌린다. 같은 단계인지는 단위 테스트가 package script와 대조한다.
버린 대안: 운영 증거 경로(54개 스크립트, `config/ci/gates.json`)까지 run
ID로 옮기기. 게이트와 workflow upload가 고정 경로를 읽으므로 이번 범위
밖이다(아래 한계). 실행마다 저장소를 임시 폴더로 복사하기: 매번 수십
MB 복사와 node_modules 링크가 들고, 개발자가 보는 결과 위치가 사라진다.

위험·한계: 포트는 아직 고정이라 이 커밋만으로는 두 실행이 함께 돌지
못한다(다음 커밋). `ci:gate`와 증거 검사(`check:test-evidence`,
`verify:browser-capability-evidence`)는 기본 경로만 읽는다. run ID를 준
채 게이트를 돌리면 증거가 기본 경로에 새로 생기지 않아 게이트가 "not
freshly produced"로 실패한다(통과로 새지 않는다). Storybook 내부 캐시
(`node_modules/.cache`)는 여전히 공유한다. capability 설정
(`playwright.capabilities.config.ts`)은 test:browser-file-storage-removal이
capability와 함께 지운다. 설정 테스트는 그 파일이 있을 때만 그 설정을 읽고,
경로를 변수로 두어 타입 검사가 그 파일을 요구하지 않는다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/run-isolation.test.ts tests/unit/playwright-run-isolation.test.ts tests/unit/run-output-root-build.test.ts
node scripts/run-vitest.ts run tests/unit/feature-shape-growth.test.ts tests/unit/product-feature-selection-build.test.ts
corepack pnpm test:browser-file-storage-removal

Refs: 1105/12-04
2026-11-06 02:11:17 +09:00

112 lines
4.0 KiB
TypeScript

import { readFile } from "node:fs/promises";
import { defineConfig } from "vite";
import { getBuildConfig } from "./src/contracts/env.ts";
import {
SERVICE_WORKER_CACHE_SCHEMA_VERSION,
SERVICE_WORKER_PROTOCOL_VERSION,
SERVICE_WORKER_SCRIPT_PATH,
} from "./src/contracts/service-worker.ts";
import { INSTALLED_RUNTIME_CAPABILITIES } from "./src/features/installed-runtime-capabilities.ts";
import { runOutputPath } from "./scripts/lib/run-isolation.ts";
import { resolveServiceWorkerBuildInput } from "./scripts/lib/service-worker-build-input.ts";
/**
* §17.2.2 step 5. The Service Worker build.
*
* Runs only when the static selection is `ACTIVE`, after the app build has
* completed and the hashed asset list has been generated. `emptyOutDir` is
* false so it adds `service-worker.js` beside the already-built app rather than
* replacing it.
*/
const selection = INSTALLED_RUNTIME_CAPABILITIES.serviceWorker;
// Relative to this file: Vite's default `bundle` config loader runs the config
// from `node_modules/.vite-temp/`, so a bare `import("./.generated/...")` would
// resolve there. Every loader keeps `import.meta.url` pointing at this file.
// 1105/12-04. The generated modules, `dist/config.json` and the output are
// under RUN_OUTPUT_ROOT when the build sets one (scripts/build-frontend.ts).
async function readGenerated<T>(path: string, exportName: string): Promise<T> {
try {
const module = (await import(new URL(path, import.meta.url).href)) as Record<
string,
unknown
>;
if (!(exportName in module)) {
throw new TypeError(`Generated module does not export ${exportName}.`);
}
return module[exportName] as T;
} catch (error) {
throw new TypeError(`Required generated module is unavailable: ${path}`, {
cause: error,
});
}
}
const assets = await readGenerated(
`./${runOutputPath(".generated/frontend-runtime/service-worker-assets.ts")}`,
"SERVICE_WORKER_ASSETS",
);
const contractSet = await readGenerated<{ setDigest?: string }>(
`./${runOutputPath(".generated/frontend-runtime/contract-set.ts")}`,
"BUILD_CONTRACT_SET",
);
// 06-10 / F-8. The profile document `scripts/generate-runtime-config.ts` wrote
// in step 4, not `public/config.json`, which is always the local profile.
const runtimeConfig = JSON.parse(
await readFile(runOutputPath("dist/config.json"), "utf8"),
) as Record<string, string>;
const buildId = process.env.VITE_BUILD_ID ?? "local-build";
const releaseId = process.env.RELEASE_ID ?? "local-release";
const buildInput = resolveServiceWorkerBuildInput({
selection,
assets,
contractSet,
runtimeConfig,
appProfile: process.env.APP_PROFILE ?? "local",
buildId,
releaseId,
});
export default defineConfig({
// 0929/06-01. `dist` already holds the app build, `public/` included. Copying
// `public/` again would put the local `public/config.json` back over the
// profile document step 4 wrote.
publicDir: false,
build: {
outDir: runOutputPath("dist"),
// §17.2.2: exactly one input, exactly one output, no additional chunk.
emptyOutDir: false,
sourcemap: false,
rolldownOptions: {
input: "src/adapters/service-worker/service-worker-entry.ts",
output: {
format: "es",
inlineDynamicImports: true,
entryFileNames: SERVICE_WORKER_SCRIPT_PATH,
},
},
},
define: {
__CA_SERVICE_WORKER_BUILD_INFO__: JSON.stringify({
serviceWorkerProtocolVersion: SERVICE_WORKER_PROTOCOL_VERSION,
cacheSchemaVersion: SERVICE_WORKER_CACHE_SCHEMA_VERSION,
buildId,
releaseId,
contractSetDigest: buildInput.contractSetDigest,
staticAssetSetDigest: buildInput.assets.setDigest,
}),
__CA_SERVICE_WORKER_ASSETS__: JSON.stringify(buildInput.assets),
__CA_SERVICE_WORKER_HANDLERS__: JSON.stringify(buildInput.handlers),
// 0929/06-02. The page's own default, which follows the router base path.
__CA_RUNTIME_CONFIG_URL__: JSON.stringify(
getBuildConfig(process.env).runtimeConfigUrl,
),
__CA_RELEASE_MANIFEST_URL__: JSON.stringify(
buildInput.releaseManifestUrl,
),
},
});