fix(test): make jest run under ESM + sync config with tsconfig

pnpm test failed before any test loaded: package.json is "type":"module", so
Node loaded jest.config.js as ESM and its require('next/jest') threw. Fixes:

- Rename jest.config.js -> jest.config.cjs (CommonJS, as the config file is
  loaded by Node un-transformed).
- jest.setup.js: drop `process.noDeprecation = true`. The test script already
  passes NODE_OPTIONS=--no-deprecation, and that property is read-only once the
  flag is set (Node 24), so the assignment threw and failed every suite.
- moduleNameMapper: point @uuid at src/utilities/uuidTags.ts (was lib/
  capabilities.ts, which doesn't export the helpers) and add the many other
  tsconfig path aliases that were missing (@utilities, @hooks, @components, …).
- Exclude src/__tests__/utils/ (shared helpers, no test cases) from testMatch.

pnpm test now executes the full suite: 154 passing of 181. The remaining 27
failures are pre-existing test-level drift, not runner issues — incomplete mocks
(stripe payload.findByID; revalidate imports the real payload.config /
email-nodemailer ESM instead of mocking getPayload) and assertion drift in the
capabilities/storage/images unit tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: ceccec

jest.config.js jest.config.cjsjest.config.js renamed to jest.config.cjs

@@ -55,11 +55,29 @@ const customJestConfig = {
     },
   },
 
+  // Keep in sync with `compilerOptions.paths` in tsconfig.json so jest resolves the same aliases.
   moduleNameMapper: {
     '^@/(.*)$': '<rootDir>/src/$1',
+    '^@blocks/(.*)$': '<rootDir>/src/components/blocks/$1',
+    '^@cloud/(.*)$': '<rootDir>/src/app/(frontend)/(cloud)/cloud/$1',
+    '^@components/(.*)$': '<rootDir>/src/components/$1',
+    '^@data$': '<rootDir>/src/app/_data',
+    '^@data/(.*)$': '<rootDir>/src/app/_data/$1',
+    '^@docs/(.*)$': '<rootDir>/src/docs/$1',
+    '^@forms/(.*)$': '<rootDir>/src/forms/$1',
+    '^@graphics/(.*)$': '<rootDir>/src/graphics/$1',
+    '^@hooks/(.*)$': '<rootDir>/src/hooks/$1',
+    '^@icons/(.*)$': '<rootDir>/src/icons/$1',
+    '^@payload-config$': '<rootDir>/src/payload.config.ts',
+    '^@providers$': '<rootDir>/src/providers',
+    '^@providers/(.*)$': '<rootDir>/src/providers/$1',
     '^@root/(.*)$': '<rootDir>/src/$1',
-    '^@uuid$': '<rootDir>/src/lib/capabilities.ts',
-    '^@uuid/(.*)$': '<rootDir>/src/lib/$1',
+    '^@scss/(.*)$': '<rootDir>/src/css/$1',
+    '^@types$': '<rootDir>/src/payload-types.ts',
+    '^@utilities$': '<rootDir>/src/utilities',
+    '^@utilities/(.*)$': '<rootDir>/src/utilities/$1',
+    // `@uuid` → uuidTags.ts (matches tsconfig; was wrongly pointed at lib/capabilities.ts).
+    '^@uuid$': '<rootDir>/src/utilities/uuidTags.ts',
   },
 
   transform: {
@@ -73,7 +91,9 @@ const customJestConfig = {
     '^.+\\.module\\.(css|sass|scss)$',
   ],
 
-  testPathIgnorePatterns: ['<rootDir>/.next/', '<rootDir>/node_modules/'],
+  // `__tests__/utils/` holds shared helpers (no test cases) — the broad testMatch above would
+  // otherwise run them as empty suites ("must contain at least one test").
+  testPathIgnorePatterns: ['<rootDir>/.next/', '<rootDir>/node_modules/', '<rootDir>/src/__tests__/utils/'],
 }
 
 // createJestConfig is exported this way to ensure that next/jest can load the Next.js config which is async

jest.setup.js

@@ -61,5 +61,6 @@ if (typeof global.fetch === 'undefined') {
   global.fetch = jest.fn()
 }
 
-// Suppress specific node deprecation warnings
-process.noDeprecation = true
+// Deprecation warnings are suppressed via NODE_OPTIONS=--no-deprecation in the `test` script.
+// Don't reassign process.noDeprecation here: once the flag is set it's a read-only property
+// (Node 24) and assigning throws "Cannot assign to read only property 'noDeprecation'".