goodgo-platform/eslint.config.mjs

/* eslint-disable import-x/no-named-as-default-member */
import js from '@eslint/js';
import tseslint from 'typescript-eslint';
import importPlugin from 'eslint-plugin-import-x';
import eslintConfigPrettier from 'eslint-config-prettier';
import reactHooksPlugin from 'eslint-plugin-react-hooks';
import nextPlugin from '@next/eslint-plugin-next';
import globals from 'globals';

export default tseslint.config(
  // Global ignores
  {
    ignores: [
      '**/node_modules/**',
      '**/dist/**',
      '**/.next/**',
      '**/coverage/**',
      '**/*.js',
      '**/*.cjs',
      '**/*.mjs',
      '!eslint.config.mjs',
      '**/next-env.d.ts',
      // Local stash directory used during the TEC-2773 industrial migration
      // — not part of the active source tree.
      'tmp/**',
      // Build artifacts and Playwright/test outputs
      '**/playwright-report*/**',
      '**/playwright-results/**',
      '**/.playwright-mcp/**',
    ],
  },

  // Base JS recommended rules
  js.configs.recommended,

  // TypeScript recommended rules
  ...tseslint.configs.recommended,

  // Import plugin
  importPlugin.flatConfigs.recommended,
  importPlugin.flatConfigs.typescript,

  // Prettier (disables conflicting rules)
  eslintConfigPrettier,

  // Shared settings for all TS files
  {
    files: ['**/*.ts', '**/*.tsx'],
    languageOptions: {
      globals: {
        ...globals.node,
      },
    },
    settings: {
      'import-x/resolver': {
        typescript: {
          project: ['apps/*/tsconfig.json', 'tsconfig.base.json'],
        },
      },
    },
    rules: {
      // TypeScript
      '@typescript-eslint/no-unused-vars': [
        'error',
        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
      ],
      '@typescript-eslint/no-explicit-any': 'warn',
      '@typescript-eslint/consistent-type-imports': [
        'error',
        { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
      ],

      // Import ordering
      'import-x/order': [
        'error',
        {
          groups: ['builtin', 'external', 'internal', 'parent', 'sibling', 'index'],
          'newlines-between': 'never',
          alphabetize: { order: 'asc', caseInsensitive: true },
        },
      ],
      'import-x/no-duplicates': ['error', { 'prefer-inline': true }],
      'import-x/no-unresolved': 'off', // TypeScript handles this

      // General
      'no-console': ['warn', { allow: ['warn', 'error'] }],
    },
  },

  // NestJS-specific rules for the API app
  {
    files: ['apps/api/**/*.ts', 'src/modules/**/*.ts'],
    rules: {
      // NestJS uses empty classes for modules, allow them
      '@typescript-eslint/no-extraneous-class': 'off',
      // NestJS decorators require this pattern
      '@typescript-eslint/no-unsafe-declaration-merging': 'off',
      // NestJS DI relies on emitDecoratorMetadata to read constructor-param
      // types at runtime. `import { type Foo }` strips the value-import that
      // the decorator metadata needs, breaking provider resolution. Disable
      // the auto-converting rule across the API to keep value imports.
      // (See user-memory note: feedback_nest_type_imports.md)
      '@typescript-eslint/consistent-type-imports': 'off',
    },
  },

  // Module encapsulation: prevent cross-module internal imports
  // (excludes test files — tests may import internals directly for unit testing)
  {
    files: ['apps/api/src/modules/**/*.ts'],
    ignores: ['**/*.spec.ts', '**/*.test.ts', '**/__tests__/**'],
    rules: {
      'no-restricted-imports': [
        'error',
        {
          patterns: [
            {
              group: [
                '@modules/*/application/*',
                // Domain events + value objects are stable cross-module contracts.
                // Importing them from internal paths avoids the circular-import
                // hazard that the module barrel creates when it transitively
                // re-exports `XxxModule` (which loads providers that, in turn,
                // import the cross-module event from the same barrel and read
                // it as `undefined` during decorator evaluation).
                // — keep `domain/repositories/*` + `domain/services/*` blocked.
                '@modules/*/domain/repositories/*',
                '@modules/*/domain/services/*',
                '@modules/*/infrastructure/*',
                '@modules/*/presentation/*',
              ],
              message:
                'Import from the module barrel (@modules/<module>) instead of internal paths. This preserves module encapsulation. Exception: domain events / value objects may be imported via internal paths to avoid circular-import hazards.',
            },
          ],
        },
      ],
    },
  },

  // React/Next.js overrides for web app
  {
    files: ['apps/web/**/*.ts', 'apps/web/**/*.tsx'],
    plugins: {
      'react-hooks': reactHooksPlugin,
      '@next/next': nextPlugin,
    },
    languageOptions: {
      globals: {
        ...globals.browser,
        React: 'readonly',
      },
    },
    rules: {
      'no-console': 'error',
      // React hooks correctness
      'react-hooks/rules-of-hooks': 'error',
      'react-hooks/exhaustive-deps': 'warn',
      // Next.js specific
      ...nextPlugin.configs.recommended.rules,
      ...nextPlugin.configs['core-web-vitals'].rules,
    },
  },

  // Test files
  {
    files: [
      '**/*.spec.ts',
      '**/*.spec.tsx',
      '**/*.test.ts',
      '**/*.test.tsx',
      '**/__tests__/**/*.ts',
      '**/__tests__/**/*.tsx',
      'e2e/**/*.ts',
    ],
    rules: {
      '@typescript-eslint/no-explicit-any': 'off',
      'no-console': 'off',
      // Tests sometimes use `import()` type annotations to reference lazy
      // or platform-only modules without actually importing them at runtime.
      '@typescript-eslint/consistent-type-imports': 'off',
      // Tests routinely interleave imports with `vi.mock(...)` factories that
      // must run BEFORE the imports they replace. The `import-x/order` rule
      // doesn't model that pattern well — give tests latitude.
      'import-x/order': 'off',
    },
  },

  // Script files (seeds, migrations, etc.)
  {
    files: ['prisma/**/*.ts'],
    rules: {
      'no-console': 'off',
      '@typescript-eslint/no-unused-vars': 'warn',
    },
  },
);