Merge branch 'main' into add-plugin-targets

# Conflicts:
#	nx.json

Author: BioPhoton

nx.json

@@ -49,12 +49,9 @@
       }
     ],
     "sharedGlobals": [
-      {
-        "runtime": "npm --version"
-      },
-      {
-        "runtime": "node --version"
-      }
+      { "runtime": "node -e \"console.log(require('os').platform())\"" },
+      { "runtime": "node -v" },
+      { "runtime": "npm -v" }
     ]
   },
   "targetDefaults": {
@@ -289,6 +286,33 @@
       }
     }
   },
+  "namedInputs": {
+    "default": [
+      "{projectRoot}/**/*",
+      "sharedGlobals",
+      "!{projectRoot}/dist/**/*"
+    ],
+    "production": [
+      "default",
+      "!{projectRoot}/eslint.config.?(c)js",
+      "!{projectRoot}/**/?(*.)test.[jt]s?(x)?(.snap)",
+      "!{projectRoot}/tsconfig.test.json",
+      "!{projectRoot}/src/test-setup.[jt]s",
+      "!{projectRoot}/test-setup.[jt]s",
+      "!{projectRoot}/**/?(*.)mock.[jt]s?(x)",
+      "!{projectRoot}/vitest.@(unit|int|e2e).config.[jt]s",
+      "!{projectRoot}/@(test|mocks)/**/*",
+      "!{projectRoot}/perf/**/*",
+      "!{projectRoot}/tools/**/*",
+      "!{projectRoot}/code-pushup.config.?(m)[jt]s",
+      "!{projectRoot}/zod2md.config.ts"
+    ],
+    "sharedGlobals": [
+      { "runtime": "node -e \"console.log(require('os').platform())\"" },
+      { "runtime": "node -v" },
+      { "runtime": "npm -v" }
+    ]
+  },
   "workspaceLayout": {
     "appsDir": "examples",
     "libsDir": "packages"

packages/ci/src/index.ts

@@ -1,8 +1,15 @@
 export type { SourceFileIssue } from './lib/issues.js';
 export type * from './lib/models.js';
 export {
-  MONOREPO_TOOLS,
   isMonorepoTool,
+  MONOREPO_TOOLS,
   type MonorepoTool,
 } from './lib/monorepo/index.js';
 export { runInCI } from './lib/run.js';
+export { configPatternsSchema } from './lib/schemas.js';
+export {
+  DEFAULT_SETTINGS,
+  MAX_SEARCH_COMMITS,
+  MIN_SEARCH_COMMITS,
+  parseConfigPatternsFromString,
+} from './lib/settings.js';

packages/ci/src/lib/constants.ts

@@ -3,8 +3,8 @@ import path from 'node:path';
 import type { PackageJson } from 'type-fest';
 import { MEMFS_VOLUME } from '@code-pushup/test-utils';
 import * as utils from '@code-pushup/utils';
-import { DEFAULT_SETTINGS } from '../constants.js';
 import type { Settings } from '../models.js';
+import { DEFAULT_SETTINGS } from '../settings.js';
 import {
   type MonorepoProjects,
   listMonorepoProjects,

packages/ci/src/lib/monorepo/list-projects.unit.test.ts

@@ -28,11 +28,6 @@ import {
   runCompare,
   runPrintConfig,
 } from './cli/index.js';
-import {
-  DEFAULT_SETTINGS,
-  MAX_SEARCH_COMMITS,
-  MIN_SEARCH_COMMITS,
-} from './constants.js';
 import { listChangedFiles, normalizeGitRef } from './git.js';
 import { type SourceFileIssue, filterRelevantIssues } from './issues.js';
 import type {
@@ -49,6 +44,11 @@ import type {
 import type { ProjectConfig } from './monorepo/index.js';
 import { saveOutputFiles } from './output-files.js';
 import { downloadFromPortal } from './portal/download.js';
+import {
+  DEFAULT_SETTINGS,
+  MAX_SEARCH_COMMITS,
+  MIN_SEARCH_COMMITS,
+} from './settings.js';
 
 export type RunEnv = {
   refs: NormalizedGitRefs;

packages/ci/src/lib/run-utils.ts

@@ -0,0 +1,41 @@
+import { ZodError, z } from 'zod';
+import {
+  DEFAULT_PERSIST_CONFIG,
+  persistConfigSchema,
+  slugSchema,
+  uploadConfigSchema,
+} from '@code-pushup/models';
+import { interpolate } from '@code-pushup/utils';
+
+// eslint-disable-next-line unicorn/prefer-top-level-await, unicorn/catch-error-name
+export const interpolatedSlugSchema = slugSchema.catch(ctx => {
+  // allow {projectName} interpolation (invalid slug)
+  if (
+    typeof ctx.value === 'string' &&
+    ctx.issues.length === 1 &&
+    ctx.issues[0]?.code === 'invalid_format'
+  ) {
+    // if only regex failed, try if it would pass once we insert known variables
+    const { success } = slugSchema.safeParse(
+      interpolate(ctx.value, { projectName: 'example' }),
+    );
+    if (success) {
+      return ctx.value;
+    }
+  }
+  throw new ZodError(ctx.error.issues);
+});
+
+export const configPatternsSchema = z.object({
+  persist: persistConfigSchema.transform(persist => ({
+    ...DEFAULT_PERSIST_CONFIG,
+    ...persist,
+  })),
+  upload: uploadConfigSchema
+    .omit({ organization: true, project: true })
+    .extend({
+      organization: interpolatedSlugSchema,
+      project: interpolatedSlugSchema,
+    })
+    .optional(),
+});

packages/ci/src/lib/schemas.ts

@@ -0,0 +1,108 @@
+import { describe, expect, it } from 'vitest';
+import { ZodError } from 'zod';
+import type { ConfigPatterns } from './models.js';
+import { configPatternsSchema, interpolatedSlugSchema } from './schemas.js';
+
+describe('interpolatedSlugSchema', () => {
+  it('should accept a valid slug', () => {
+    expect(interpolatedSlugSchema.parse('valid-slug')).toBe('valid-slug');
+  });
+
+  it('should accept a slug with {projectName} interpolation', () => {
+    expect(interpolatedSlugSchema.parse('{projectName}-slug')).toBe(
+      '{projectName}-slug',
+    );
+  });
+
+  it('should reject an invalid slug that cannot be fixed by interpolation', () => {
+    expect(() => interpolatedSlugSchema.parse('Invalid Slug!')).toThrow(
+      ZodError,
+    );
+  });
+
+  it('should reject a non-string value', () => {
+    expect(() => interpolatedSlugSchema.parse(123)).toThrow(ZodError);
+  });
+});
+
+describe('configPatternsSchema', () => {
+  it('should accept valid persist and upload configs', () => {
+    const configPatterns: Required<ConfigPatterns> = {
+      persist: {
+        outputDir: '.code-pushup/{projectName}',
+        filename: 'report',
+        format: ['json', 'md'],
+        skipReports: false,
+      },
+      upload: {
+        server: 'https://api.code-pushup.example.com/graphql',
+        apiKey: 'cp_...',
+        organization: 'example',
+        project: '{projectName}',
+      },
+    };
+    expect(configPatternsSchema.parse(configPatterns)).toEqual(configPatterns);
+  });
+
+  it('should accept persist config without upload', () => {
+    const configPatterns: ConfigPatterns = {
+      persist: {
+        outputDir: '.code-pushup/{projectName}',
+        filename: 'report',
+        format: ['json', 'md'],
+        skipReports: false,
+      },
+    };
+    expect(configPatternsSchema.parse(configPatterns)).toEqual(configPatterns);
+  });
+
+  it('fills in default persist values if missing', () => {
+    expect(
+      configPatternsSchema.parse({
+        persist: {
+          filename: '{projectName}-report',
+        },
+      }),
+    ).toEqual<ConfigPatterns>({
+      persist: {
+        outputDir: '.code-pushup',
+        filename: '{projectName}-report',
+        format: ['json', 'md'],
+        skipReports: false,
+      },
+    });
+  });
+
+  it('should reject if persist is missing', () => {
+    expect(() => configPatternsSchema.parse({})).toThrow(ZodError);
+  });
+
+  it('should reject if persist has invalid values', () => {
+    expect(() =>
+      configPatternsSchema.parse({
+        persist: {
+          format: 'json', // should be array
+        },
+      }),
+    ).toThrow(ZodError);
+  });
+
+  it('should reject if upload is missing required fields', () => {
+    expect(() =>
+      configPatternsSchema.parse({
+        persist: {
+          outputDir: '.code-pushup/{projectName}',
+          filename: 'report',
+          format: ['json', 'md'],
+          skipReports: false,
+        },
+        upload: {
+          server: 'https://api.code-pushup.example.com/graphql',
+          organization: 'example',
+          project: '{projectName}',
+          // missing apiKey
+        },
+      }),
+    ).toThrow(ZodError);
+  });
+});

packages/ci/src/lib/schemas.unit.test.ts

@@ -0,0 +1,49 @@
+import { ZodError, z } from 'zod';
+import type { ConfigPatterns, Settings } from './models.js';
+import { configPatternsSchema } from './schemas.js';
+
+export const DEFAULT_SETTINGS: Settings = {
+  monorepo: false,
+  parallel: false,
+  projects: null,
+  task: 'code-pushup',
+  bin: 'npx --no-install code-pushup',
+  config: null,
+  directory: process.cwd(),
+  silent: false,
+  debug: false,
+  detectNewIssues: true,
+  logger: console,
+  nxProjectsFilter: '--with-target={task}',
+  skipComment: false,
+  configPatterns: null,
+  searchCommits: false,
+};
+
+export const MIN_SEARCH_COMMITS = 1;
+export const MAX_SEARCH_COMMITS = 100;
+
+export function parseConfigPatternsFromString(
+  value: string,
+): ConfigPatterns | null {
+  if (!value) {
+    return null;
+  }
+
+  try {
+    const json = JSON.parse(value);
+    return configPatternsSchema.parse(json);
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new TypeError(
+        `Invalid JSON value for configPatterns input - ${error.message}`,
+      );
+    }
+    if (error instanceof ZodError) {
+      throw new TypeError(
+        `Invalid shape of configPatterns input:\n${z.prettifyError(error)}`,
+      );
+    }
+    throw error;
+  }
+}