ci: configure Codecov coverage uploads (#150)

scripts/normalize-lcov-paths.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+function toPosix(filePath) {
+  return filePath.replace(/\\/g, '/');
+}
+
+export function normalizeLcovContent(content, packagePath) {
+  const normalizedPackagePath = toPosix(packagePath).replace(/\/$/, '');
+
+  return content.replace(/^SF:(.+)$/gm, (line, sourcePath) => {
+    const normalizedSourcePath = toPosix(sourcePath);
+
+    if (
+      path.isAbsolute(sourcePath) ||
+      normalizedSourcePath.startsWith(`${normalizedPackagePath}/`) ||
+      normalizedSourcePath.startsWith('../')
+    ) {
+      return line;
+    }
+
+    return `SF:${normalizedPackagePath}/${normalizedSourcePath}`;
+  });
+}
+
+export async function normalizeLcovFile(rootDir, reportPath) {
+  const absoluteReportPath = path.resolve(rootDir, reportPath);
+  const packagePath = toPosix(path.relative(rootDir, path.dirname(path.dirname(absoluteReportPath))));
+  const content = await readFile(absoluteReportPath, 'utf8');
+  const normalizedContent = normalizeLcovContent(content, packagePath);
+
+  if (normalizedContent !== content) {
+    await writeFile(absoluteReportPath, normalizedContent);
+  }
+}
+
+async function main() {
+  const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  const rootDir = path.resolve(scriptDir, '..');
+  const reportPaths = process.argv.slice(2);
+
+  if (reportPaths.length === 0) {
+    throw new Error('Usage: normalize-lcov-paths.mjs <coverage/lcov.info> [...]');
+  }
+
+  for (const reportPath of reportPaths) {
+    await normalizeLcovFile(rootDir, reportPath);
+  }
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+  });
+}

scripts/normalize-lcov-paths.test.mjs

@@ -0,0 +1,31 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+
+import { normalizeLcovContent } from './normalize-lcov-paths.mjs';
+
+describe('normalizeLcovContent', () => {
+  it('prefixes relative LCOV source paths with the package path', () => {
+    const input = ['TN:', 'SF:src/index.ts', 'SF:src\\windows.ts', 'DA:1,1', 'end_of_record'].join('\n');
+
+    assert.equal(
+      normalizeLcovContent(input, 'packages/context'),
+      [
+        'TN:',
+        'SF:packages/context/src/index.ts',
+        'SF:packages/context/src/windows.ts',
+        'DA:1,1',
+        'end_of_record',
+      ].join('\n'),
+    );
+  });
+
+  it('leaves already-normalized and absolute paths unchanged', () => {
+    const input = [
+      'SF:packages/cli/src/index.ts',
+      'SF:/tmp/repo/packages/cli/src/index.ts',
+      'SF:../shared/source.ts',
+    ].join('\n');
+
+    assert.equal(normalizeLcovContent(input, 'packages/cli'), input);
+  });
+});