feat(nx-plugin): add generic configuration for plugins

Author: AS

code-pushup.preset.ts

@@ -2,6 +2,7 @@
 import type {
   CategoryConfig,
   CoreConfig,
+  ToolCommandConfig,
 } from './packages/models/src/index.js';
 import coveragePlugin, {
   getNxCoveragePaths,
@@ -195,7 +196,7 @@ export const coverageCoreConfigNx = async (
             projectName ? `run --project ${projectName}` : 'run-many',
             ...targetArgs,
           ],
-        },
+        } satisfies ToolCommandConfig,
         reports: await getNxCoveragePaths(targetNames),
       }),
     ],

packages/models/src/index.ts

@@ -132,3 +132,4 @@ export {
   type Tree,
 } from './lib/tree.js';
 export { uploadConfigSchema, type UploadConfig } from './lib/upload-config.js';
+export { toolCommandSchema, type ToolCommandConfig } from './lib/configuration';

packages/models/src/lib/configuration.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+
+/**
+ * Generic schema for a tool command configuration, reusable across plugins.
+ */
+export const toolCommandSchema = z.object({
+  command: z.string({ description: 'Command to run the tool.' }).min(1),
+  args: z
+    .array(z.string(), {
+      description: 'Arguments to be passed to the tool.',
+    })
+    .optional(),
+});
+
+export type ToolCommandConfig = z.infer<typeof toolCommandSchema>;

packages/models/src/lib/configuration.unit.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+import { toolCommandSchema } from './configuration.js';
+
+describe('toolCommandSchema', () => {
+  it('should validate a command with required fields', () => {
+    const data = { command: 'npx' };
+    const result = toolCommandSchema.safeParse(data);
+    expect(result.success).toBe(true);
+    if (result.success) {
+      expect(result.data.command).toBe('npx');
+      expect(result.data.args).toBeUndefined();
+    }
+  });
+
+  it('should validate a command with args', () => {
+    const data = { command: 'npx', args: ['eslint', 'src/'] };
+    const result = toolCommandSchema.safeParse(data);
+    expect(result.success).toBe(true);
+    if (result.success) {
+      expect(result.data.command).toBe('npx');
+      expect(result.data.args).toEqual(['eslint', 'src/']);
+    }
+  });
+
+  it('should fail if command is missing', () => {
+    const data = { args: ['eslint', 'src/'] };
+    const result = toolCommandSchema.safeParse(data);
+    expect(result.success).toBe(false);
+  });
+
+  it('should fail if command is empty', () => {
+    const data = { command: '' };
+    const result = toolCommandSchema.safeParse(data);
+    expect(result.success).toBe(false);
+  });
+
+  it('should fail if args is not an array of strings', () => {
+    const data = { command: 'npx', args: [123, true] };
+    const result = toolCommandSchema.safeParse(data);
+    expect(result.success).toBe(false);
+  });
+});

packages/plugin-coverage/src/lib/config.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { toolCommandSchema } from '@code-pushup/models';
 
 export const coverageTypeSchema = z.enum(['function', 'branch', 'line']);
 export type CoverageType = z.infer<typeof coverageTypeSchema>;
@@ -26,18 +27,7 @@ export const coverageResultSchema = z.union([
 export type CoverageResult = z.infer<typeof coverageResultSchema>;
 
 export const coveragePluginConfigSchema = z.object({
-  coverageToolCommand: z
-    .object({
-      command: z
-        .string({ description: 'Command to run coverage tool.' })
-        .min(1),
-      args: z
-        .array(z.string(), {
-          description: 'Arguments to be passed to the coverage tool.',
-        })
-        .optional(),
-    })
-    .optional(),
+  coverageToolCommand: toolCommandSchema.optional(),
   continueOnCommandFail: z
     .boolean({
       description: