import { spawnSync } from "node:child_process"; import { cp, mkdir, readFile, readdir, rm, symlink, writeFile, } from "node:fs/promises"; import path from "node:path"; const fixtureRoot = path.resolve(".tmp/realtime-runtime-removal"); const pnpmCli = requireEnvironment("npm_execpath"); const runtimePaths = [ "src/application/ports/realtime", "src/application/ports/out/web-push-control.ts", "src/application/policies/bounded-polling.ts", "src/contracts/realtime-events.ts", "src/contracts/realtime-streams.ts", "src/contracts/web-push.ts", "src/adapters/realtime", "src/adapters/web-push", "tests/fixtures/realtime-boundaries", ] as const; const runtimeSourceRoots = runtimePaths.filter((entry) => entry.startsWith("src/"), ); const runtimeScripts = [ "check:realtime-boundaries", "check:realtime-boundaries:fixture", "test:realtime-removal", ] as const; const copyTargets = [ "src", "tests", "recipes", "scripts", "config", "schemas", "public", ".gitea", ".storybook", "index.html", "package.json", "tsconfig.base.json", "tsconfig.json", "tsconfig.app.json", "tsconfig.node.json", "tsconfig.test.json", "tsconfig.recipes.json", "tsconfig.web-worker.json", "tsconfig.service-worker.json", "vite.service-worker.config.ts", "vite.config.ts", "vitest.config.ts", "playwright.config.ts", "playwright.capabilities.config.ts", "playwright.dev.config.ts", "playwright.storybook.config.ts", "playwright.visual.config.ts", "eslint.config.ts", ".dependency-cruiser.json", ".nvmrc", ] as const; function requireEnvironment(name: string): string { const value = process.env[name]; if (!value) { throw new Error(`${name} is required for runtime removal verification`); } return value; } function runPnpm(script: string): boolean { return ( spawnSync(process.execPath, [pnpmCli, script], { cwd: fixtureRoot, stdio: "inherit", }).status === 0 ); } async function sourceFiles(directory: string): Promise { const entries = await readdir(directory, { withFileTypes: true }); return ( await Promise.all( entries.map(async (entry): Promise => { const target = path.join(directory, entry.name); if (entry.isDirectory()) return await sourceFiles(target); return /\.(?:[cm]?ts|tsx)$/u.test(entry.name) ? [path.resolve(target)] : []; }), ) ).flat(); } function staticImportSpecifiers(source: string): string[] { return [ ...source.matchAll( /(?:from\s*|import\s*\(\s*|import\s*)["']([^"']+)["']/gu, ), ] .map((match) => match[1]) .filter((specifier): specifier is string => typeof specifier === "string", ); } function isWithin(target: string, root: string): boolean { const relative = path.relative(root, target); return ( relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative)) ); } function resolvedImport( importer: string, specifier: string, sourceSet: ReadonlySet, ): string | null { if (!specifier.startsWith(".")) return null; const base = path.resolve(path.dirname(importer), specifier); const candidates = [ base, `${base}.ts`, `${base}.tsx`, `${base}.mts`, `${base}.cts`, path.join(base, "index.ts"), path.join(base, "index.tsx"), ]; return candidates.find((candidate) => sourceSet.has(candidate)) ?? base; } async function runtimeImportGraph(root: string): Promise> { const files = await sourceFiles(root); const sourceSet = new Set(files); const runtimeRoots = runtimeSourceRoots.map((entry) => path.resolve(root, entry), ); const imports = new Map(); for (const file of files) { const source = await readFile(file, "utf8"); imports.set( file, staticImportSpecifiers(source) .map((specifier) => resolvedImport(file, specifier, sourceSet)) .filter((target): target is string => target !== null), ); } const memo = new Map(); const reachesRuntime = ( file: string, visiting = new Set(), ): boolean => { if (runtimeRoots.some((root) => isWithin(file, root))) return true; const known = memo.get(file); if (known !== undefined) return known; if (visiting.has(file)) return false; visiting.add(file); const reaches = (imports.get(file) ?? []).some( (dependency) => runtimeRoots.some((runtimeRoot) => isWithin(dependency, runtimeRoot), ) || (sourceSet.has(dependency) && reachesRuntime(dependency, visiting)), ); visiting.delete(file); memo.set(file, reaches); return reaches; }; const testsRoot = path.resolve(root, "tests"); return Object.freeze({ dependentTests: Object.freeze( files.filter( (file) => isWithin(file, testsRoot) && reachesRuntime(file), ), ), importingFiles: Object.freeze( files.filter( (file) => !runtimeRoots.some((runtimeRoot) => isWithin(file, runtimeRoot), ) && (imports.get(file) ?? []).some((dependency) => runtimeRoots.some((runtimeRoot) => isWithin(dependency, runtimeRoot), ), ), ), ), }); } async function removeRuntimeDependentTests(root: string): Promise { const graph = await runtimeImportGraph(root); await Promise.all( graph.dependentTests.map(async (file) => { if (isWithin(file, path.resolve(root, "tests"))) { await rm(file, { force: true }); } }), ); return graph.dependentTests.length; } async function assertNoRuntimeImports(root: string): Promise { const graph = await runtimeImportGraph(root); if (graph.importingFiles.length > 0) { throw new Error( `Removed realtime runtime is still imported by: ${graph.importingFiles .map((file) => path.relative(root, file)) .join(", ")}`, ); } } await rm(fixtureRoot, { recursive: true, force: true }); await mkdir(fixtureRoot, { recursive: true }); for (const target of copyTargets) { await cp(target, path.join(fixtureRoot, target), { recursive: true }); } await symlink( path.resolve("node_modules"), path.join(fixtureRoot, "node_modules"), "dir", ); const removedRuntimeTests = await removeRuntimeDependentTests(fixtureRoot); for (const runtimePath of runtimePaths) { await rm(path.join(fixtureRoot, runtimePath), { recursive: true, force: true, }); } const outputPortsIndexPath = path.join( fixtureRoot, "src/application/ports/out/index.ts", ); const outputPortsIndex = await readFile(outputPortsIndexPath, "utf8"); await writeFile( outputPortsIndexPath, outputPortsIndex.replace( 'export type { WebPushControlPort } from "./web-push-control.ts";\n', "", ), ); const catalogPath = path.join( fixtureRoot, "config/recipes/frontend-capability-recipes.json", ); const catalog = JSON.parse(await readFile(catalogPath, "utf8")) as { recipes: Array>; }; const realtimeRecipe = catalog.recipes.find( (recipe) => recipe.id === "realtime", ); if (!realtimeRecipe || !Object.hasOwn(realtimeRecipe, "referenceRuntime")) { throw new Error("Expected realtime reference runtime catalog entry"); } delete realtimeRecipe.referenceRuntime; await writeFile(catalogPath, `${JSON.stringify(catalog, null, 2)}\n`); const packagePath = path.join(fixtureRoot, "package.json"); const packageDocument = JSON.parse(await readFile(packagePath, "utf8")) as { scripts: Record; }; for (const script of runtimeScripts) { delete packageDocument.scripts[script]; } await writeFile( packagePath, `${JSON.stringify(packageDocument, null, 2)}\n`, ); for (const scriptPath of [ "scripts/check-realtime-boundaries.ts", "scripts/check-realtime-boundary-fixtures.ts", "scripts/lib/realtime-boundaries.ts", "scripts/test-realtime-runtime-removal.ts", ]) { await rm(path.join(fixtureRoot, scriptPath), { force: true }); } const gatesPath = path.join(fixtureRoot, "config/ci/gates.json"); const gatesDocument = JSON.parse(await readFile(gatesPath, "utf8")) as { gates: Record< string, { steps: Array<{ script: string }>; evidence: string[]; } >; }; for (const gate of Object.values(gatesDocument.gates)) { gate.steps = gate.steps.filter( ({ script }) => !runtimeScripts.some((runtimeScript) => runtimeScript === script), ); gate.evidence = gate.evidence.filter( (evidence) => !evidence.includes("realtime-boundaries") && !evidence.includes("realtime-runtime-removal"), ); } await writeFile( gatesPath, `${JSON.stringify(gatesDocument, null, 2)}\n`, ); await assertNoRuntimeImports(fixtureRoot); const checks: Array = [ ["typecheck", runPnpm("check:types")], ["lint", runPnpm("lint")], ["architecture", runPnpm("check:architecture")], ["test", runPnpm("test:all")], ["build", runPnpm("build")], ["optional-catalog", runPnpm("check:optional-recipes:source")], ["ci-contract", runPnpm("check:ci")], ]; const passed = checks.every(([, result]) => result); await mkdir("artifacts/tests", { recursive: true }); await writeFile( "artifacts/tests/realtime-runtime-removal.xml", `\n` + `` + checks .map( ([name, result]) => `${result ? "" : ""}`, ) .join("") + `\n`, ); await rm(fixtureRoot, { recursive: true, force: true }); if (!passed) { process.stderr.write( `Realtime runtime removal failed: ${checks .filter(([, result]) => !result) .map(([name]) => name) .join(", ")}\n`, ); process.exit(1); } process.stdout.write( `Realtime runtime removal: PASS (${checks.length} base checks, ${removedRuntimeTests} runtime-dependent tests removed by import graph)\n`, );