Expose internal events for custom reporters via config

lib/cli.js

@@ -471,10 +471,24 @@ export default async function loadCli() { // eslint-disable-line complexity
 		});
 	}
 
-	api.on('run', plan => {
+	api.on('run', async plan => {
+		if (combined.onInternalEvent) {
+			await combined.onInternalEvent({
+				type: 'run',
+				plan,
+			});
+		}
+
 		reporter.startRun(plan);
 
-		plan.status.on('stateChange', evt => {
+		plan.status.on('stateChange', async evt => {
+			if (combined.onInternalEvent) {
+				await combined.onInternalEvent({
+					type: 'stateChange',
+					stateChange: evt,
+				});
+			}
+
 			if (evt.type === 'end' || evt.type === 'interrupt') {
 				// Write out code coverage data when the run ends, lest a process
 				// interrupt causes it to be lost.

test/internal-events/fixtures/.gitignore

@@ -0,0 +1 @@
+internal-events.json

test/internal-events/fixtures/ava.config.js

@@ -0,0 +1,16 @@
+import fs from 'node:fs/promises';
+
+const internalEvents = [];
+
+export default {
+	files: [
+		'test.js',
+	],
+	async onInternalEvent(event) {
+		internalEvents.push(event);
+
+		if (event.type === 'stateChange' && event.stateChange.type === 'end') {
+			await fs.writeFile('internal-events.json', JSON.stringify(internalEvents));
+		}
+	},
+};

test/internal-events/fixtures/package.json

@@ -0,0 +1,3 @@
+{
+	"type": "module"
+}

test/internal-events/fixtures/test.js

@@ -0,0 +1,5 @@
+import test from 'ava';
+
+test('placeholder', t => {
+	t.pass();
+});

test/internal-events/test.js

@@ -0,0 +1,38 @@
+import fs from 'node:fs/promises';
+import {fileURLToPath} from 'node:url';
+
+import test from '@ava/test';
+
+import {fixture} from '../helpers/exec.js';
+
+test('internal events are emitted', async t => {
+	await fixture();
+
+	const result = JSON.parse(await fs.readFile(fileURLToPath(new URL('fixtures/internal-events.json', import.meta.url))));
+
+	t.like(result[0], {
+		type: 'run',
+		plan: {
+			files: [
+				fileURLToPath(new URL('fixtures/test.js', import.meta.url)),
+			],
+		},
+	});
+
+	const testPassedEvent = result.find(event => event.type === 'stateChange' && event.stateChange.type === 'test-passed');
+	t.like(testPassedEvent, {
+		type: 'stateChange',
+		stateChange: {
+			type: 'test-passed',
+			title: 'placeholder',
+			testFile: fileURLToPath(new URL('fixtures/test.js', import.meta.url)),
+		},
+	});
+
+	t.like(result[result.length - 1], {
+		type: 'stateChange',
+		stateChange: {
+			type: 'end',
+		},
+	});
+});